version 2004.1 (Modifiée)
Lire information listbox ({*; }objet; info) Entier long
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 Lire information listbox 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 | Valeur(s) retournée(s) |
Affichage entête listbox | Entier long | 0 | 0=masqué, 1=affiché |
Hauteur entête listbox | Entier long | 1 | Hauteur en pixels |
Affichage barre déf hor listbox | Entier long | 2 | 0=masquée, 1=affichée |
Hauteur barre déf hor listbox | Entier long | 3 | Hauteur en pixels |
Affichage barre déf ver listbox | Entier long | 4 | 0=masquée, 1=affichée |
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:=Lire information listbox(*;"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).
Référence
CHOIX VISIBLE BARRES DEFILEMENT, MONTRER GRILLE LISTBOX.