LISTBOX Lire tableau

4D v20.6


LISTBOX Lire tableau ( {* ;} objet ; typeTab ) -> 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)
typeTab	Entier long	Type de tableau
Résultat	Pointeur	Pointeur vers le tableau associé à la propriété

Description

Note : Cette commande fonctionne uniquement avec les list box de type tableau.

La commande LISTBOX Lire tableau retourne un pointeur vers le tableau typeTab de la list box ou de la colonne de list box désignée par les paramètres objet et *.

Des tableaux de style, de couleur, de couleur de fond ou de contrôle des lignes peuvent être associés aux list box de type tableau ou (hormis le tableau de contrôle des lignes) aux colonnes de list box tableau via la Liste des propriétés en mode Développement ou la commande LISTBOX FIXER TABLEAU.

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. Vous pouvez désigner comme paramètre objet une list box ou une colonne de list box.

Passez dans typeTab le type du tableau de propriété à obtenir. Vous pouvez utiliser une des constantes suivantes du thème "List box" :

Constante	Type	Valeur	Comment
lk tableau contrôle	Entier long	3
lk tableau couleur de fond	Entier long	1
lk tableau couleur de police	Entier long	0
lk tableau hauteurs lignes	Entier long	4	(Licence 4D View Pro requise)
lk tableau style	Entier long	2

La commande retourne une des valeurs suivantes :

Pointeur nil si aucun tableau de la propriété demandée n’est associé à la colonne ou à la list box
un pointeur vers le tableau de la propriété demandée, défini par l’utilisateur
un pointeur vers le tableau de la propriété demandée, défini dynamiquement lors de l’appel de la commande LISTBOX FIXER COULEUR LIGNE ou LISTBOX FIXER STYLE LIGNE.

Exemple

Exemples type d’utilisation :

 vPtr:=LISTBOX Lire tableau(*;"MyLB";lk tableau couleur de police)

     // retourne un pointeur vers le tableau de couleurs de police associé

     // à la list box "MyLB"

 

 vPtr:=LISTBOX Lire tableau(*;"Col4";lk tableau style)

     // retourne un pointeur vers le tableau de styles de police associé

     // à la colonne de list box "Col4"

Voir aussi

LISTBOX FIXER TABLEAU
LISTBOX LIRE TABLEAUX