Функция DrawState отображает изображение и приспосабливает визуальный эффект для указания состояния, таких как отключенность или состояние по умолчанию.

BOOL WINAPI DrawState(
    HDC hdc,	// дескриптор контекста устройства
    HBRUSH hbr,	// дескриптор кисти
    DRAWSTATEPROC lpOutputFunc,	// адрес функции обратного вызова
    LPARAM lData,	// информация об изображении
    WPARAM wData,	// еще информация об изображении
    int x,	// горизонтальное положение изображения
    int y,	// вертикальное положение изображения
    int cx,	// длина изображения
    int cy,	// высота изображения
    UINT fuFlags	// тип и состояние изображения
   );

Параметры:

hdc	Указывает дескриптор контекста устройства, в котором происходит прорисовка.
hbr	Указывает кисть, которой прорисовывается изображение, если состояние в параметре fuFlags имеет значение DSS_MONO. Этот параметр игнорируется при других состояниях.
lpOutputFunc	Адрес определенной приложением функции обратного вызова, которая используется для рендеринга (прорисовки) изображения. Этот параметр требуется, если тип изображения в fuFlags имеет значение DST_COMPLEX. Это не обязательно и может быть равным NULL, если тип изображения DST_TEXT. Для всех других типов, этот параметр игнорируется. Для получения большей информации о функции обратного вызова, смотрите описание функции DrawStateProc.
lData	Определяет информацию изображения. Назначение этого параметра зависит от типа изображения.
wData	Определяет информацию изображения. Назначение этого параметра зависит от типа изображения. Он, как обычно, заполнен нулями при использовании в функции DrawStateProc.
x	Определяет горизонтальное положение, в котором отображается изображение.
y	Определяет вертикальное положение, в котором отображается изображение.
cx	Определяет длину изображения, в цифрах исчисления устройства. Этот параметр требуется, если тип изображения имеет значение DST_COMPLEX. В других случаях, этот параметр может быть нулевым для подсчета длины изображения.
cy	Определяет высоту изображения, в цифрах исчисления устройства. Этот параметр требуется, если тип изображения имеет значение DST_COMPLEX. В других случаях, этот параметр может быть нулевым для подсчета высоты изображения.
fuFlags	Определяет тип и состояние изображения. Тип может принимать одно из следующих значений: Значение типа: Описание: DST_BITMAP Изображение является растровым. Младшее слово параметра lData содержит дескриптор растрового изображения. DST_COMPLEX Изображение определено приложением. Для рендеринга изображения, DrawState вызывает функцию обратного вызова, указанную в параметре lpOutputFunc. DST_ICON Изображение является иконкой. Младшее слово параметра lData содержит дескриптор иконки. DST_PREFIXTEXT Изображение является текстом, который может содержать символический акселератор. DrawState переводит знак амперсанта (&) как признак к подчеркиванию следующего за ним символа. Параметр lData определяет адрес строки, и параметр wData содержит длину строки. Если wData равен нулю, то строка должна заканчиватся нулевым символом. DST_TEXT Изображение является текстом. Параметр lData определяет адрес строки, и параметр wData содержит длину строки. Если wData равен нулю, то строка должна заканчиватся нулевым символом. Состояние может принимать одно из следующих значений: Значение состояния: Описание: DSS_NORMAL Изображение прорисовывается безо всякой модификации. DSS_UNION Сглаживает изображение. DSS_DISABLED Рельефное изображение. DSS_MONO Выводит изображение, используя кисть, указанную параметром hbr. DSS_RIGHT Выравнивает текст вправо. DSS_PREFIXONLY (Начиная с Win2000) Выводит только подчеркнутые амперсантом символы. Текст в строке не выводится. Используется с DST_PREFIXTEXT. Для всех состояний, исключая DSS_NORMAL, изображение преобразуется к одноцветному перед выполнением визуального эффекта.

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

При успешном завершении, функция возвращает ненулевое значение.
При ошибке возвращается ноль.

Смотрите также: