Compartilhar via


TB_ADDBUTTONS mensagem

Adiciona um ou mais botões a uma barra de ferramentas.

Parâmetros

wParam

Número de botões a serem adicionados.

lParam

Ponteiro para uma matriz de estruturas TBBUTTON que contêm informações sobre os botões a serem adicionados. Deve haver o mesmo número de elementos na matriz que os botões especificados por wParam.

Valor retornado

Retornará TRUE se tiver êxito ou FALSE 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_ADDBUTTONS.

Consulte TB_SETIMAGELIST para obter uma discussão sobre como atribuir bitmaps a botões da barra de ferramentas de uma ou mais listas de imagens.

Exemplos

O código de exemplo a seguir adiciona três botões a uma barra de ferramentas, usando o bitmap do sistema padrão para botões de exibição. A mensagem TB_ADDBITMAP retorna o índice da primeira imagem de botão dentro da lista de imagens. Imagens individuais são identificadas por seus deslocamentos desse valor.

TBADDBITMAP tbAddBitmap;
tbAddBitmap.hInst = HINST_COMMCTRL;
tbAddBitmap.nID = IDB_VIEW_SMALL_COLOR;

// There are 12 items in IDB_VIEW_SMALL_COLOR.  However, because this is a standard
// system-defined bitmap, the wParam (nButtons) is ignored.
//
// hWndToolbar is the handle of the toolbar window.
//
// Do not forget to send TB_BUTTONSTRUCTSIZE if the toolbar was created
// by using CreateWindowEx.
//
int stdidx = SendMessage(hWndToolbar, TB_ADDBITMAP, 0, (LPARAM)&tbAddBitmap);

// Define the buttons. 
// IDM_SETLARGEICONVIEW and so on are application-defined command IDs.

const int numButtons = 3;
TBBUTTON tbButtonsAdd[numButtons] = 
{
    {stdidx + VIEW_LARGEICONS, IDM_SETLARGEICONVIEW, TBSTATE_ENABLED, BTNS_BUTTON},
    {stdidx + VIEW_SMALLICONS, IDM_SETSMALLICONVIEW, TBSTATE_ENABLED, BTNS_BUTTON},
    {stdidx + VIEW_DETAILS, IDM_SETDETAILSVIEW, TBSTATE_ENABLED, BTNS_BUTTON}
}; 

// Add the view buttons.
SendMessage(hWndToolbar, TB_ADDBUTTONS, numButtons, (LPARAM)tbButtonsAdd);

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
Nomes Unicode e ANSI
TB_ADDBUTTONSW (Unicode) e ANSI (TB_ADDBUTTONSA )

Confira também

Valores de índice de imagem de botão padrão da barra de ferramentas