CToolBarCtrl::AddButtons
Fügt eine oder mehrere Schaltflächen einem ToolBar-Steuerelement hinzu.
BOOL AddButtons(
int nNumButtons,
LPTBBUTTON lpButtons
);
Parameter
nNumButtons
Zahl Schaltflächen hinzuzufügen.lpButtons
Adresse eines Arrays TBBUTTON-Strukturen, das Informationen über die Schaltflächen, um hinzuzufügen.Es muss die gleiche Anzahl von Elementen im Array als Schaltflächen geben, die von nNumButtons angegeben werden.
Rückgabewert
Ungleich 0 (null), wenn erfolgreich; null andernfalls.
Hinweise
Der lpButtons Zeiger zeigt auf ein Array TBBUTTON-Strukturen.Jede TBBUTTON-Struktur werden die Schaltfläche zu, die mit dem Format der Schaltfläche, das Bild und/oder die Zeichenfolge, die Befehls-ID, der Zustand und die benutzerdefinierten Daten hinzugefügt wird:
typedef struct _TBBUTTON {
int iBitmap;// zero-based index of button image
int idCommand; // command to be sent when button pressed
BYTE fsState; // button state--see below
BYTE fsStyle; // button style--see below
DWORD dwData; // application-defined value
int iString;// zero-based index of button label string
} TBBUTTON;
Die Member sind, wie folgt:
iBitmap
Der nullbasierte Index von Schaltflächensymbol -1, wenn kein Bild für diese Schaltfläche.idCommand
Befehlskennzeichen zugeordnet mit der Schaltfläche.Dieser Bezeichner wird in einer WM_COMMAND Meldung gesendet, wenn die Schaltfläche ausgewählt wird.Wenn der fsStyle-Member TBSTYLE_SEP den Wert hat, muss dieser Member null sein.fsState
Schaltflächenzustandsflags.Sie kann eine Kombination der Werte, die unten aufgeführten:TBSTATE_CHECKED die Schaltfläche hat das Format TBSTYLE_CHECKED und wird gedrückt.
TBSTATE_ENABLED die Schaltfläche akzeptiert Benutzereingaben.Eine Schaltfläche, die nicht diesen Zustand verfügt, werden keine Benutzereingaben und wird abgeblendet.
TBSTATE_HIDDEN ist die Schaltfläche nicht angezeigt und kann Benutzereingaben nicht erhalten.
TBSTATE_INDETERMINATE die Schaltfläche ist abgeblendet.
TBSTATE_PRESSED die Schaltfläche gedrückt wird.
Zeilenumbruch TBSTATE_WRAP A folgt der Schaltfläche.Die Schaltfläche muss den TBSTATE_ENABLED Zustand verfügen.
fsStyle
Schaltflächenformat.Sie kann eine Kombination der Werte, die unten aufgeführten:TBSTYLE_BUTTON stellt eine Standardschaltfläche erstellt.
TBSTYLE_CHECK stellt eine Schaltfläche erstellt, die zwischen gedrückt umschaltet und nicht gedrückten Zustand jedes Mal klickt der Benutzer auf diese.Die Schaltfläche besitzt eine andere Hintergrundfarbe, wenn sie im gedrückten Zustand befindet.
TBSTYLE_CHECKGROUP stellt eine Überprüfungsschaltfläche erstellt, dass, die ständig bis eine weitere Schaltfläche in der Gruppe gedrückt werden, gedrückt wird.
TBSTYLE_GROUP stellt eine Schaltfläche erstellt, die gedrückt bleibt, bis eine weitere Schaltfläche in der Gruppe gedrückt ist.
TBSTYLE_SEP stellt ein Trennzeichen erstellt und stellt eine kleine Lücke zwischen Schaltflächengruppen bereit.Eine Schaltfläche, die dieses Format hat, empfängt keine Benutzereingaben.
dwData
Benutzerdefinierte Daten.iString
Der nullbasierte Index der als Bezeichnung der Schaltfläche, -1 zu verwenden, Zeichenfolge, wenn keine Zeichenfolge für diese Schaltfläche gibt.
Das Bild und/oder die Zeichenfolge, deren Index, den Sie bereitstellen, der Liste der Symbolleisten-Steuerelements mithilfe AddBitmap, AddString und/oder AddStrings zuvor hinzugefügt worden sein muss.
Anforderungen
Header: afxcmn.h