NMTBCUSTOMDRAW 结构 (commctrl.h)

包含特定于工具栏控件发送 的NM_CUSTOMDRAW 通知代码的信息。

语法

typedef struct _NMTBCUSTOMDRAW {
  NMCUSTOMDRAW nmcd;
  HBRUSH       hbrMonoDither;
  HBRUSH       hbrLines;
  HPEN         hpenLines;
  COLORREF     clrText;
  COLORREF     clrMark;
  COLORREF     clrTextHighlight;
  COLORREF     clrBtnFace;
  COLORREF     clrBtnHighlight;
  COLORREF     clrHighlightHotTrack;
  RECT         rcText;
  int          nStringBkMode;
  int          nHLStringBkMode;
  int          iListGap;
} NMTBCUSTOMDRAW, *LPNMTBCUSTOMDRAW;

成员

nmcd

类型： NMCUSTOMDRAW

包含常规自定义绘图信息的 NMCUSTOMDRAW 结构。 可以修改此结构的 uItemState 成员，以便在不实际更改项状态的情况下以指定状态绘制工具栏项。

hbrMonoDither

类型： HBRUSH

控件在绘制标记或抖乱项的背景时将使用的 HBRUSH。 如果从 NM_CUSTOMDRAW通知代码 返回TBCDRF_NOMARK，则忽略此成员。

hbrLines

类型： HBRUSH

控件在按钮上绘制线条时将使用的 HBRUSH。

hpenLines

类型： HPEN

控件在按钮上绘制线条时将使用的 HPEN。

clrText

类型： COLORREF

COLORREF ，表示控件在普通项上绘制文本时将使用的颜色。

clrMark

类型： COLORREF

COLORREF ，表示控件在标记项上绘制文本时将使用的背景色。

clrTextHighlight

类型： COLORREF

COLORREF ，表示控件在突出显示的项上绘制文本时将使用的颜色。

clrBtnFace

类型： COLORREF

COLORREF ，表示控件在绘制按钮时将使用的人脸颜色。

clrBtnHighlight

类型： COLORREF

COLORREF ，表示控件在绘制突出显示项时将使用的人脸颜色。 如果项具有TBSTATE_MARKED样式，并且包含在具有TBSTYLE_FLAT样式的工具栏中，则会突出显示该项。

clrHighlightHotTrack

类型： COLORREF

COLORREF ，表示在热跟踪项上绘制文本时控件将使用的背景色。 如果未从NM_CUSTOMDRAW通知代码返回 TBCDRF_HILITEHOTTRACK ，则忽略此成员。

rcText

类型： RECT

在输入时包含项文本矩形的 RECT 结构。 可以修改此结构的 右侧 和 底部 成员，以分别更改项的文本矩形的宽度和高度。

nStringBkMode

类型： int

控件在绘制非高亮项的文本时将使用的背景模式。 这可以是 TRANSPARENT 或 OPAQUE 值。

nHLStringBkMode

类型： int

控件在绘制突出显示项的文本时将使用的背景模式。 这可以是 TRANSPARENT 或 OPAQUE 值。

iListGap

类型： int

版本 6.0 为设置了 TBSTYLE_LIST 样式的工具栏指定工具栏按钮图像与文本之间的距离（以逻辑像素为单位）。

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

要求

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