LISTBOX Get array

4D v16.3

LISTBOX Get array


LISTBOX Get array ( {* ;} 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 Get array 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 SET ARRAY.

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 background color array	Entier long	1
lk control array	Entier long	3
lk font color array	Entier long	0
lk row height array	Entier long	4	(Licence 4D View Pro requise)
lk style array	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 SET ROW COLOR ou LISTBOX SET ROW FONT STYLE.

Exemple

Exemples type d’utilisation :

 vPtr:=LISTBOX Get array(*;"MyLB";lk font color array)

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

     // à la list box "MyLB"

 

 vPtr:=LISTBOX Get array(*;"Col4";lk style array)

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

     // à la colonne de list box "Col4"

Voir aussi

LISTBOX GET ARRAYS
LISTBOX SET ARRAY