4D v16.3

LISTBOX SET ROW COLOR

Accueil

 
4D v16.3
LISTBOX SET ROW COLOR

LISTBOX SET ROW COLOR 


 

LISTBOX SET ROW COLOR ( {* ;} objet ; ligne ; couleur {; typeCouleur} ) 
Paramètre Type   Description
Opérateur in Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable
objet  Objet de formulaire in Nom d'objet (si * est spécifié) ou Variable (si * est omis)
ligne  Entier long in Numéro de ligne
couleur  Entier long in Valeur de couleur RVB
typeCouleur  Entier long in Listbox couleur de police (défaut) ou Listbox couleur de fond

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

La commande LISTBOX SET ROW COLOR 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 OBJECT SET RGB COLORS. Si vous souhaitez que la ligne hérite du paramétrage de couleur défini au niveau supérieur, passez la constante lk inherited dans couleur.

Passez la constante lk background color ou lk font color 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 Get array

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 SET ROW COLOR(*;"Col5";3;0x00FFFF00)
 
     // Définition de la couleur de fond et de police pour la ligne 3
     // fond rouge, police bleue
 LISTBOX SET ROW COLOR(*;"ListBox";3;0x00FF0000;lk background color)
 LISTBOX SET ROW COLOR(*;"List Box";3;0x000000FF)



Voir aussi  

List box
LISTBOX Get row color
LISTBOX SET ROW FONT STYLE

 
PROPRIÉTÉS 

Produit : 4D
Thème : List Box
Numéro : 1270

 
HISTORIQUE 

Créé : 4D v14

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)