La classe CTabCtrl

Fournit les fonctionnalités du contrôle commun d'onglet Windows.

Syntaxe

class CTabCtrl : public CWnd

Membres

Constructeurs publics

Nom	Description
CTabCtrl::CTabCtrl	Construit un objet CTabCtrl.

Méthodes publiques

Nom	Description
CTabCtrl::AdjustRect	Calcule la zone d’affichage d’un contrôle Tab en fonction d’un rectangle de fenêtre ou calcule le rectangle de fenêtre correspondant à une zone d’affichage donnée.
CTabCtrl::Create	Crée un contrôle Tab et l’attache à une instance d’un TabCtrl objet
CTabCtrl::CreateEx	Crée un contrôle tabulation avec les styles étendus Windows spécifiés et l’attache à une instance d’un CTabCtrl objet.
CTabCtrl::DeleteAllItems	Supprime tous les éléments d’un contrôle tabulation.
CTabCtrl::DeleteItem	Supprime un élément d’un contrôle tabulation.
CTabCtrl::DeselectAll	Réinitialise les éléments d’un contrôle tabulation, en désactivant ceux qui ont été appuyés.
CTabCtrl::DrawItem	Dessine un élément spécifié d’un contrôle Tab.
CTabCtrl::GetCurFocus	Récupère l’onglet avec le focus actuel d’un contrôle Tab.
CTabCtrl::GetCurSel	Détermine l’onglet actuellement sélectionné dans un contrôle Onglet.
CTabCtrl::GetExtendedStyle	Récupère les styles étendus actuellement utilisés pour le contrôle tabulation.
CTabCtrl::GetImageList	Récupère la liste d’images associée à un contrôle tabulation.
CTabCtrl::GetItem	Récupère des informations sur un onglet dans un contrôle tabulation.
CTabCtrl::GetItemCount	Récupère le nombre d’onglets dans le contrôle Tab.
CTabCtrl::GetItemRect	Récupère le rectangle englobant d’un onglet dans un contrôle tabulation.
CTabCtrl::GetItemState	Récupère l’état de l’élément de contrôle tabulation indiqué.
CTabCtrl::GetRowCount	Récupère le nombre actuel de lignes d’onglets dans un contrôle Tab.
CTabCtrl::GetToolTips	Récupère le handle du contrôle info-bulle associé à un contrôle Tab.
CTabCtrl::HighlightItem	Définit l’état de surbrillance d’un élément d’onglet.
CTabCtrl::HitTest	Détermine l’onglet, le cas échéant, à une position d’écran spécifiée.
CTabCtrl::InsertItem	Insère un nouvel onglet dans un contrôle Tab.
CTabCtrl::RemoveImage	Supprime une image de la liste d’images d’un contrôle Tab.
CTabCtrl::SetCurFocus	Définit le focus sur un onglet spécifié dans un contrôle tabulation.
CTabCtrl::SetCurSel	Sélectionne un onglet dans un contrôle Onglet.
CTabCtrl::SetExtendedStyle	Définit les styles étendus d’un contrôle tabulation.
CTabCtrl::SetImageList	Affecte une liste d’images à un contrôle tabulation.
CTabCtrl::SetItem	Définit certains ou tous les attributs d’un onglet.
CTabCtrl::SetItemExtra	Définit le nombre d’octets par onglet réservé aux données définies par l’application dans un contrôle tabulation.
CTabCtrl::SetItemSize	Définit la largeur et la hauteur d’un élément.
CTabCtrl::SetItemState	Définit l’état de l’élément de contrôle tabulation indiqué.
CTabCtrl::SetMinTabWidth	Définit la largeur minimale des éléments dans un contrôle Tab.
CTabCtrl::SetPadding	Définit la quantité d’espace (remplissage) autour de chaque icône onglets et étiquette dans un contrôle Tab.
CTabCtrl::SetToolTips	Affecte un contrôle info-bulle à un contrôle Tab.

Notes

