4D Doc Center : LISTBOX FIXER COULEUR LIGNE

4D v14.3

LISTBOX FIXER COULEUR LIGNE


LISTBOX FIXER COULEUR LIGNE ( {* ;} objet ; ligne ; couleur {; typeCouleur} )

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
couleur	Entier long	Valeur de couleur RVB
typeCouleur	Entier long	Listbox couleur de police (défaut) ou Listbox couleur de fond

Description

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

La commande LISTBOX FIXER COULEUR LIGNE vous permet de définir une couleur pour une ligne ou une cellule de la list box tableau 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 s’applique à la ligne
si objet désigne une colonne, la commande s’applique à la cellule située à l’intersection colonne/ligne

Passez dans ligne le numéro de la ligne à laquelle la nouvelle couleur doit être appliquée.

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

Passez dans couleur une valeur de couleur RVB. Pour plus d’informations sur les couleurs RVB, reportez-vous à la description de la commande OBJET FIXER COULEURS RVB. Si vous souhaitez que la ligne hérite du paramétrage de couleur défini au niveau supérieur, passez la constante Listbox hérité dans couleur.

Passez la constante Listbox couleur de fond ou Listbox couleur de police dans le paramètre typeCouleur selon que vous souhaitez appliquer la couleur en tant que couleur de fond ou couleur de police de la ligne. Si vous omettez ce paramètre, la couleur est appliquée en tant que couleur de police.

Cette commande modifie les valeurs présentes dans les tableaux de couleurs éventuellement définis pour la colonne ou la listbox. Si ces tableaux ne sont pas déjà définis, la commande crée des tableaux dynamiques auxquels vous pourrez accéder à l’aide de la commande LISTBOX Lire tableau.

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

Dans une list box tableau, on souhaite définir des paramétrages de couleur pour une ligne et pour une cellule de cette ligne :

     // Définition de la couleur de police pour la cellule (jaune)

 LISTBOX FIXER COULEUR LIGNE(*;"Col5";3;0x00FFFF00)

 

     // Définition de la couleur de fond et de police pour la ligne 3

     // fond rouge, police bleue

 LISTBOX FIXER COULEUR LIGNE(*;"ListBox";3;0x00FF0000;Listbox couleur de fond)

 LISTBOX FIXER COULEUR LIGNE(*;"List Box";3;0x000000FF)