TBADDBITMAP 結構 (commctrl.h)

將包含按鈕影像的點陣圖新增至工具列。

語法

typedef struct tagTBADDBITMAP {
  HINSTANCE hInst;
  UINT_PTR  nID;
} TBADDBITMAP, *LPTBADDBITMAP;

hInst

類型： HINSTANCE

使用包含位圖資源的可執行檔來處理模組實例。若要使用位圖句柄，而不是資源標識符，請將此成員設定為 NULL。

您可以將系統定義的按鈕點圖新增至清單中，方法是將HINST_COMMCTRL指定為 hInst 成員，並將下列其中一個值指定為 nID 成員。

值	意義
IDB_STD_LARGE_COLOR	大型色彩標準點圖。
IDB_STD_SMALL_COLOR	小型、色彩標準點陣圖。
IDB_VIEW_LARGE_COLOR	小型大型色彩檢視位圖。
IDB_VIEW_SMALL_COLOR	小型色彩檢視點陣圖。
IDB_HIST_NORMAL	Windows 檔案總管移動按鈕和慣用位圖處於正常狀態。
IDB_HIST_HOT	Windows 檔案總管移動按鈕和最愛處於作用中狀態的點陣圖。
IDB_HIST_DISABLED	處於停用狀態的 Windows 檔案總管移動按鈕和我的最愛點陣圖。
IDB_HIST_PRESSED	處於已按下狀態的 Windows 檔案總管移動按鈕和我的最愛位圖。

nID

類型： UINT_PTR

如果 hInst 為 NULL，請將此成員設定為具有按鈕影像之點陣圖的點陣圖句柄。否則，請使用按鈕影像，將它設定為位圖的資源標識符。

如果 nID 保留位圖句柄，而不是資源標識符，則除非將點陣圖取代為 TB_REPLACEBITMAP，否則請勿終結該位圖。否則，工具列會終結。

定義的值可以當做標準點陣圖的索引使用。如需詳細資訊，請參閱工具列標準按鈕影像索引值。

TBADDBITMAP 結構會與TB_ADDBITMAP訊息搭配使用。