Un « contrôle tabulation » est analogue aux séparateurs d’un bloc-notes ou des étiquettes d’une armoire de fichiers. En utilisant un contrôle tab, une application peut définir plusieurs pages pour la même zone d’une fenêtre ou d’une boîte de dialogue. Chaque page se compose d’un ensemble d’informations ou d’un groupe de contrôles que l’application affiche lorsque l’utilisateur sélectionne l’onglet correspondant. Un type spécial de contrôle tabulation affiche des onglets qui ressemblent à des boutons. Cliquer sur un bouton doit immédiatement exécuter une commande au lieu d’afficher une page.

Ce contrôle (et par conséquent la CTabCtrl classe) est disponible uniquement pour les programmes exécutés sous Windows 95/98 et Windows NT version 3.51 et ultérieure.

Pour plus d’informations sur CTabCtrl, consultez Contrôles et utilisation CTabCtrl.

Hiérarchie d’héritage

CObject
CCmdTarget
CWnd

CTabCtrl

Spécifications

En-tête : afxcmn.h

CTabCtrl::AdjustRect

Calcule la zone d’affichage d’un contrôle Tab en fonction d’un rectangle de fenêtre ou calcule le rectangle de fenêtre correspondant à une zone d’affichage donnée.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Paramètres

bLarger
Indique l’opération à effectuer. Si ce paramètre est TRUE, lpRect spécifie un rectangle d’affichage et reçoit le rectangle de fenêtre correspondant. Si ce paramètre est FALSE, lpRect spécifie un rectangle de fenêtre et reçoit le rectangle d’affichage correspondant.

lpRect
Pointeur vers une RECT structure qui spécifie le rectangle donné et reçoit le rectangle calculé.

Exemple

void CTabDlg::OnSize(UINT nType, int cx, int cy)
{
   CDialog::OnSize(nType, cx, cy);

   if (m_TabCtrl.m_hWnd == NULL)
      return; // Return if window is not created yet.

   RECT rect;

   // Get size of dialog window.
   GetClientRect(&rect);

   // Adjust the rectangle to fit the tab control into the
   // dialog's client rectangle.
   m_TabCtrl.AdjustRect(FALSE, &rect);

   // Move the tab control to the new position and size.
   m_TabCtrl.MoveWindow(&rect, TRUE);
}

CTabCtrl::Create

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

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

Paramètres

dwStyle
Spécifie le style du contrôle Tab. Appliquez n’importe quelle combinaison de styles de contrôle tabulation, décrite dans le Kit de développement logiciel (SDK) Windows. Consultez les remarques pour obtenir la liste des styles de fenêtre que vous pouvez également appliquer au contrôle.

rect
Spécifie la taille et la position du contrôle Tab. Il peut s’agir d’un objet ou d’une CRect RECT structure.

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

nID
Spécifie l’ID du contrôle Tab.

Valeur de retour

TRUE si l’initialisation de l’objet a réussi ; sinon FALSE.

Notes

Vous construisez un CTabCtrl objet en deux étapes. Tout d’abord, appelez le constructeur, puis appelez Create, qui crée le contrôle Tab et l’attache à l’objet CTabCtrl .

En plus des styles de contrôle tabulation, vous pouvez appliquer les styles de fenêtre suivants à un contrôle tabulation :

• WS_CHILD: crée une fenêtre enfant qui représente le contrôle Tab. Impossible d’utiliser le style WS_POPUP.
• WS_VISIBLE: crée un contrôle Tab qui est initialement visible.
• WS_DISABLED: crée une fenêtre initialement désactivée.
• WS_GROUP: spécifie le premier contrôle d’un groupe de contrôles dans lequel l’utilisateur peut passer d’un contrôle à l’autre avec les touches de direction. Tous les contrôles définis avec le WS_GROUPstyle : après le premier contrôle appartiennent au même groupe. Le contrôle suivant avec le WS_GROUPstyle : met fin au groupe de styles et démarre le groupe suivant (autrement dit, un groupe se termine où commence le suivant).
• WS_TABSTOP: spécifie l’un des contrôles à travers lesquels l’utilisateur peut se déplacer à l’aide de la touche TAB. La touche TAB déplace l’utilisateur vers le contrôle suivant spécifié par le WS_TABSTOPstyle :

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

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.

