_SETBKCOLOR

Syntaxe

Paramètres

Description

Cette procédure permet de fixer la couleur d'arrière-plan courante.

Remarque

• La procédure _SetBkColor définit la couleur d'arrière-plan actuelle sur la couleur spécifiée dans le paramètre color de type de données LongInt. La couleur d'arrière-plan ne peut pas être modifiée dans les modes _HResBW ou _OResColor.
• Dans un mode texte (comme _TextC80), la procédure _SetBkColor est accepté et la fonction _GetBkColor renvoie un index de couleur. Par exemple, _SetBkColor(2) définit la couleur d'arrière-plan sur l'index de couleur 2. La couleur réelle affichée dépend de la cartographie de palette pour l'index de couleur 2. La valeur de couleur par défaut pour l'index de couleur 2 est le vert en mode texte couleur.
• Dans un mode graphique couleur (tel que _EResColor), la procédure _SetBkColor est accepté et la fonction _GetBkColor renvoie une valeur de couleur (telle qu'utilisée dans _RemapPalette). La valeur de la couleur d'arrière-plan peut être donnée par les constantes de couleur définies dans MSGraph. Par exemple, _SetBkColor(_Green) définit la couleur d'arrière-plan dans un mode graphique couleur sur vert. Ces constantes sont fournies pour faciliter le travail avec les couleurs les plus courantes. La gamme réelle de couleurs disponibles est généralement beaucoup plus large. D'autres constantes sont disponibles pour le mode graphique monochrome, _EResNoColor. En mode _EResNoColor, seuls 0 à 8 sont des valeurs de couleur d'arrière-plan valides. Voir MSGraph pour les définitions de ces constantes.
• Lorsqu'un paramètre color est de type LongInt, il fait généralement référence à une valeur de couleur, et lorsqu'il est de type Integer, il fait référence à un attribut ou à un index de couleur. La procédure _SetBkColor et la fonction _GetBkColor sont des exceptions : le paramètre est un index de couleur dans les modes texte et une valeur de couleur dans les modes graphiques.
• La procédure _RemapPalette peut également être utilisé pour définir la couleur d'arrière-plan dans les modes graphiques. La couleur d'arrière-plan a un indice de couleur de 0. Contrairement à _RemapPalette, cependant, la procédure _SetBkColor ne nécessite pas d'environnement EGA, MCGA ou VGA.
• En mode texte, la procédure _SetBkColor affecte la sortie suivante, mais ne modifie pas l'affichage actuel. Dans un mode graphique, il modifie immédiatement l'apparence de tous les pixels d'arrière-plan.
• La fonction _GrStatus retourne _GrInvalidParameter ou _GrParameterAltered.