CToolBarCtrl::AddButtons

BOOL AddButtons ( Int nNumButtons, LPTBBUTTON LpButtons );

Rückgabewert

Ungleich NULL, wenn erfolgreich; andernfalls 0 (null).

Parameter

nNumButtons

Anzahl der Schaltflächen hinzu.

lpButtons

Adresse eines Arrays von TBUTTON -Strukturen, die enthält Informationen zu den Schaltflächen hinzufügen. Muss es die gleiche Anzahl der Elemente im Array wie Schaltflächen, die durch nNumButtons angegeben.

Bemerkungen

Rufen Sie diese Funktion ein Toolbar-Steuerelement eine oder mehrere Schaltflächen hinzu.

Der LpButtons -Zeiger verweist auf ein Array von TBBUTTON -Strukturen. Jede TBUTTON -Struktur ordnet die Schaltfläche der Schaltfläche Stil, Bild und/oder Zeichenfolge, Befehls-ID, Status und benutzerdefinierte Daten hinzugefügt wird:

typedef Struct _TBBUTTO&N {}
Int iBitmap; / / nullbasierte Index der Schaltflächenbild
Int IdCommand; Nbsp; / / Befehl gesendet werden, wenn gedrückt
BYTE FsState;   / / Taste Zustand--siehe unten
BYTE FsStyle;   / / Taste Stil--siehe unten
DWORD DwData;   / / anwendungsspezifischer Wert
Int iString; / / nullbasierte Index des Button label String
} TBUTTON

Die Mitglieder sind wie folgt:

iBitmap

Nullbasierte Index der Schaltflächenbild. NULL , wenn kein Bild für diese Schaltfläche.

idCommand

Mit der Schaltfläche verknüpften Befehl ID. Diese Kennung wird eine WM_COMMAND -Nachricht gesendet, wenn die Schaltfläche ausgewählt wird. Wenn der FsStyle -Member den TBSTYLE_SEP -Wert besitzt, muss dieser Member NULL sein.

fsState

Schaltfläche Status-Flags. Es kann eine Kombination der unten aufgeführten Werte sein.:

TBSTATE_CHECKED&Nbsp; Die Schaltfläche hat den TBSTYLE_CHECKED Stil und gedrückt wird.
TBSTATE_E&NABLEDNbsp; Die Schaltfläche akzeptiert Benutzereingaben. Eine Schaltfläche, die keinen dieser Zustand akzeptiert keine Eingaben des Benutzers und wird grau dargestellt.
TBSTATE_HIDDE&NNbsp; Die Schaltfläche nicht sichtbar ist und keine Benutzereingaben empfangen.
TBSTATE_I&NDETERMINATENbsp; Die Schaltfläche ist abgeblendet.
TBSTATE_PRESSED&Nbsp; Die Schaltfläche ist gedrückt wird.
TBSTATE_WRAP&Nbsp; Ein Zeilenumbruch folgt die Schaltfläche. Die Taste muss auch den TBSTATE_ENABLED Staat.

fsStyle

Schaltflächen-Formatvorlage. Es kann eine Kombination der unten aufgeführten Werte sein.:

TBSTYLE_BUTTO&NNbsp; Erstellt eine standard Schaltfläche.
TBSTYLE_CHECKNbsp; Erstellt eine Schaltfläche, die zwischen den Staaten gedrückten und nicht gedrückt jedes Mal schaltet der Benutzer darauf klickt. Die Schaltfläche besitzt eine andere Hintergrundfarbe, wenn es im gedrückten Zustand ist. & Nbsp;
TBSTYLE_CHECKGROUP&Nbsp; Erstellt eine Schaltfläche, die gedrückt bleibt, bis eine andere Schaltfläche in der Gruppe gedrückt wird.
TBSTYLE_GROUP&Nbsp; Erstellt eine Schaltfläche, die gedrückt bleibt, bis eine andere Schaltfläche in der Gruppe gedrückt wird.
TBSTYLE_SEP&Nbsp; Erstellt ein Trennzeichen, eine kleine Lücke zwischen Buttongruppen bereitstellen. Eine Schaltfläche, die dieser Stil hat erhält keine Benutzereingaben.

dwData

Benutzerdefinierte Daten.

iString

Nullbasierte Index der Zeichenfolge für die Beschriftung der Schaltfläche verwendet. NULL , wenn keine Zeichenfolge für diese Schaltfläche.

Das Bild und/oder Zeichenfolge dessen Index Sie bereitstellen, muss zuvor das Toolbar-Steuerelement Liste mit AddBitmap, AddStringund/oder AddStrings hinzugefügt wurden.

CToolBarCtrl Übersicht | Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CToolBarCtrl::InsertButton, CToolBarCtrl::DeleteButton, CToolBarCtrl::AddBitmap, CToolBarCtrl::AddString, CToolBarCtrl::AddStrings

Index