CTabCtrl::CreateEx

Crée un contrôle (fenêtre enfant) et l’associe à l’objet CTabCtrl .

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

Paramètres

dwExStyle
Spécifie le style étendu du contrôle en cours de création. Pour obtenir la liste des styles Windows étendus, consultez le dwExStyle paramètre correspondant CreateWindowEx dans le Kit de développement logiciel (SDK) Windows.

dwStyle
Spécifie le style du contrôle Tab. Appliquez n’importe quelle combinaison de styles de contrôle tabulation, décrite dans le Kit de développement logiciel (SDK) Windows. Consultez les remarques dans Create la liste des styles de fenêtre que vous pouvez également appliquer au contrôle.

rect
Référence à une RECT structure décrivant la taille et la position de la fenêtre à créer, dans les coordonnées clientes de pParentWnd.

pParentWnd
Pointeur vers la fenêtre qui est le parent du contrôle.

nID
ID de la fenêtre enfant du contrôle.

Valeur de retour

Différent de zéro s’il réussit sinon 0.

Notes

Utilisez CreateEx plutôt que d’appliquer Create des styles Windows étendus, spécifiés par le préface WS_EX_de style étendu Windows.

CreateEx crée le contrôle avec les styles Windows étendus spécifiés par dwExStyle. Définissez des styles étendus spécifiques à un contrôle à l’aide SetExtendedStylede . Par exemple, utilisez CreateEx pour définir des styles tels que WS_EX_CONTEXTHELP, mais utilisez SetExtendedStyle pour définir des styles tels que TCS_EX_FLATSEPARATORS. Pour plus d’informations, consultez les styles décrits dans Les styles étendus du contrôle tabulation dans le Kit de développement logiciel (SDK) Windows.

CTabCtrl::CTabCtrl

Construit un objet CTabCtrl.

CTabCtrl();

CTabCtrl::DeleteAllItems

Supprime tous les éléments d’un contrôle tabulation.

BOOL DeleteAllItems();

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

CTabCtrl::DeleteItem

Supprime l’élément spécifié d’un contrôle tabulation.

BOOL DeleteItem(int nItem);

Paramètres

nItem
Valeur de base zéro de l’élément à supprimer.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Exemple

// This example assumes that there is a CTabCtrl member of the
// CTabDlg class named m_TabCtrl.  On a button handler
// called OnDeleteItem of the dialog box the tab control will
// delete the 0 indexed item.

void CTabDlg::OnDeleteItem()
{
   // Delete the first item in the tab control.
   m_TabCtrl.DeleteItem(0);
}

CTabCtrl::DeselectAll

Réinitialise les éléments d’un contrôle tabulation, en désactivant ceux qui ont été appuyés.

void DeselectAll(BOOL fExcludeFocus);

Paramètres

fExcludeFocus
Indicateur qui spécifie l’étendue de la désélection d’élément. Si ce paramètre est défini FALSEsur , tous les boutons d’onglet sont réinitialisés. S’il est défini TRUEsur , tous les éléments de tabulation à l’exception de celui actuellement sélectionné sont réinitialisés.

Notes

Cette fonction membre implémente le comportement du message Win32, TCM_DESELECTALLcomme décrit dans le Kit de développement logiciel (SDK) Windows.

CTabCtrl::DrawItem

Appelé par l’infrastructure lorsqu’un aspect visuel d’un contrôle d’onglet de dessin propriétaire change.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Paramètres

lpDrawItemStruct
Pointeur vers une DRAWITEMSTRUCT structure décrivant l’élément à peindre.

Notes

Le itemAction membre de la DRAWITEMSTRUCT structure définit l’action de dessin à effectuer.

Par défaut, cette fonction membre ne fait rien. Remplacez cette fonction membre pour implémenter le dessin pour un objet de dessin CTabCtrl propriétaire.

L’application doit restaurer tous les objets GDI (Graphics Device Interface) sélectionnés pour le contexte d’affichage fourni lpDrawItemStruct avant la fin de cette fonction membre.

