Fonction SetTextColor (wingdi.h)

2024-03-04

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