Partager via


CTabCtrl::Create

Crée un contrôle onglet et l'attache à une instance d'un objet d' CTabCtrl .

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

Paramètres

  • dwStyle
    Spécifie le style du contrôle onglet. Appliquez une combinaison de styles de contrôle tab, décrite dans Kit de développement logiciel Windows. Consultez Notes pour obtenir une liste de styles de fenêtre que vous pouvez également appliquer au contrôle.

  • rect
    Spécifie la taille et la position du contrôle onglet. Ce peut être un objet de CRect ou une structure de RECT .

  • pParentWnd
    Spécifie la fenêtre parente du contrôle onglet, généralement CDialog. Il ne doit pas être NULL.

  • nID
    Spécifie l'ID du contrôle onglet

Valeur de retour

TRUE si l'initialisation de l'objet a abouti ; sinon FALSE.

Notes

Vous construisez un objet d' CTabCtrl en deux étapes. D'abord, appelez le constructeur, puis appelez Créer, qui crée le contrôle onglet et l'attache à l'objet d' CTabCtrl .

Outre les styles de contrôle onglet, vous pouvez appliquer des styles de fenêtre suivants à un contrôle onglet :

  • WS_CHILD crée une fenêtre enfant qui représente le contrôle onglet. Ne peut pas être utilisé avec le style d' WS_POPUP .

  • WS_VISIBLE crée un contrôle onglet qui est initialement visible.

  • WS_DISABLED crée une fenêtre qui est initialement désactivée.

  • WS_GROUP spécifie le premier contrôle d'un groupe de contrôles dans lesquels l'utilisateur peut déplacer d'un contrôle à l'autre avec les touches de direction. Tout contrôle défini avec le style de WS_GROUP après le premier contrôle appartiennent au même groupe. Le contrôle suivant avec le style de WS_GROUP termine le groupe de style et met démarrer le groupe (autrement dit, termine une de groupe où le prochain démarrage).

  • WS_TABSTOP spécifie un d'un certain nombre de contrôles dans lesquels l'utilisateur peut déplacer à l'aide de la touche TAB. La touche TAB déplace l'utilisateur au contrôle suivant spécifié par le style de WS_TABSTOP .

Pour créer un contrôle onglet avec des styles de fenêtre étendus, appelez CTabCtrl::CreateEx au lieu de Créer.

Exemple

// 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.

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CTabCtrl, classe

Graphique de la hiérarchie

CTabCtrl::CTabCtrl