код уведомления NM_CUSTOMDRAW (представление в виде дерева)

  • Статья

Отправляется элементом управления в виде дерева для уведомления его родительского окна об операциях рисования. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMTVCUSTOMDRAW) lParam;

Параметры

lParam

Указатель на структуру NMTVCUSTOMDRAW , которая содержит и получает сведения об операции рисования. Элемент dwItemSpec элемента nmcd этой структуры содержит дескриптор отрисовываемого элемента. Элемент lItemlParam элемента nmcd этой структуры содержит lParam рисуемого элемента.

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

Возвращаемое приложением значение зависит от текущего этапа рисования. Элемент dwDrawStage связанной структуры NMCUSTOMDRAW содержит значение, указывающее этап рисования. Необходимо вернуть одно из следующих значений.

Код возврата Описание
CDRF_DODEFAULT
 Элемент управления рисует себя. Он не отправляет дополнительные коды NM_CUSTOMDRAW для этого цикла покраски. Это происходит, когда dwDrawStage равно CDDS_PREPAINT.
CDRF_NOTIFYITEMDRAW
 Элемент управления уведомляет родителя о любых операциях рисования, связанных с элементами. Он отправляет коды уведомлений NM_CUSTOMDRAW до и после рисования элементов. Это происходит, когда dwDrawStage равно CDDS_PREPAINT.
CDRF_NOTIFYPOSTERASE
 Элемент управления уведомляет родительский элемент после стирания элемента. Это происходит, когда dwDrawStage равно CDDS_PREPAINT.
CDRF_NOTIFYPOSTPAINT
 Элемент управления уведомляет родительский элемент после рисования элемента. Это происходит, когда dwDrawStage равно CDDS_PREPAINT.
CDRF_NOTIFYSUBITEMDRAW
 Версия 4.71. Элемент управления уведомляет родительский элемент при рисовании подэлемента представления списка. Это происходит, когда dwDrawStage равно CDDS_PREPAINT.
CDRF_NEWFONT
 Приложение указало новый шрифт для элемента; элемент управления будет использовать новый шрифт. Дополнительные сведения об изменении шрифтов см. в разделе Изменение шрифтов и цветов. Это происходит, когда dwDrawStage равно CDDS_ITEMPREPAINT.
CDRF_SKIPDEFAULT
 Приложение нарисовало элемент вручную. Элемент управления не будет рисовать элемент . Это происходит, когда dwDrawStage равно CDDS_ITEMPREPAINT.

Комментарии

Версия 5.80. Если изменить шрифт, возвращая CDRF_NEWFONT, элемент управления представлением в виде дерева может отображать обрезанный текст. Это необходимо для обеспечения обратной совместимости с более ранними версиями общих элементов управления. Если вы хотите изменить шрифт элемента управления в виде дерева, вы получите лучшие результаты, если отправить CCM_SETVERSION сообщение со значением wParam , равным 5, перед добавлением элементов в элемент управления.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Commctrl.h

См. также раздел

Использование пользовательского рисования