TB_ADDBUTTONS messaggio

Aggiunge uno o più pulsanti a una barra degli strumenti.

Parametri

wParam

Numero di pulsanti da aggiungere.

lParam

Puntatore a una matrice di strutture TBBUTTON che contengono informazioni sui pulsanti da aggiungere. Deve essere presente lo stesso numero di elementi nella matrice come i pulsanti specificati da wParam.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE 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_ADDBUTTONS.

Vedere TB_SETIMAGELIST per una discussione su come assegnare bitmap ai pulsanti della barra degli strumenti da uno o più elenchi di immagini.

Esempio

Il codice di esempio seguente aggiunge tre pulsanti a una barra degli strumenti usando la bitmap di sistema standard per i pulsanti di visualizzazione. Il messaggio TB_ADDBITMAP restituisce l'indice della prima immagine del pulsante all'interno dell'elenco di immagini. Le singole immagini vengono identificate dagli offset di tale valore.

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

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Commctrl.h
Nomi Unicode e ANSI
TB_ADDBUTTONSW (Unicode) e TB_ADDBUTTONSA (ANSI)

Vedi anche

Valori dell'indice dell'immagine del pulsante standard della barra degli strumenti