Partager via


Fonction SetTextColor (wingdi.h)

La fonction SetTextColor définit la couleur de texte du contexte d’appareil spécifié sur la couleur spécifiée.

Syntaxe

COLORREF SetTextColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] color

Couleur du texte.

Valeur retournée

Si la fonction réussit, la valeur de retour est une référence de couleur pour la couleur de texte précédente en tant que valeur COLORREF .

Si la fonction échoue, la valeur de retour sera CLR_INVALID.

Remarques

La couleur de texte est utilisée pour dessiner le visage de chaque caractère écrit par les fonctions TextOut et ExtTextOut . La couleur de texte est également utilisée pour convertir des bitmaps de couleur en monochrome et vice versa.

Exemples

Pour obtenir un exemple, consultez « Définition des polices pour Menu-Item chaînes de texte » dans Utilisation des menus.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

BitBlt

COLORREF

ExtTextOut

Fonctions police et texte

Vue d’ensemble des polices et du texte

GetTextColor

RGB

SetBkColor

StretchBlt

Textout