NMLVCUSTOMDRAW 结构 (commctrl.h)

  • 项目

包含特定于 NM_CUSTOMDRAW (列表视图的信息，) 列表视图控件发送的通知代码。

语法

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;

成员

nmcd

类型： NMCUSTOMDRAW

包含常规自定义绘图信息的 NMCUSTOMDRAW 结构。

clrText

类型： COLORREF

COLORREF 值，表示将用于在列表视图控件中显示文本前景的颜色。

clrTextBk

类型： COLORREF

COLORREF 值，表示将用于在列表视图控件中显示文本背景的颜色。 在 版本 6.0.中， 如果使用 LVM_SETBKIMAGE 消息设置背景图像，则忽略此成员。

iSubItem

类型： int

版本 4.71。 正在绘制的子项的索引。 如果正在绘制main项，则此成员将为零。

dwItemType

类型： DWORD

版本 6.0。   包含要绘制的项类型的 DWORD。 此成员可以是以下值之一。

值 含义
LVCDI_ITEM
 要绘制项。
LVCDI_GROUP
 将绘制一个组。
LVCDI_ITEMSLIST
 将绘制每个项。

clrFace

类型： COLORREF

版本 6.0。COLORREF 值，表示将用于显示项人脸的颜色。

iIconEffect

类型： int

版本 6.0。  int 类型的值，该值指定应用于图标（如 Glow、Shadow 或 Pulse）的效果。

iIconPhase

类型： int

版本 6.0。  int 类型的值，指定图标的阶段。

iPartId

类型： int

版本 6.0。  int 类型的值，指定要绘制的项部分的 ID。

iStateId

类型： int

版本 6.0。  int 类型的值，指定要绘制的项的状态 ID。

rcText

类型： RECT

版本 6.0。RECT ，指定要在其中绘制文本的矩形。

uAlign

类型： UINT

版本 6.0。指定如何对齐组的 UINT。 此成员可以是以下值之一。

值 含义
LVGA_HEADER_CENTER
 将组居中。
LVGA_HEADER_LEFT
 在左侧对齐组。
LVGA_HEADER_RIGHT
 将组对齐在右侧。

注解

注意 Comctl32.dll 版本 6 不可再发行，但它包含在 Windows 或更高版本中。 若要使用 Comctl32.dll 版本 6，请在清单中指定它。 有关清单的详细信息，请参阅 启用视觉样式。
 

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 commctrl.h