4D v16.3

LISTBOX Get row color

Accueil

 
4D v16.3
LISTBOX Get row color

LISTBOX Get row color 


 

LISTBOX Get row color ( {* ;} objet ; ligne {; typeCouleur} ) -> Résultat 
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
typeCouleur  Entier long in lk couleur de police (défaut) ou lk couleur de fond
Résultat  Entier long in Valeur de couleur

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

La commande LISTBOX Get row color 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 lk background color ou lk font color (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 Get row color(*;"Col5";3)
 vCoul2:=LISTBOX Get row color(*;"List Box";3)
 vCoul3:=LISTBOX Get row color(*;"List Box";lk background color)
     // vCoul contient 0xFFFF00 (jaune)
     // vCoul2 contient 0x00FF (bleu)
     // vCoul3 contient 0x00FF0000 (rouge)



Voir aussi  

List box
LISTBOX SET ROW COLOR

 
PROPRIÉTÉS 

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

 
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)