CToolBarCtrl::Create

Artikel
02/26/2013

Erstellt ein ToolBar-Steuerelement und fügt es zu einem CToolBarCtrl-Objekt.

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

Parameter

dwStyle
Gibt das Format des Symbolleisten-Steuerelements an.Symbolleisten müssen das WS_CHILD Format immer haben.Außerdem kann jede Kombination von Symbolleistenformaten und -Fensterstilen angeben, wie unter Remarks beschrieben.
rect
Gibt optional des die Größe und die Position Symbolleisten-Steuerelements an.Sie kann ein CRect-Objekt oder eine Struktur RECT sein.
pParentWnd
Gibt das übergeordnete Fenster des Symbolleisten-Steuerelements an.Er darf nicht NULL sein.
nID
Gibt die ID des Symbolleisten-Steuerelements an

Rückgabewert

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

Hinweise

Sie erstellen CToolBarCtrl in zwei Schritten.Zuerst rufen Sie den Konstruktor, und rufen Sie dann Create auf, der das ToolBar-Steuerelement erstellt und auf CToolBarCtrl-Objekt angefügt werden.Wenden Sie die folgenden Fensterstile auf ein ToolBar-Steuerelement zu.

WS_CHILD immer
WS_VISIBLE normalerweise
WS_DISABLED selten

Siehe CreateWindow in Windows SDK für eine Beschreibung der Fensterstilen.

Optional wenden Sie eine Kombination von Formate für allgemeine Steuerelemente, wie in Windows SDK beschrieben.

Wenden Sie eine Kombination von Symbolleistenformaten entweder auf das Steuerelement oder die Schaltflächen selbst zu.Die Stile werden im Thema Symbolleisten-Steuerelement- und Schaltflächen-Formate in Windows SDK beschrieben.

Um erweiterte Symbolleistenformate zu verwenden, rufen Sie auf SetExtendedStyle nachdem Sie Create aufrufen.Um eine Symbolleiste mit erweiterten Fensterstilen zu erstellen, rufen Sie CToolBarCtrl::CreateEx anstelle Create auf.

Das ToolBar-Steuerelement legt automatisch die Größe und die Position des Symbolleistenfensters fest.Die Höhe basiert auf die Höhe der Schaltflächen in der Symbolleiste auf.Die Breite entspricht der Breite des Clientbereichs des übergeordneten Fensters.Die CCS_TOP und CCS_BOTTOM Stile bestimmen, ob die Symbolleiste an den oberen oder unteren Rand des Clientbereichs positioniert wird.Standardmäßig hat eine Symbolleiste das CCS_TOP Format.