LISTBOX LIRE INFORMATION IMPRESSION

4D v16.3


LISTBOX LIRE INFORMATION IMPRESSION ( {* ;} objet ; sélecteur ; info )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d’objet (chaîne) Si omis, objet est une variable
objet	Objet de formulaire	Nom d'objet (si * spécifié) ou Variable (si * omis)
sélecteur	Entier long	Information à obtenir
info	Entier long	Valeur courante

Description

La commande LISTBOX LIRE INFORMATION IMPRESSION retourne des informations courantes relatives à l’impression de l’objet list box désigné par les paramètres objet et *. Cette commande permet de contrôler l’impression du contenu de la list box.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d'objet (une chaîne). Si vous ne passez pas ce paramètre, vous indiquez que le paramètre objet est une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable.

Cette commande doit être appelée dans le contexte de l’impression d’une list box via la commande Imprimer objet. Hors de ce contexte, elle ne retourne pas de valeurs significatives.

Passez dans sélecteur une valeur indiquant l’information à connaître et dans info une variable de type numérique ou BLOB. Vous pouvez passer dans sélecteur une des constantes suivantes, placées dans le thème List box :

Constante	Type	Valeur	Comment
lk hauteur imprimée	Entier long	3	Retourne dans info la hauteur en pixels de l’objet effectivement imprimé (inclut les en-têtes, filets, etc.). Souvenez-vous que si le nombre de lignes à imprimer est inférieur à la "capacité" de la list box, sa hauteur est automatiquement réduite.
lk impression terminée	Entier long	2	Retourne dans info un booléen indiquant si la dernière ligne (visible) de la list box a été effectivement imprimée. Vrai = la ligne a été imprimée, Faux sinon.
lk nombre lignes imprimées	Entier long	1	Retourne dans info le nombre de lignes effectivement imprimées lors du dernier appel à la commande Imprimer objet. Ce nombre inclut les éventuelles lignes de ruptures ajoutées dans le cadre d’une list box hiérarchique. Par exemple, info vaut 10 si la list box contient 20 lignes et que les lignes impaires ont été masquées.
lk num dernière ligne impr	Entier long	0	Retourne dans info le numéro de la dernière ligne imprimée. Permet de connaître le numéro de la prochaine ligne à imprimer. Le numéro retourné peut être supérieur au nombre de lignes effectivement imprimées si la list box contient des lignes invisibles ou si la commande OBJET FIXER DEFILEMENT a été appelée. Par exemple, si les lignes 1, 18 et 20 ont été imprimées, info vaut 20.

Pour plus d’informations sur les principes d’impression des list box, reportez-vous au paragraphe Gestion des impressions.

Exemple 1

Impression jusqu’à ce que toutes les lignes soient imprimées :

 OUVRIR TACHE IMPRESSION

 FORM CHARGER("SalesForm")

 

 $Over:=Faux

 Repeter

    $Total:=Imprimer objet(*;"malistbox")

    LISTBOX LIRE INFORMATION IMPRESSION(*;"malistbox";lk impression terminée;$Over)

    SAUT DE PAGE

 Jusque($Over)

 

 FERMER TACHE IMPRESSION

Exemple 2

Impression d’au moins 500 lignes de la list box, sachant que certaines lignes sont masquées :

 $GlobalPrinted:=0

 Repeter

    $Total:=Imprimer objet(*;"malistbox")

    LISTBOX LIRE INFORMATION IMPRESSION(*;"malistbox";lk nombre lignes imprimées;$Printed)

    $GlobalPrinted:=$GlobalPrinted+$Printed

    SAUT DE PAGE

 Jusque($GlobalPrinted>=500)