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 |
|
| Unicode- und ANSI-Name |
TB _ ADDBUTTONSW (Unicode) und TB _ ADDBUTTONSA (ANSI) |