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 或更新版本中。 若要使用第 6 版 Comctl32.dll，請在指令清單中指定它。 如需指令清單的詳細資訊，請參閱 啟用可視化樣式。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	commctrl.h