TB _ ADDBUTTONS-Nachricht

Fügt einer Symbolleiste eine oder mehrere Schaltflächen hinzu.

Parameter

wParam

Anzahl der hinzuzufügenden Schaltflächen.

lParam

Zeiger auf ein Array von TBBUTTON-Strukturen, die Informationen zu den hinzuzufügenden Schaltflächen enthalten. Im Array muss die gleiche Anzahl von Elementen wie die von wParam angegebenen Schaltflächen enthalten sein.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE.

Bemerkungen

Wenn die Symbolleiste mit der CreateWindowEx-Funktion erstellt wurde, müssen Sie die TB _ BUTTONSTRUCTSIZE-Nachricht an die Symbolleiste senden, bevor Sie TB _ ADDBUTTONS senden.

Unter TB _ SETIMAGELIST erfahren Sie, wie Sie Symbolleistenschaltflächen bitmaps aus einer oder mehrere Bildlisten zuweisen.

Beispiele

Der folgende Beispielcode fügt einer Symbolleiste drei Schaltflächen hinzu, indem die Standardsystembitmap für Ansichtsschaltflächen verwendet wird. Die TB _ ADDBITMAP-Meldung gibt den Index des ersten Schaltflächenbilds in der Bildliste zurück. Einzelne Bilder werden durch ihre Offsets von diesem Wert identifiziert.

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

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h
Unicode- und ANSI-Name
TB _ ADDBUTTONSW (Unicode) und TB _ ADDBUTTONSA (ANSI)

Weitere Informationen

Symbolleisten-Standardschaltfläche Bildindexwerte