TB_ADDBITMAP messaggio

Aggiunge una o più immagini all'elenco di immagini del pulsante disponibili per una barra degli strumenti.

Parametri

wParam

Numero di immagini del pulsante nella bitmap. Se lParam specifica una bitmap definita dal sistema, questo parametro viene ignorato.

lParam

Puntatore a una struttura TBADDBITMAP contenente l'identificatore di una risorsa bitmap e l'handle all'istanza del modulo con il file eseguibile che contiene la risorsa bitmap.

Valore restituito

Restituisce l'indice della prima immagine se ha esito positivo o -1 in caso contrario.

Commenti

Se la barra degli strumenti è stata creata usando la funzione CreateWindowEx , è necessario inviare il messaggio di TB_BUTTONSTRUCTSIZE alla barra degli strumenti prima di inviare TB_ADDBITMAP.

Esempio

L'esempio seguente crea una bitmap da una risorsa (IDB_BITMAP1), esegue il mapping del colore di sfondo (nero in questo caso) al colore del pulsante di sistema e lo aggiunge alla barra degli strumenti.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Commctrl.h