4D Doc Center : LISTBOX LIRE TABLEAUX

4D v14.3

LISTBOX LIRE TABLEAUX


LISTBOX LIRE TABLEAUX ( {* ;} objet ; tabNomsCols ; tabNomsEntêtes ; tabVarCols ; tabVarEntêtes ; tabColsVisibles ; tabStyles {; tabNomsPieds ; tabVarPieds} )

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)
tabNomsCols	Tableau chaîne	Noms d’objet des colonnes
tabNomsEntêtes	Tableau chaîne	Noms d’objet des en-têtes
tabVarCols	Tableau pointeur	Pointeurs vers les variables des colonnes ou Pointeurs vers les champs des colonnes ou Nil
tabVarEntêtes	Tableau pointeur	Pointeurs vers les variables des en-têtes
tabColsVisibles	Tableau booléen	Visibilité de chaque colonne
tabStyles	Tableau pointeur	Pointeurs vers les tableaux ou les variables de styles de couleurs et de visibilité des lignes ou Nil
tabNomsPieds	Tableau chaîne	Noms d’objet des pieds de colonnes
tabVarPieds	Tableau pointeur	Pointeurs vers les variables des pieds de colonnes

Description

La commande LISTBOX LIRE TABLEAUX 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 Objets de formulaires.

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.