CTabCtrl::GetCurFocus

Récupère l’index de l’onglet avec le focus actuel.

int GetCurFocus() const;

Valeur de retour

Index de base zéro de l’onglet avec le focus actuel.

CTabCtrl::GetCurSel

Récupère l’onglet actuellement sélectionné dans un contrôle tabulation.

int GetCurSel() const;

Valeur de retour

Index de base zéro de l’onglet sélectionné en cas de réussite ou -1 si aucun onglet n’est sélectionné.

CTabCtrl::GetExtendedStyle

Récupère les styles étendus actuellement utilisés pour le contrôle tabulation.

DWORD GetExtendedStyle();

Valeur de retour

Représente les styles étendus actuellement utilisés pour le contrôle tabulation. Cette valeur est une combinaison de styles étendus de contrôle tabulation, comme décrit dans le Kit de développement logiciel (SDK) Windows.

Notes

Cette fonction membre implémente le comportement du message TCM_GETEXTENDEDSTYLE Win32, comme décrit dans le SDK Windows.

CTabCtrl::GetImageList

Récupère la liste d’images associée à un contrôle tabulation.

CImageList* GetImageList() const;

Valeur de retour

En cas de réussite, un pointeur vers la liste d’images du contrôle tabulation ; sinon, NULL.

CTabCtrl::GetItem

Récupère des informations sur un onglet dans un contrôle tabulation.

BOOL GetItem(int nItem,   TCITEM* pTabCtrlItem) const;

Paramètres

nItem
Index de base zéro de l’onglet.

pTabCtrlItem
Pointeur vers une TCITEM structure, utilisé pour spécifier les informations à récupérer. Également utilisé pour recevoir des informations sur l’onglet. Cette structure est utilisée avec les fonctions membres, GetItemet SetItem les InsertItemfonctions membres.

Valeur de retour

Retourne TRUE si elle réussit ; FALSE sinon.

Notes

Lorsque le message est envoyé, le mask membre spécifie les attributs à retourner. Si le mask membre spécifie la TCIF_TEXT valeur, le pszText membre doit contenir l’adresse de la mémoire tampon qui reçoit le texte de l’élément et le cchTextMax membre doit spécifier la taille de la mémoire tampon.

• mask

  Valeur spécifiant les TCITEM membres de structure à récupérer ou définir. Ce membre peut être égal à zéro ou à une combinaison des valeurs suivantes :

  • TCIF_TEXT: le pszText membre est valide.
  • TCIF_IMAGE: le iImage membre est valide.
  • TCIF_PARAM: le lParam membre est valide.
  • TCIF_RTLREADING: le texte de l’objet est affiché à l’aide de l’ordre de pszText lecture de droite à gauche sur les systèmes hébreu ou arabe.
  • TCIF_STATE: le dwState membre est valide.

• pszText

  Pointeur vers une chaîne terminée par null contenant le texte de l’onglet si la structure contient des informations sur un onglet. Si la structure reçoit des informations, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte de l’onglet.

• cchTextMax

  Taille de la mémoire tampon pointée par pszText. Ce membre est ignoré si la structure ne reçoit pas d’informations.

• iImage Indexez la liste d’images du contrôle Tab ou -1 s’il n’existe aucune image pour l’onglet.

• lParam

  Données définies par l’application associées à l’onglet. S’il y a plus de 4 octets de données définies par application par onglet, une application doit définir une structure et l’utiliser au lieu de la TCITEM structure. Le premier membre de la structure définie par l’application doit être une TCITEMHEADERstructure. La TCITEMHEADER structure est identique à la TCITEM structure, mais sans le lParam membre. La différence entre la taille de votre structure et la taille de la TCITEMHEADER structure doit être égale au nombre d’octets supplémentaires par onglet.

Exemple

// In this example a CTabCtrl data member, m_TabCtrl, changes the
// text of the tabs in the tab control.  A call to GetItem is used
// to get the current text, and then the text is changed.  A call
// to SetItem is used to update the tab with the new text.

