Функция SetTextColor (wingdi.h)

Статья
03/04/2024

Функция SetTextColor задает цвет текста для указанного контекста устройства в соответствии с заданным цветом.

Синтаксис

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

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] color

Цвет текста.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является ссылкой на цвет для предыдущего цвета текста в качестве значения COLORREF .

Если функция выполняется неудачно, возвращается значение CLR_INVALID.

Цвет текста используется для рисования лиц каждого символа, написанного функциями TextOut и ExtTextOut . Цвет текста также используется при преобразовании растровых изображений из цвета в монохромные и наоборот.

Примеры

Пример см. в разделе Настройка шрифтов для Menu-Item текстовых строк в разделе Использование меню.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll