TB_ADDBITMAP Nachricht

Fügt der Liste der Schaltflächenbilder, die für eine Symbolleiste verfügbar sind, ein oder mehrere Bilder hinzu.

Parameter

wParam

Anzahl der Schaltflächenbilder in der Bitmap. Wenn lParam eine systemdefinierte Bitmap angibt, wird dieser Parameter ignoriert.

lParam

Zeiger auf eine TBADDBITMAP-Struktur, die den Bezeichner einer Bitmapressource und das Handle zum Modul enthält, instance mit der ausführbaren Datei, die die Bitmapressource enthält.

Rückgabewert

Gibt bei erfolgreicher Ausführung den Index des ersten neuen Images zurück, andernfalls -1.

Bemerkungen

Wenn die Symbolleiste mit der CreateWindowEx-Funktion erstellt wurde, müssen Sie die TB_BUTTONSTRUCTSIZE Nachricht an die Symbolleiste senden , bevor Sie TB_ADDBITMAP senden.

Beispiele

Im folgenden Beispiel wird eine Bitmap aus einer Ressource (IDB_BITMAP1) erstellt, die Hintergrundfarbe (in diesem Fall schwarz) der Gesichtsfarbe der Systemschaltfläche zugeordnet und der Symbolleiste hinzugefügt.

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);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h