void CTabDlg::OnChangeItem()
{
   TCITEM tcItem;
   CString pszString;

   //  Get text for the tab item.
   GetDlgItemText(IDC_ITEM_TEXT, pszString);

   //  Get the current tab item text.
   TCHAR buffer[256] = {0};
   tcItem.pszText = buffer;
   tcItem.cchTextMax = 256;
   tcItem.mask = TCIF_TEXT;
   m_TabCtrl.GetItem(0, &tcItem);
   TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);

   //  Set the new text for the item.
   tcItem.pszText = pszString.LockBuffer();

   //  Set the item in the tab control.
   m_TabCtrl.SetItem(0, &tcItem);

   pszString.UnlockBuffer();
}

CTabCtrl::GetItemCount

Récupère le nombre d’onglets dans le contrôle Tab.

int GetItemCount() const;

Valeur de retour

Nombre d’éléments dans le contrôle Tab.

Exemple

Consultez l’exemple pour CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Récupère le rectangle englobant de l’onglet spécifié dans un contrôle tabulation.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Paramètres

nItem
Index de base zéro de l’élément de tabulation.

lpRect
Pointeur vers une RECT structure qui reçoit le rectangle englobant de l’onglet. Ces coordonnées utilisent le mode de mappage actuel de la fenêtre d’affichage.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Exemple

Consultez l’exemple pour CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Récupère l’état de l’élément de contrôle Tab identifié par nItem.

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Paramètres

nItem
Numéro d’index de base zéro de l’élément pour lequel récupérer les informations d’état.

dwMask
Masque spécifiant les indicateurs d’état de l’élément à retourner. Pour obtenir la liste des valeurs, consultez le membre de masque de la TCITEM structure, comme décrit dans le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Référence à une valeur DWORD qui reçoit les informations d’état. Peut avoir l’une des valeurs suivantes :

Valeur	Description
TCIS_BUTTONPRESSED	L’élément de contrôle tabulation est sélectionné.
TCIS_HIGHLIGHTED	L’élément de contrôle Tab est mis en surbrillance, et l’onglet et le texte sont dessinés à l’aide de la couleur de surbrillance actuelle. Lorsque vous utilisez la couleur de surbrillance, il s’agit d’une interpolation réelle, et non d’une couleur de trame.

Notes

L’état d’un élément est spécifié par le dwState membre de la TCITEM structure.

CTabCtrl::GetRowCount

Récupère le nombre actuel de lignes d’un contrôle tabulation.

int GetRowCount() const;

Valeur de retour

Nombre de lignes d’onglets dans le contrôle Tab.

Notes

Seuls les contrôles tabulation qui ont le TCS_MULTILINE style peuvent avoir plusieurs lignes d’onglets.

CTabCtrl::GetToolTips

Récupère le handle du contrôle info-bulle associé à un contrôle Tab.

CToolTipCtrl* GetToolTips() const;

Valeur de retour

Gérer le contrôle d’info-bulle en cas de réussite ; sinon NULL.

Notes

Un contrôle tabulation crée un contrôle d’info-bulle s’il a le TCS_TOOLTIPS style. Vous pouvez également affecter un contrôle info-bulle à un contrôle tabulation à l’aide de la SetToolTips fonction membre.

CTabCtrl::HighlightItem

Définit l’état de surbrillance d’un élément d’onglet.

BOOL HighlightItem(int idItem,  BOOL fHighlight = TRUE);

Paramètres

idItem
Index de base zéro d’un élément de contrôle tabulation.

fHighlight
Valeur spécifiant l’état de surbrillance à définir. Si cette valeur est TRUE, l’onglet est mis en surbrillance ; si FALSE, l’onglet est défini sur son état par défaut.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

Notes

Cette fonction membre implémente le message TCM_HIGHLIGHTITEMWin32, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CTabCtrl::HitTest

Détermine l’onglet, le cas échéant, à la position d’écran spécifiée.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Paramètres

pHitTestInfo
Pointeur vers une TCHITTESTINFO structure, comme décrit dans le Kit de développement logiciel (SDK) Windows, qui spécifie la position de l’écran à tester.

Valeur de retour

