mensaje de TB_ADDBITMAP

Agrega una o varias imágenes a la lista de imágenes de botón disponibles para una barra de herramientas.

Parámetros

wParam

Número de imágenes de botones en el mapa de bits. Si lParam especifica un mapa de bits definido por el sistema, se omite este parámetro.

lParam

Puntero a una estructura TBADDBITMAP que contiene el identificador de un recurso de mapa de bits y el identificador de la instancia del módulo con el archivo ejecutable que contiene el recurso de mapa de bits.

Valor devuelto

Devuelve el índice de la primera imagen nueva si se ejecuta correctamente o -1 de lo contrario.

Observaciones

Si la barra de herramientas se creó con la función CreateWindowEx , debe enviar el mensaje TB_BUTTONSTRUCTSIZE a la barra de herramientas antes de enviar TB_ADDBITMAP.

Ejemplos

En el ejemplo siguiente se crea un mapa de bits a partir de un recurso (IDB_BITMAP1), se asigna el color de fondo (negro en este caso) al color de la cara del botón del sistema y se agrega a la barra de herramientas.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Commctrl.h