OBJECT SET COLOR

4D v15.4

OBJECT SET COLOR


OBJECT SET COLOR ( {* ;} objet ; couleur {; couleurAlt} )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est un champ ou une variable
objet	Champ, Variable	Nom d'objet (si * spécifié) ou Champ ou Variable (si * omis)
couleur	Entier long	Nouvelles couleurs pour l'objet
couleurAlt	Entier long	Couleur de fond alternée pour une list box

Description

La commande OBJECT SET COLOR définit les couleurs de premier plan et d'arrière-plan du ou des objet(s) de formulaire spécifié(s) par objet. Si objet est une list box, un paramètre supplémentaire permet de définir les couleurs de premier plan et d'arrière-plan des lignes paires (couleurs alternées).

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 le paramètre, vous indiquez que le paramètre objet est un champ ou une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de champ ou de 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 couleur définit à la fois les couleurs de premier plan et d'arrière-plan. La couleur est calculée de la manière suivante : Couleur:=-(Premier_Plan+(256 * Arrière_Plan)), où Premier_Plan et Arrière_Plan sont des numéros de couleur (de 0 à 255) parmi la palette de couleurs de 4D — que vous pouvez visualiser, par exemple, dans la Liste des propriétés de l'éditeur de formulaires. Couleur est toujours un nombre négatif.
Par exemple, si la couleur de premier plan est 20 et si la couleur d'arrière-plan est 10, alors couleur est égal à - (20 + (256 * 10)) soit -2580.

couleurAlt permet de désigner une couleur de fond alternative pour les lignes paires d'une list box ou d'une colonne de list box. Vous devez passer dans couleurAlt uniquement la partie "arrière-plan" de la formule de couleur, c'est-à-dire CouleurAlt:=-(256 * Arrière_Plan).
Lorsque ce paramètre est passé, la partie "arrière-plan" du paramètre couleur s'applique aux lignes impaires uniquement. Utiliser des couleurs de fond 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, seule la colonne utilisera les couleurs définies.

Les numéros les plus souvent utilisés sont fournis par 4D sous forme de constantes prédéfinies, placées dans le thème “Couleurs” :

Constante	Type	Valeur
Blanc	Entier long	0
Bleu	Entier long	6
Bleu clair	Entier long	7
Bleu foncé	Entier long	5
Gris	Entier long	14
Gris clair	Entier long	12
Gris foncé	Entier long	11
Jaune	Entier long	1
Marron	Entier long	13
Marron foncé	Entier long	10
Noir	Entier long	15
Orange	Entier long	2
Rouge	Entier long	3
Vert	Entier long	8
Vert foncé	Entier long	9
Violet	Entier long	4

Note : Tandis que OBJECT SET COLOR travaille avec des couleurs indexées dans la palette de couleurs de 4D, la commande OBJECT SET RGB COLORS vous permet de travailler avec toute couleur RVB. Pour rétablir les couleurs automatiques d'un objet, utilisez la commande OBJECT SET RGB COLORS avec les constantes Default foreground color et Default background color.

Exemple 1

L'exemple suivant définit la couleur de la zone de texte représentée ci-dessous dans l'éditeur de formulaires :

Après l'exécution de cette instruction :

OBJECT SET COLOR(*;"Montexte";-(Yellow+(256*Red)))

... la zone prend l'apparence suivante :

Exemple 2

Vous voulez définir une couleur de fond alternée pour une colonne de list box. Vous pouvez écrire :

OBJECT SET COLOR(*;"countryCol";-(Dark blue+(256*Red));-(256*Orange))

Voir aussi

Notes de programmation
OBJECT SET RGB COLORS