NM_CUSTOMDRAW


		Contents Index Topic Contents
	Previous Topic: Notification Messages Next Topic: Custom Draw Structures

NM_CUSTOMDRAW
NM_CUSTOMDRAW
#ifdef LIST_VIEW_CUSTOM_DRAW
    lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;
#elif TOOL_TIPS_CUSTOM_DRAW
    lpNMCustomDraw = (LPNMTTCUSTOMDRAW) lParam;
#elif TREE_VIEW_CUSTOM_DRAW
    lpNMCustomDraw = (LPNMTVCUSTOMDRAW) lParam;
#elif TOOL_BAR_CUSTOM_DRAW
    lpNMCustomDraw = (LPNMTBCUSTOMDRAW) lParam;
#else
    lpNMCustomDraw = (LPNMCUSTOMDRAW) lParam;
#endif
Sent by some common controls to notify their parent windows about drawing operations. This notification is sent in the form of a WM_NOTIFY message.
Currently, the following controls support custom draw functionality: header, list view, rebar, toolbar, tooltip, trackbar, and tree view.
The value your application can return depends on the current drawing stage. The dwDrawStage member of the associated NMCUSTOMDRAW structure holds a value that specifies the drawing stage. You must return one of the following values.
When dwDrawStage equals CDDS_PREPAINT:

CDRF_DODEFAULT
The control will draw itself. It will not send any additional NM_CUSTOMDRAW messages for this paint cycle.
CDRF_NOTIFYITEMDRAW
The control will notify the parent of any item-related drawing operations. It will send NM_CUSTOMDRAW notification messages before and after drawing items.
CDRF_NOTIFYPOSTERASE
The control will notify the parent after erasing an item.
CDRF_NOTIFYPOSTPAINT
The control will notify the parent after painting an item.
CDRF_NOTIFYSUBITEMDRAW
Version 4.71. The control will notify the parent when a list view subitem is being drawn.

When dwDrawStage equals CDDS_ITEMPREPAINT:

CDRF_NEWFONT
Your application specified a new font for the item; the control will use the new font. For more information on changing fonts, see Changing fonts and colors.
CDRF_SKIPDEFAULT
Your application drew the item manually. The control will not draw the item.

lpNMCustomDraw
Address of a custom draw-related structure that contains information about the drawing operation. List view controls use the NMLVCUSTOMDRAW structure, tooltip controls use the NMTTCUSTOMDRAW structure, tree view controls use the NMTVCUSTOMDRAW structure, toolbar controls use the NMTBCUSTOMDRAW structure, and all other supported controls use the NMCUSTOMDRAW structure.

Version 4.70
See also Using Custom Draw

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.