TB_ADDBITMAP mensagem

Adiciona uma ou mais imagens à lista de imagens de botão disponíveis para uma barra de ferramentas.

Parâmetros

wParam

Número de imagens de botão no bitmap. Se lParam especificar um bitmap definido pelo sistema, esse parâmetro será ignorado.

lParam

Ponteiro para uma estrutura TBADDBITMAP que contém o identificador de um recurso de bitmap e o identificador para a instância do módulo com o arquivo executável que contém o recurso bitmap.

Valor retornado

Retorna o índice da primeira nova imagem se tiver êxito ou -1 caso contrário.

Comentários

Se a barra de ferramentas tiver sido criada usando a função CreateWindowEx , você deverá enviar a mensagem TB_BUTTONSTRUCTSIZE para a barra de ferramentas antes de enviar TB_ADDBITMAP.

Exemplos

O exemplo a seguir cria um bitmap de um recurso (IDB_BITMAP1), mapeia a cor da tela de fundo (preto nesse caso) para a cor da face do botão do sistema e a adiciona à barra de ferramentas.

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	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Commctrl.h