OBJECT SET COLOR

4D v16.3

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
Black	Entier long	15
Blue	Entier long	6
Brown	Entier long	13
Dark blue	Entier long	5
Dark brown	Entier long	10
Dark green	Entier long	9
Dark grey	Entier long	11
Green	Entier long	8
Grey	Entier long	14
Light blue	Entier long	7
Light grey	Entier long	12
Orange	Entier long	2
Purple	Entier long	4
Red	Entier long	3
White	Entier long	0
Yellow	Entier long	1

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