4D Doc Center : LISTBOX Lire tableau

4D v14.3

LISTBOX Lire tableau


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 associé au style ou à la couleur 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 ou de couleur de fond peuvent être associés aux list box de type 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
Listbox tableau couleur de fond	Entier long	1
Listbox tableau couleur de police	Entier long	0
Listbox tableau style	Entier long	2

La commande retourne une des valeurs suivantes :

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";Listbox tableau couleur de police)

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

     // à la list box "MyLB"

 

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

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

     // à la colonne de list box "Col4"