NMCUSTOMDRAW

This structure contains information specific to an NM_CUSTOMDRAW notification message.

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

Members

• hdr
  Handle to a NMHDR structure that contains information about this notification message.

• dwDrawStage
  Specifies the current drawing stage. It is one of the following values.

  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.

  Item-Specific Drawstage values:

  Value	Description
  CDDS_ITEM	Indicates that the dwItemSpec, uItemState, and lItemParam members 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 controls device context. Use this HDC to perform any GDI functions.

• rc
  RECT structure that describes the bounding rectangle of the area being drawn.

• dwItemSpec
  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 controls thumb marker slides along.
  TBCD_THUMB	Identifies the trackbar controls 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

Runs On	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Commctrl.h

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

NM_CUSTOMDRAW, NMHDR, RECT

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.