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