Retourne l’index de base zéro de l’onglet ou -1 si aucun onglet n’est à la position spécifiée.

CTabCtrl::InsertItem

Insère un nouvel onglet dans un contrôle tabulation existant.

LONG InsertItem(
    int nItem,
    TCITEM* pTabCtrlItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam,
    DWORD dwState,
    DWORD dwStateMask);

Paramètres

nItem
Index de base zéro du nouvel onglet.

pTabCtrlItem
Pointeur vers une TCITEM structure qui spécifie les attributs de l’onglet.

lpszItem
Adresse d’une chaîne terminée par null qui contient le texte de l’onglet.

nImage
Index de base zéro d’une image à insérer à partir d’une liste d’images.

nMask
Spécifie les attributs TCITEM de structure à définir. Il peut s’agir de zéro ou d’une combinaison des valeurs suivantes :

• TCIF_TEXT: le pszText membre est valide.
• TCIF_IMAGE: le iImage membre est valide.
• TCIF_PARAM: le lParam membre est valide.
• TCIF_RTLREADING: le texte de l’objet est affiché à l’aide de l’ordre de pszText lecture de droite à gauche sur les systèmes hébreu ou arabe.
• TCIF_STATE: le dwState membre est valide.

lParam
Données définies par l’application associées à l’onglet.

dwState
Spécifie les valeurs des états de l’élément. Pour plus d’informations, consultez TCITEM le Kit de développement logiciel (SDK) Windows.

dwStateMask
Spécifie les états à définir. Pour plus d’informations, consultez TCITEM le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Index de base zéro du nouvel onglet en cas de réussite ; sinon -1.

Exemple

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Supprime l’image spécifiée de la liste d’images d’un contrôle Tab.

void RemoveImage(int nImage);

Paramètres

nImage
Index de base zéro de l’image à supprimer.

Notes

Le contrôle tabulation met à jour l’index d’image de chaque onglet afin que chaque onglet reste associé à la même image.

CTabCtrl::SetCurFocus

Définit le focus sur un onglet spécifié dans un contrôle tabulation.

void SetCurFocus(int nItem);

Paramètres

nItem
Spécifie l’index de l’onglet qui obtient le focus.

Notes

Cette fonction membre implémente le comportement du message TCM_SETCURFOCUS Win32, comme décrit dans le SDK Windows.

CTabCtrl::SetCurSel

Sélectionne un onglet dans un contrôle Onglet.

int SetCurSel(int nItem);

Paramètres

nItem
Index de base zéro de l’élément à sélectionner.

Valeur de retour

Index de base zéro de l’onglet sélectionné précédemment en cas de réussite, sinon -1.

Notes

Un contrôle Tab n’envoie pas de TCN_SELCHANGING message ou TCN_SELCHANGE de notification lorsqu’un onglet est sélectionné à l’aide de cette fonction. Ces notifications sont envoyées, en utilisant WM_NOTIFY, lorsque l’utilisateur clique ou utilise le clavier pour modifier les onglets.

CTabCtrl::SetExtendedStyle

Définit les styles étendus d’un contrôle tabulation.

DWORD SetExtendedStyle(DWORD dwNewStyle, DWORD dwExMask = 0);

Paramètres

dwNewStyle
Valeur spécifiant une combinaison de styles étendus de contrôle tabulation.

dwExMask
Valeur DWORD qui indique quels styles doivent dwNewStyle être affectés. Seuls les styles étendus dans dwExMask devront être modifiés. Tous les autres styles seront conservés comme c’est le cas. Si ce paramètre est égal à zéro, tous les styles dans dwNewStyle devront être affectés.

Valeur de retour

Valeur DWORD qui contient les styles étendus de contrôle d’onglet précédents, comme décrit dans le Kit de développement logiciel (SDK) Windows.

Notes

Cette fonction membre implémente le comportement du message TCM_SETEXTENDEDSTYLE Win32, comme décrit dans le SDK Windows.

CTabCtrl::SetImageList

Affecte une liste d’images à un contrôle tabulation.

CImageList* SetImageList(CImageList* pImageList);

