SetTextColor-Funktion (wingdi.h)

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

Weitere Informationen

Bitblt

COLORREF

ExtTextOut

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

GetTextColor

RGB

SetBkColor

StretchBlt

Textout