Aller au contenu principal
Version: Next

OBJECT SET RGB COLORS

OBJECT SET RGB COLORS ( {* ;} objet ; couleurAvantPlan {; couleurArrièrePlan {; couleurArrièrePlanAlt}} )

ParamètreTypeDescription
*OpérateurSi spécifié, objet est un nom d'objet (chaîne) Si omis, objet est un champ ou une variable
objetanyNom d'objet (si * est spécifié) ou Champ ou Variable (si * est omis)
couleurAvantPlanText, IntegerValeur de la couleur RVB d'avant-plan
couleurArrièrePlanText, IntegerValeur de la couleur RVB d'arrière-plan
couleurArrièrePlanAltText, IntegerValeur de la couleur RVB d'arrière-plan alternée

Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.

Description

La commande OBJECT SET RGB COLORS modifie les couleurs d'avant-plan et d'arrière-plan du ou des objet(s) défini(s) par le paramètre objet et le paramètre optionnel *. Lorsque la commande est appliquée à un objet de type list box, un paramètre supplémentaire permet de modifier la couleur alternée des lignes.

Si vous passez le paramètre optionnel *, vous spécifiez que le paramètre objet est le nom d'un objet (une chaîne de caractères). Si le paramètre * est omis, vous spécifiez que objet est un champ ou un objet. Dans ce cas, vous ne passez pas dans objet une chaîne de caractères mais la référence à un champ ou à une variable (champ ou variable objet uniquement). Pour plus d'informations sur les noms d'objets, reportez-vous à la section Objets de formulaires.

Le paramètre facultatif couleurArrièrePlanAlt permet de désigner une couleur alternative pour l’arrière-plan (c’est-à-dire le fond) des lignes paires. Ce paramètre n’est utile que lorsque l’objet désigné est de type list box ou colonne de list box. Lorsque ce paramètre est utilisé, la couleurArrièrePlan est utilisée pour le fond des lignes impaires uniquement. Utiliser des couleurs alternées améliore la lisibilité des tableaux.

Si objet désigne l’objet list box, les couleurs alternées sont utilisées dans la totalité de la list box. Si objet désigne une colonne de list box, seule cette colonne utilisera les couleurs définies.

Définition des couleurs

Vous passez des valeurs de couleurs RVB dans les paramètres couleurAvantPlan et, éventuellement, couleurArrièrePlan et couleurArrièrePlanAlt. Les formats suivants sont pris en charge :

Nom du formatTypeDescriptionExemples
Nom de la couleur CSSTexteNom de la couleur CSS standard.
La liste des noms est disponible en ligne, comme par exemple sur le site web htmlcolorcodes.com. Utilisez "transparent" pour obtenir un fond transparent (peut être utilisé uniquement avec les paramètres couleurArrièrePlan et couleurArrièrePlanAlt). Utilisez "" (chaîne vide) dans couleurAvantPlan et/ou couleurArrièrePlan pour laisser la couleur inchangée.
"red", "cyan", "lightblue"
Syntaxe "#rrggbb" de la couleur CSSTexteCode couleur standard CSS2 en notation hexadécimale : rr = Composante rouge de la couleur gg = Composante verte de la couleur bb = Composante bleue de la couleur"#ff0000", "#00FFFF", "#ADD8E6"
Syntaxe "rgb(r,g,b)" de la couleur CSSTexteCode couleur standard CSS2 en notation rvb :
r = Composante rouge de la couleur (0...255) g = Composante verte de la couleur (0...255) b = Composante bleue de la couleur (0...255)
"rgb(255,255,0)", "rgb(255,0,0)"
Valeur RVB de 4 octetsEntier longEntier long de 4 octets (format 0x00rrggbb). Valeurs hexadécimales :
rr = Composante rouge de la couleur gg = Composante verte de la couleur bb = Composante bleue de la couleur
0x00000000, 0x00FF7F7F
Constante couleur "système" 4DEntier longCouleurs utilisées par 4D pour dessiner des objets avec des couleurs automatiques. Constantes disponibles (du thème FIXER COULEUR RVB):
Background color Background color none (cette constante peut être utilisée uniquement avec les paramètres couleurArrièrePlan et couleurArrièrePlanAlt) Dark shadow color Disable highlight item color Foreground color Highlight menu background color Highlight menu text color Highlight text background color Highlight text color Light shadow color
Note : Les couleurs automatiques dépendent du système et du type d'objet auxquels elles sont affectées.

Exemple 1

Voici un formulaire contenant deux variables non saisissables, vsColorValue et vsColor ainsi que trois thermomètres, thRouge, thVert et thBleu :

Les méthodes associées à ces objets sont les suivantes :

  // Méthode objet de la variable non saisissable vsColorValue
 Case of
    :(FORM Event=On Load)
       vsColorValue:="0x00000000"
 End case
 
  // Méthode objet de la variable non saisissable vsColor
 Case of
    :(FORM Event=On Load)
       vsColor:=""
       OBJECT SET RGB COLORS(vsColor;0x00FFFFFF;0x0000)
 End case
 
  // Méthode objet du thermomètre thRouge
 CLIC SUR THERMOMETRE COULEUR
 
  // Méthode objet du thermomètre thVert
 CLIC SUR THERMOMETRE COULEUR
 
  // Méthode objet du thermomètre thBleu
 CLIC SUR THERMOMETRE COULEUR

La méthode projet appelée par les trois thermomètres est la suivante :

  // Méthode projet CLIC SUR THERMOMETRE COULEUR
 OBJECT SET RGB COLORS(vsColor;0x00FFFFFF;(thRouge << 16)+(thVert << 8)+thBleu)
 vsColorValue:=String((thRouge << 16)+(thVert << 8)+thBleu;" & x")
 If(thRouge=0)
    vsColorValue:=Substring(vsColorValue;1;2)+"0000"+Substring(vsColorValue;3)
 End if

Notez l'utilisation des SET AUTOMATIC RELATIONS pour le calcul des valeurs des couleurs à partir de celles des thermomètres.

En exécution, le formulaire a l'aspect suivant :

Exemple 2

Passage du fond en transparent avec couleur de police claire :

 OBJECT SET RGB COLORS(*;"maVar";Light shadow color;Background color none)

Voir aussi

_o_OBJECT SET COLOR
OBJECT GET RGB COLORS
Select RGB Color