setTextColor 函式 (wingdi.h)

SetTextColor 函式會將指定裝置內容的文字色彩設定為指定的色彩。

語法

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

參數

[in] hdc

裝置內容的句柄。

[in] color

文字的色彩。

傳回值

如果函式成功,則傳回值是先前文字色彩的色彩參考做為 COLORREF 值。

如果函式失敗,則傳回值是 CLR_INVALID。

備註

文字色彩是用來繪製 TextOutExtTextOut 函式所撰寫之每個字元的臉部。 文字色彩也用於將點陣圖從色彩轉換成單色,反之亦然。

範例

For an example, see "Setting Fonts for Menu-Item Text Strings" in Using Menus.

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

BitBlt

COLORREF

ExtTextOut

字型和文字函式

字型和文字概觀

GetTextColor

RGB

SetBkColor

StretchBlt

TextOut