Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains information specific to an NM_CUSTOMDRAWmessage.

Syntax 

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

Members

hdr

Handle to an NMHDRstructure that contains information about this message.

dwDrawStage

DWORD that specifies the current drawing stage. It is one of the values in the following tables.

The following table shows the global Drawstage values.

Value Description

CDDS_POSTERASE

After the erasing cycle is complete.

CDDS_POSTPAINT

After the painting cycle is complete.

CDDS_PREERASE

Before the erasing cycle begins.

CDDS_PREPAINT

Before the painting cycle begins.

The following table shows the global Drawstage values.

Value Description

CDDS_ITEM

Indicates that the dwItemSpec, uItemState, and lItemParammembers are valid.

CDDS_ITEMPOSTERASE

After an item has been erased.

CDDS_ITEMPOSTPAINT

After an item has been drawn.

CDDS_ITEMPREERASE

Before an item is erased.

CDDS_ITEMPREPAINT

Before an item is drawn.
hdc

Handle to the device context for the control. Use this handle to perform any GDI functions.

rc

RECTstructure that describes the bounding rectangle of the area being drawn. This member is used with the header, toolbar, ToolTip, and tree view common controls.

dwItemSpec

DWORDthat specifies the item number. This value is control specific, using the item-referencing convention for that control. Additionally, trackbar controls use the following values to identify portions of control.

Value Description

TBCD_CHANNEL

Identifies the channel that the trackbar control's thumb marker slides along.

TBCD_THUMB

Identifies the trackbar control's thumb marker. This is the portion of the control that the user moves.

TBCD_TICS

Identifies the increment tic marks that appear along the edge of the trackbar control.
uItemState

Specifies the current item state. It can be a combination of the following values.

Value Description

CDIS_CHECKED

The item is checked.

CDIS_DEFAULT

The item is in its default state.

CDIS_DISABLED

The item is disabled.

CDIS_FOCUS

The item is in focus.

CDIS_GRAYED

The item is grayed.

CDIS_HOT

The item is currently under the pointer (hot).

CDIS_SELECTED

The item is selected.
lItemlParam

Application-defined item data.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also