LISTBOX Lire information

4D v16.3


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

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 * 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, des pieds 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 Objets de formulaires.

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	Comment
lk affichage barre déf hor	Entier long	2	0=masquée, 1=affichée
lk affichage barre déf ver	Entier long	4	0=masquée, 1=affichée
lk affichage entête	Entier long	0	Propriété Afficher en-têtes S'applique à : List box Valeurs possibles : lk non (0) : masqué lk oui (1) : affiché
lk affichage pied	Entier long	8	Propriété Afficher pieds S'applique à : List box Valeurs possibles : lk non (0) : masqué lk oui (1) : affiché
lk hauteur barre déf hor	Entier long	3	Hauteur en pixels
lk hauteur entête	Entier long	1	Hauteur en pixels
lk hauteur pied	Entier long	9	Hauteur en pixels
lk largeur barre déf ver	Entier long	5	Largeur en pixels
lk position barre déf hor	Entier long	6	Position du curseur en pixels
lk position barre déf ver	Entier long	7	Position du curseur en pixels

Les 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 lk position barre déf hor ou la constante lk position barre déf ver, 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.
L'instruction LISTBOX Lire information(vLB;lk hauteur pied) retourne la même valeur que la commande LISTBOX Lire hauteur pieds lorsque les pieds sont affichés. Dans le cas contraire, LISTBOX Lire information retourne 0 alors que LISTBOX Lire hauteur pieds retourne toujours la hauteur, dans ce cas théorique, des pieds.

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";lk position barre déf ver)

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).

Voir aussi

LISTBOX FIXER GRILLE
OBJET FIXER BARRES DEFILEMENT