TB_ADDBUTTONS Nachricht

Artikel
06/13/2023

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. Es muss die gleiche Anzahl von Elementen im Array wie von wParam angegebene Schaltflächen vorhanden sein.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder 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.

Informationen zum Zuweisen von Bitmaps zu Symbolleistenschaltflächen aus einer oder mehreren Bildlisten finden Sie unter TB_SETIMAGELIST .

Beispiele

Im folgenden Beispielcode werden drei Schaltflächen zu einer Symbolleiste hinzugefügt, wobei die Standard-Systembitbitbit für Ansichtsschaltflächen verwendet wird. Die TB_ADDBITMAP Nachricht gibt den Index des ersten Schaltflächenbilds innerhalb 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);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h
Unicode- und ANSI-Name	TB_ADDBUTTONSW (Unicode) und TB_ADDBUTTONSA (ANSI)

Siehe auch

Symbolindexwerte der Symbolleisten-Standardschaltfläche

Freigeben über