TB_ADDBITMAP訊息

  • 發行項

將一或多個影像新增至工具列可用的按鈕影像清單。

參數

wParam

點陣圖中的按鈕影像數目。 如果 lParam 指定系統定義的點陣圖，則會忽略此參數。

lParam

TBADDBITMAP結構的指標，其中包含點陣圖資源的識別碼，以及包含點陣圖資源的可執行檔之模組實例的控制碼。

傳回值

如果成功，則傳回第一個新影像的索引，否則傳回 -1。

備註

如果使用 CreateWindowEx 函式建立工具列，您必須先將 TB_BUTTONSTRUCTSIZE 訊息傳送至工具列，才能傳送 TB_ADDBITMAP。

範例

下列範例會從資源 (IDB_BITMAP1) 建立點陣圖、將背景色彩 (黑色，在此案例中) 對應至系統按鈕臉部色彩，並將它新增至工具列。

DWORD backgroundColor = GetSysColor(COLOR_BTNFACE);
COLORMAP colorMap;
colorMap.from = RGB(0, 0, 0);
colorMap.to = backgroundColor;
HBITMAP hbm = CreateMappedBitmap(g_hInst, IDB_BITMAP1, 0, &colorMap, 1);
TBADDBITMAP tb;
tb.hInst = NULL;
tb.nID = (UINT_PTR)hbm;

// hWndToolbar is the window handle of the toolbar.
// Do not forget to send TB_BUTTONSTRUCTSIZE if the toolbar was 
// created by using CreateWindowEx.
int index = SendMessage (hWndToolbar, TB_ADDBITMAP, 0, (LPARAM)&tb);

規格需求

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