version 11.2 (Modifiée)
LIRE TABLEAUX LISTBOX ({*; }objet; tabNomsCols; tabNomsEntêtes; tabVarCols; tabVarEntêtes; tabColsVisibles; tabStyles)
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) | |||
tabNomsCols | Tab alpha | Noms d'objet des colonnes | |
tabNomsEntêtes | Tab alpha | Noms d'objet des en-têtes | |
tabVarCols | Tab pointeur | Pointeurs vers les variables des colonnes ou | |
Pointeurs vers les champs des colonnes ou Nil | |||
tabVarEntêtes | Tab pointeur | Pointeurs vers les variables des en-têtes | |
tabColsVisibles | Tab booléen | Visibilité de chaque colonne | |
tabStyles | Tab pointeur | Pointeurs vers les tableaux ou les variables de styles | |
de couleurs et de visibilité des lignes ou Nil |
Description
La commande LIRE TABLEAUX LISTBOX retourne un ensemble de tableaux synchronisés fournissant diverses informations sur chaque colonne (visible ou non) de la list box désignée 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.
A l'issue de l'exécution de la commande :
Le tableau tabNomsCols contient la liste des noms d'objet de chaque colonne de la list box.
Le tableau tabNomsEntêtes contient la liste des noms d'objet de chaque en-tête de colonne de la list box.
Le tableau tabVarCols contient, pour une list box de type tableau, des pointeurs vers les variables (c'est-à-dire les tableaux) associées à chaque colonne de la list box. Pour une list box de type sélection, tabVarCols contient :
- pour une colonne associée à un champ, un pointeur vers le champ associé,
- pour une colonne associée à une variable, un pointeur vers la variable,
- pour une colonne associée à une expression, un pointeur Nil.
Le tableau tabVarEntêtes contient des pointeurs vers les variables associées à chaque en-tête de colonne de la list box.
Le tableau tabColsVisibles contient une valeur booléenne pour chaque colonne, indiquant si la colonne est visible (valeur Vrai) ou masquée (valeur Faux) dans la list box.
Le tableau tabStyles contient, pour une list box de type tableau, quatre pointeurs vers les quatre tableaux permettant d'appliquer individuellement un style, une couleur de police, une couleur de fond et un statut masqué personnalisés à chaque ligne de la list box. Ces tableaux sont associés à la list box dans la Liste des propriétés en mode Développement. Si un tableau n'est pas spécifié pour la list box, l'élément correspondant de tabStyles contient un pointeur Nil.
Pour une list box de type sélection, tabStyles contient :
- pour chaque paramétrage défini via une variable, un pointeur vers la variable,
- pour chaque paramétrage défini via une expression, un pointeur Nil.
Référence