RF Constants

These constants are used as return values by a control in response to an NM_CUSTOMDRAW notification code.

Constant/value Description
CDRF_DODEFAULT
0x00000000
The control will draw itself. It will not send any additional NM_CUSTOMDRAW notification codes for this paint cycle. This occurs when the dwDrawStage of the NMCUSTOMDRAW structure equals CDDS_PREPAINT.
CDRF_NEWFONT
0x00000002
The application specified a new font for the item; the control will use the new font. For more information about changing fonts, see Changing fonts and colors. This occurs when the dwDrawStage of the NMCUSTOMDRAW structure equals CDDS_ITEMPREPAINT.
CDRF_SKIPDEFAULT
0x00000004
The application drew the item manually. The control will not draw the item. This occurs when the dwDrawStage of the NMCUSTOMDRAW structure equals CDDS_ITEMPREPAINT.
CDRF_DOERASE
0x00000008
Windows Vista and later. The control will draw the background.
CDRF_NOTIFYPOSTPAINT
0x00000010
The control will notify the parent after painting an item. This occurs when the dwDrawStage of the NMCUSTOMDRAW structure equals CDDS_PREPAINT.
CDRF_NOTIFYITEMDRAW
0x00000020
The control will notify the parent of any item-related drawing operations. It will send NM_CUSTOMDRAW notification codes before and after drawing items. This occurs when the dwDrawStage of the NMCUSTOMDRAW structure equals CDDS_PREPAINT.
CDRF_NOTIFYSUBITEMDRAW
0x00000020
Internet Explorer 4.0 and later. The control will notify the parent of any item-related drawing operations. It will send NM_CUSTOMDRAW notification codes before and after drawing items. This occurs when the dwDrawStage of the NMCUSTOMDRAW structure equals CDDS_PREPAINT. This flag is identical to CDRF_NOTIFYITEMDRAW and its use is context-dependent.
CDRF_NOTIFYPOSTERASE
0x00000040
The control will notify the parent after erasing an item. This occurs when the dwDrawStage of the NMCUSTOMDRAW structure equals CDDS_PREPAINT.
CDRF_SKIPPOSTPAINT
0x00000100
Windows Vista and later. The control will not draw the focus rectangle.

Remarks

These constants are defined in Commctrl.h.

Requirements

Requirement Value
Header
CommCtrl.h

See also

Customizing a Control's Appearance Using Custom Draw