4D Doc Center : LISTBOX Lire couleur ligne

4D v14.3

LISTBOX Lire couleur ligne


LISTBOX Lire couleur ligne ( {* ;} objet ; ligne {; typeCouleur} ) -> 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)
ligne	Entier long	Numéro de ligne
typeCouleur	Entier long	Listbox couleur de police (défaut) ou Listbox couleur de fond
Résultat	Entier long	Valeur de couleur

Description

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

La commande LISTBOX Lire couleur ligne retourne la couleur d’une ligne ou d’une cellule 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. Vous pouvez désigner comme paramètre objet une list box ou une colonne de list box :

si objet désigne une list box, la commande retourne la couleur de la ligne
si objet désigne une colonne, la commande retourne la couleur de la cellule

Passez dans ligne le numéro de la ligne dont vous souhaitez obtenir la couleur.

Note : La commande ne tient pas compte de l’éventuel statut masqué/affiché des lignes de la list box.

Passez la constante Listbox couleur de fond ou Listbox couleur de police (thème "List box") dans le paramètre typeCouleur selon que vous souhaitez connaître la couleur de fond ou la couleur de police de la ligne. Si vous omettez ce paramètre, la couleur de police est retournée.

Attention, une couleur affectée à une ligne n’est pas forcément affichée dans toutes les cellules de ligne (cf. exemple). Si des valeurs de couleur contradictoires sont définies via les propriétés de la list box ou de la colonne, un ordre de priorité est appliqué. Pour plus d’informations, reportez-vous au manuel Mode Développement.

Exemple

Soit la list box suivante :

 vCoul:=LISTBOX Lire couleur ligne(*;"Col5";3)

 vCoul2:=LISTBOX Lire couleur ligne(*;"List Box";3)

 vCoul3:=LISTBOX Lire couleur ligne(*;"List Box";Listbox couleur de fond)

     // vCoul contient 0xFFFF00 (jaune)

     // vCoul2 contient 0x00FF (bleu)

     // vCoul3 contient 0x00FF0000 (rouge)