Paramètres

pImageList
Pointeur vers la liste d’images à affecter au contrôle tabulation.

Valeur de retour

Retourne un pointeur vers la liste d’images précédente ou NULL s’il n’existe aucune liste d’images précédente.

CTabCtrl::SetItem

Définit certains ou tous les attributs d’un onglet.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Paramètres

nItem
Index de base zéro de l’élément.

pTabCtrlItem
Pointeur vers une TCITEM structure qui contient les nouveaux attributs d’élément. Le mask membre spécifie les attributs à définir. Si le mask membre spécifie la TCIF_TEXT valeur, le pszText membre est l’adresse d’une chaîne terminée par null et le cchTextMax membre est ignoré.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Exemple

Consultez l’exemple pour GetItem.

CTabCtrl::SetItemExtra

Définit le nombre d’octets par onglet réservé aux données définies par l’application dans un contrôle tabulation.

BOOL SetItemExtra(int nBytes);

Paramètres

nBytes
Nombre d’octets supplémentaires à définir.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

Notes

Cette fonction membre implémente le comportement du message TCM_SETITEMEXTRA Win32, comme décrit dans le SDK Windows.

CTabCtrl::SetItemSize

Définit la largeur et la hauteur des éléments du contrôle des tabulations.

CSize SetItemSize(CSize size);

Paramètres

size
Nouvelles largeur et hauteur, en pixels, des éléments du contrôle des tabulations.

Valeur de retour

Retourne les anciennes largeur et hauteur des éléments du contrôle des tabulations.

CTabCtrl::SetItemState

Définit l’état de l’élément de contrôle Tab identifié par nItem.

BOOL SetItemState(
    int nItem,
    DWORD dwMask,
    DWORD dwState);

Paramètres

nItem
Numéro d’index de base zéro de l’élément pour lequel définir les informations d’état.

dwMask
Masque spécifiant les indicateurs d’état de l’élément à définir. Pour obtenir la liste des valeurs, consultez le membre de masque de la TCITEM structure, comme décrit dans le Kit de développement logiciel (SDK) Windows.

dwState
Référence à une valeur DWORD contenant les informations d’état. Peut avoir l’une des valeurs suivantes :

Valeur	Description
TCIS_BUTTONPRESSED	L’élément de contrôle tabulation est sélectionné.
TCIS_HIGHLIGHTED	L’élément de contrôle Tab est mis en surbrillance, et l’onglet et le texte sont dessinés à l’aide de la couleur de surbrillance actuelle. Lorsque vous utilisez la couleur de surbrillance, il s’agit d’une interpolation réelle, et non d’une couleur de trame.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

CTabCtrl::SetMinTabWidth

Définit la largeur minimale des éléments dans un contrôle Tab.

int SetMinTabWidth(int cx);

Paramètres

cx
Largeur minimale à définir pour un élément de contrôle Tab. Si ce paramètre est défini sur -1, le contrôle utilise la largeur de tabulation par défaut.

Valeur de retour

Largeur minimale précédente de l’onglet.

Notes

Cette fonction membre implémente le comportement du message TCM_SETMINTABWIDTH Win32, comme décrit dans le SDK Windows.

CTabCtrl::SetPadding

Définit la quantité d’espace (remplissage) autour de l’icône et de l’étiquette de chaque onglet dans un contrôle Onglet.

void SetPadding(CSize size);

Paramètres

size
Définit la quantité d’espace (remplissage) autour de l’icône et de l’étiquette de chaque onglet dans un contrôle Onglet.

CTabCtrl::SetToolTips

Affecte un contrôle info-bulle à un contrôle Tab.

void SetToolTips(CToolTipCtrl* pWndTip);

Paramètres

pWndTip
Handle of the tool tip control.

Notes

Vous pouvez obtenir le contrôle info-bulle associé à un contrôle tabulation en effectuant un appel à GetToolTips.

Exemple

Consultez l’exemple pour CPropertySheet::GetTabControl.

Voir aussi

CWnd Classe
CHeaderCtrl Classe
CListCtrl Classe
Graphique hiérarchique