Структура NMCUSTOMDRAW

Содержит информацию, указанную для уведомляющего сообщения NM_CUSTOMDRAW.

Синтаксис

typedef struct tagNMCUSTOMDRAWINFO {
    NMHDR hdr;
    DWORD dwDrawStage;
    HDC hdc;
    RECT rc;
    DWORD_PTR dwItemSpec;
    UINT uItemState;
    LPARAM lItemlParam;
} NMCUSTOMDRAW, *LPNMCUSTOMDRAW;

Члены структуры

hdr

Структура NMHDR, которая содержит информацию об этом уведомляющем сообщении.

dwDrawStage

Текущая стадия рисования. Это значение может быть одним из нижеследующих.

Общие значения	Предназначение
CDDS_POSTERASE	После того, как цикл стирания полностью завершается.
CDDS_POSTPAINT	После того, как цикл окрашивания полностью завершается.
CDDS_PREERASE	Прежде, чем начинается цикл стирания.
CDDS_PREPAINT	Прежде, чем начинается цикл окрашивания.

hdc

Дескриптор контекста устройства органа управления. Используйте этот HDC, чтобы выполнить любые функции GDI.

Структура RECT, которая описывает ограничивающий прямоугольник рисующейся области. Этот член структуры инициализируется только в соответствии с уведомлением CDDS_ITEMPREPAINT. Версия 5.80. Этот член структуры также инициализируется в соответствии с уведомлением CDDS_PREPAINT.

dwItemSpec

Номер элемента. То, что содержится в этом члене структуры, будет зависеть от типа органа управления, который отправляет уведомление. См. справочную информацию об уведомлении NM_CUSTOMDRAW для указанного органа управления, чтобы определить то, что, во всяком случае, содержится в этом члене структуры.

uItemState

Текущее состояние элемента. Это значение - комбинация нижеследующих флажков:

Значение	Предназначение
CDIS_CHECKED	Элемент отмечен галочкой.
CDIS_DEFAULT	Элемент находится в состоянии по умолчанию.
CDIS_DISABLED	Элемент заблокирован.
CDIS_FOCUS	Элемент имеет фокус.
CDIS_GRAYED	Элемент недоступен.
CDIS_HOT	Элемент находится в текущий момент под указателем ("горячий").
CDIS_INDETERMINATE	Элемент находится в неопределенном состоянии.
CDIS_MARKED	Элемент отмечен. Значение это - до реализации.
CDIS_SELECTED	Элемент выбран.
CDIS_SHOWKEYBOARDCUES	Версия 6.0.Элемент - команда вызова программы клавиатуры.

lItemlParam

Определяемые программой данные элемента.

Замечания

Значение, которое возвратит ваша прикладная программа, зависит от стадии текущего рисунка. Член dwDrawStage связанной структуры NMCUSTOMDRAW удерживает значение, которое определяет стадию рисования. Когда член структуры dwDrawStage равняется CDDS_PREPAINT и CDDS_PREERASE, некоторые органы управления отправляют сначала сообщение CDDS_PREERASE и ожидают возвращаемое значение, которое указывет, какие последующие сообщения должны быть отправлены. Примера кода см. в статье Пример CustomDrawButtonDlg, которая иллюстрирует состояния и этапы рисования.

Смотри также

Обзор Органы управления Windows, Структуры, используемые для выполнения специального рисования

Размещение и совместимость NMCUSTOMDRAW
К	Windows XP	Да
л	Windows 2000 Professional	Да
и	Windows NT Workstation	Да версии 4.0 с Internet Explorer 3.0
е	Windows Me	Да
н	Windows 98	Да
т	Windows 95	Да с Internet Explorer 3.0

С	Windows Server 2003	Да
е	Windows 2000 Server	Да
р	Windows NT Server	Да версии 4.0 с Internet Explorer 3.0
в
е
р
Используемая библиотека		-
Используемая DLL		comctl32.dll версии 4.70 или выше
Заголовочный файл
- объявлено в		commctrl.h
- включено в		-
Unicode		Нет
Замечания по платформе		Не имеется

Назад в оглавление

На главную страницу

В оглавление справки

Специфические для элемента значения	Предназначение
CDDS_ITEM	Указывает, что члены структуры dwItemSpec, uItemState и lItemlParam правильны.
CDDS_ITEMPOSTERASE	После того, как элемент был стерт.
CDDS_ITEMPOSTPAINT	После того, как элемент был нарисован.
CDDS_ITEMPREERASE	Прежде, чем элемент стерт.
CDDS_ITEMPREPAINT	Прежде, чем элемент будет нарисован.
CDDS_SUBITEM	Версия 4.71. Флажок объединяется с флажками CDDS_ITEMPREPAINT или CDDS_ITEMPOSTPAINT, если подэлемент рисуется. Флажок устанавливается только тогда, если CDRF_NOTIFYITEMDRAW возвращается из CDDS_PREPAINT.