TB_ADDBITMAP メッセージ

ツール バーで使用できるボタン イメージの一覧に 1 つ以上の画像を追加します。

パラメーター

wParam

ビットマップ内のボタン イメージの数。 lParam でシステム定義ビットマップが指定されている場合、このパラメーターは無視されます。

lParam

ビットマップ リソースの識別子と、ビットマップ リソースを含む実行可能ファイルを持つモジュール インスタンスへのハンドルを含む TBADDBITMAP 構造体へのポインター。

戻り値

成功した場合は最初の新しいイメージのインデックスを返し、それ以外の場合は -1 を返します。

解説

ツール バーが CreateWindowEx 関数を使用して作成された場合は、 TB_ADDBITMAP を送信する前にTB_BUTTONSTRUCTSIZE メッセージをツール バーに送信 する必要があります。

例

次の例では、リソース (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