4D Doc Center : LISTBOX Lire information

4D v12.4

LISTBOX Lire information


LISTBOX Lire information ( {* ;} objet ; info ) -> Résultat

Paramètre	Type	Description
*		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 * est spécifié) ou Variable (si * est omis)
info	Entier long	Type d’information à lire
Résultat	Entier long	Valeur courante

Description

La commande LISTBOX Lire information permet de récupérer différentes informations concernant la taille et la visibilité des en-têtes et des barres de défilement de l’objet list box désigné par les paramètres objet et *.

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. Pour plus d'informations sur les noms d’objets, reportez-vous à la section Propriétés des objets.

Passez dans le paramètre info un code correspondant à l’information que vous souhaitez obtenir. Vous pouvez passer une valeur ou l’une des constantes suivantes, placées dans le thème List box :

Constante	Type	Valeur	Commentaire
Affichage barre déf hor listbox	Entier long	2	0=masquée, 1=affichée
Affichage barre déf ver listbox	Entier long	4	0=masquée, 1=affichée
Affichage entête listbox	Entier long	0	0=masqué, 1=affiché
Hauteur barre déf hor listbox	Entier long	3	Hauteur en pixels
Hauteur entête listbox	Entier long	1	Hauteur en pixels
Largeur barre déf ver listbox	Entier long	5	Largeur en pixels
Position barre déf hor listbox	Entier long	6	Position du curseur en pixels
Position barre déf ver listbox	Entier long	7	Position du curseur en pixels

Les six premières constantes sont utiles pour calculer la taille de la zone de list box affichée dans le formulaire.
Lorsque vous utilisez la constante Position barre déf hor listbox ou la constante Position barre déf ver listbox, la commande retourne la position relative du curseur de défilement par rapport à son origine, c’est-à-dire la taille de la partie masquée de la fenêtre, exprimée en pixels. Par défaut, cette position correspond à 0. Combinée par exemple aux informations relatives à la hauteur des lignes, cette valeur permet de connaître le contenu affiché dans la list box.

Exemple

Soit une list box contenant des lignes d’une hauteur de 20 pixels chacune. Vous exécutez l’instruction suivante :

$déf:=LISTBOX Lire information(*;"Listbox";Position barre déf ver listbox)

Si, par exemple, $déf retourne 200, vous pouvez en déduire que la 11e ligne est actuellement la première affichée dans la list box (200/20=10, donc 10 lignes sont masquées).