NMLVCUSTOMDRAW structure (commctrl.h)
Contains information specific to an NM_CUSTOMDRAW (list view) notification code sent by a list-view control.
Syntax
typedef struct tagNMLVCUSTOMDRAW {
NMCUSTOMDRAW nmcd;
COLORREF clrText;
COLORREF clrTextBk;
int iSubItem;
DWORD dwItemType;
COLORREF clrFace;
int iIconEffect;
int iIconPhase;
int iPartId;
int iStateId;
RECT rcText;
UINT uAlign;
} NMLVCUSTOMDRAW, *LPNMLVCUSTOMDRAW;
Members
nmcd
Type: NMCUSTOMDRAW
NMCUSTOMDRAW structure that contains general custom draw information.
clrText
Type: COLORREF
COLORREF value representing the color that will be used to display text foreground in the list-view control.
clrTextBk
Type: COLORREF
COLORREF value representing the color that will be used to display text background in the list-view control. In Version 6.0., this member is ignored if the background image is set with the LVM_SETBKIMAGE message.
iSubItem
Type: int
Version 4.71. Index of the subitem that is being drawn. If the main item is being drawn, this member will be zero.
dwItemType
Type: DWORD
Version 6.0. DWORD that contains the type of the item to draw. This member can be one of the following values.
Value | Meaning |
---|---|
|
An item is to be drawn. |
|
A group is to be drawn. |
|
Every item is to be drawn. |
clrFace
Type: COLORREF
Version 6.0. COLORREF value representing the color that will be used to display the face of an item.
iIconEffect
Type: int
Version 6.0. Value of type int that specifies the effect that is applied to an icon, such as Glow, Shadow, or Pulse.
iIconPhase
Type: int
Version 6.0. Value of type int that specifies the phase of an icon.
iPartId
Type: int
Version 6.0. Value of type int that specifies the ID of the part of an item to draw.
iStateId
Type: int
Version 6.0. Value of type int that specifies the ID of the state of an item to draw.
rcText
Type: RECT
Version 6.0. RECT that specifies the rectangle in which the text is to be drawn.
uAlign
Type: UINT
Version 6.0. UINT that specifies how a group should be aligned. This member can be one of the following values.
Value | Meaning |
---|---|
|
Center the group. |
|
Align the group on the left. |
|
Align the group on the right. |
Remarks
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Header | commctrl.h |