La commande OBJET LIRE COULEURS RVB retourne les couleurs d’avant-plan et d’arrière-plan de l'objet ou du groupe d'objets désigné(s) par objet.
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).
La valeur de couleurArrièrePlan retournée n'a de sens que l’objet désigné prend en charge l'attribut couleur de fond / couleur de remplissage.
Lorsque la commande est appliquée à un objet de type List box, la couleur d’arrière plan alternée des lignes peut être retournée dans le paramètre couleurArrièrePlanAlt. Dans ce cas, la valeur de couleurArrièrePlan est utilisée pour le fond des lignes impaires uniquement.
Les valeurs de couleurs RVB retournées dans les paramètres couleurAvantPlan, couleurArrièrePlan et couleurArrièrePlanAlt dépendent du type de paramètre :
- si un paramètre de type texte est passé, la couleur est retournée au format CSS avec la syntaxe "#rrggbb" (ex : "#0000FF")
- si un paramètre est de type entier long est passé, la couleur peut être un entier long de 4 octets au format (0x00RRGGBB), ou bien des valeurs négatives correspondant aux couleurs "système".
Pour plus d’informations sur le format des paramètres couleurAvantPlan, couleurArrièrePlan et couleurArrièrePlanAlt, reportez-vous à la description de la commande OBJET FIXER COULEURS RVB.