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

  • Статья

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

NM_CUSTOMDRAW
        
    lpNMCustomDraw = (LPNMCUSTOMDRAW) lParam;

Параметры

lParam

Версия 4.70. Указатель на структуру NMCUSTOMDRAW , содержащую сведения об операции рисования. Элемент dwItemSpec этой структуры содержит идентификатор команды отрисовываемого элемента. Элемент lItemlParam этой структуры содержит значение dwData для отрисовываемого элемента.

Версия 4.71. Указатель на структуру NMTBCUSTOMDRAW , содержащую сведения об операции рисования. Элемент dwItemSpec элемента nmcd этой структуры содержит идентификатор команды отрисовываемого элемента. Элемент lItemlParam элемента nmcd этой структуры содержит значение dwData для отрисовываемого элемента.

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

Значение, которое может вернуть приложение, зависит от текущего этапа рисования. Элемент 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.
TBCDRF_BLENDICON
 Версия 5.00. Смешайте кнопку на 50 процентов с фоном. Это происходит, когда dwDrawStage равно CDDS_ITEMPREPAINT.
TBCDRF_NOBACKGROUND
 Версия 5.00. Не рисуйте фон кнопки. Это происходит, когда dwDrawStage равно CDDS_ITEMPREPAINT.
TBCDRF_NOEDGES
 Версия 4.71. Не рисуйте края кнопки. Это происходит, когда dwDrawStage равно CDDS_ITEMPREPAINT.
TBCDRF_HILITEHOTTRACK
 Версия 4.71. Используйте элемент clrHighlightHotTrack структуры NMTBCUSTOMDRAW для рисования фона элементов с горячим отслеживанием. Это происходит, когда dwDrawStage равно CDDS_ITEMPREPAINT.
TBCDRF_NOOFFSET
 Версия 4.71. Не смещайте кнопку при нажатии. Это происходит, когда dwDrawStage равно CDDS_ITEMPREPAINT.
TBCDRF_NOMARK
 Не рисуйте выделение по умолчанию для элементов с TBSTATE_MARKED. Это происходит, когда dwDrawStage равно CDDS_ITEMPREPAINT.
TBCDRF_NOETCHEDEFFECT
 Версия 4.71. Не рисуйте эффект выгравирования для отключенных элементов. Это происходит, когда dwDrawStage равно CDDS_ITEMPREPAINT.
TBCDRF_USECDCOLORS
 Версия 6.00, только Windows Vista . Используйте пользовательские цвета рисования для отрисовки текста независимо от стиля визуального элемента.

Требования

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

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

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