Freigeben über


CTabCtrl::Create

Erstellt ein Tab-Steuerelement und fügt es einer Instanz eines Objekts CTabCtrl an.

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

Parameter

  • dwStyle
    Gibt das Format des Tab-Steuerelements an. Wenden Sie jede Kombination von Tab-Steuerelement-Formate beschrieben, in Windows SDK. Siehe Remarks für eine Liste von Fensterstilen, die Sie auf das Steuerelement auch anwenden können.

  • rect
    Gibt des die Größe und Position Tab-Steuerelements an. Sie kann ein CRect-Objekt oder eine Struktur RECT sein.

  • pParentWnd
    Gibt das übergeordnete Fenster des Tab-Steuerelements, normalerweise CDialog an. Er darf nicht NULL sein.

  • nID
    Gibt die ID des Tab-Steuerelements an

Rückgabewert

TRUE, wenn Initialisierung des Objekts erfolgreich war; andernfalls FALSE.

Hinweise

Sie erstellen ein CTabCtrl-Objekt in zwei Schritten. Zuerst rufen Sie den Konstruktor, und rufen Sie dann Create auf, der das Tab-Steuerelement erstellt und auf CTabCtrl-Objekt angefügt werden.

Zusätzlich zu den Tab-Steuerelement-Formaten können Sie die folgenden Fensterstile auf ein Tab-Steuerelement gelten:

  • WS_CHILD stellt ein untergeordnetes Fenster erstellt, das das Tab-Steuerelement darstellt. Kann nicht mit dem WS_POPUP Format verwendet werden.

  • WS_VISIBLE erstellt ein Tab-Steuerelement, das zuerst sichtbar ist.

  • WS_DISABLED wird ein Fenster erstellt, das zuerst deaktiviert ist.

  • WS_GROUP gibt das erste Steuerelement einer Gruppe von Steuerelementen an, in denen der Benutzer von einem Steuerelement zum nächsten mit den Pfeiltasten verschieben kann. Alle Steuerelemente, die mit dem WS_GROUP Format nach dem ersten - Steuerelement definiert werden, gehören derselben Gruppe. Das folgende - Steuerelement mit dem WS_GROUP Format beendet die Formatgruppe und beginnt die folgende Gruppe (das heißt, beendet eine Gruppe, wo das folgende beginnt).

  • WS_TABSTOP gibt ein beliebig vielen Steuerelementen an, durch die der Benutzer wechseln kann, indem er die TAB-TASTE verwendet. Mit der TAB-TASTE verschieben den Benutzer auf das nächste Steuerelement, das vom WS_TABSTOP Format angegeben wird.

Um ein Tab-Steuerelement mit erweiterten Fensterstilen zu erstellen, rufen Sie CTabCtrl::CreateEx anstelle Create auf.

Beispiel

// Assuming you have a member variable m_TabCtrl, that is a CTabCtrl 
// object, you can use the following to create a tab control.

m_TabCtrl.Create(TCS_TABS | TCS_FIXEDWIDTH | WS_CHILD | WS_VISIBLE,
   rect, this, IDC_MYTAB);

// This creates a tab control with the given styles, and with 
// an ID of IDC_MYTAB.

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CTabCtrl-Klasse

Hierarchiediagramm

CTabCtrl::CTabCtrl