SetTextColor-Funktion (wingdi.h)

Artikel
03/04/2024

Die SetTextColor-Funktion legt die Textfarbe für den angegebenen Gerätekontext auf die angegebene Farbe fest.

Syntax

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

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] color

Die Farbe des Texts.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Farbverweis für die vorherige Textfarbe als COLORREF-Wert .

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert CLR_INVALID.

Hinweise

Die Textfarbe wird verwendet, um das Gesicht jedes Zeichens zu zeichnen, das von den Funktionen TextOut und ExtTextOut geschrieben wurde. Die Textfarbe wird auch beim Konvertieren von Bitmaps von Farbe in Monochrom und umgekehrt verwendet.

Beispiele

Ein Beispiel finden Sie unter Festlegen von Schriftarten für Menu-Item Textzeichenfolgen unter Verwenden von Menüs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll