SetTextColor 函数 (wingdi.h)

SetTextColor 函数将指定设备上下文的文本颜色设置为指定颜色。

语法

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

参数

[in] hdc

设备上下文的句柄。

[in] color

文本的颜色。

返回值

如果函数成功,则返回值是上一个文本颜色的颜色引用,作为 COLORREF 值。

如果函数失败,则返回值为 CLR_INVALID。

注解

文本颜色用于绘制 TextOutExtTextOut 函数编写的每个字符的脸。 文本颜色还用于将位图从颜色转换为单色,反之亦然。

示例

有关示例,请参阅 使用菜单中的“设置 Menu-Item 文本字符串的字体”。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

BitBlt

COLORREF

ExtTextOut

字体和文本函数

字体和文本概述

GetTextColor

RGB

SetBkColor

StretchBlt

TextOut