Partager via


Onglet (Contrôles Windows)

Cette section contient des informations sur les éléments de programmation utilisés avec les contrôles d’onglet.

Aperçus

Sujet Contenu
À propos des contrôles tabulation Un contrôle tabulation est analogue aux séparateurs d’un bloc-notes ou des étiquettes d’une armoire de fichiers. À l’aide d’un contrôle tabulation, une application peut définir plusieurs pages pour la même zone d’une fenêtre ou d’une boîte de dialogue.
à l’aide de contrôles tabulation Cette rubrique contient deux exemples qui utilisent des contrôles d’onglet.

Macros

Sujet Contenu
TabCtrl_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 spécifiée. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_ADJUSTRECT.
TabCtrl_DeleteAllItems Supprime tous les éléments d’un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_DELETEALLITEMS.
TabCtrl_DeleteItem Supprime un élément d’un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_DELETEITEM.
TabCtrl_DeselectAll Réinitialise les éléments d’un contrôle tabulation, ce qui a été défini sur l’état TCIS_BUTTONPRESSED. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_DESELECTALL.
TabCtrl_GetCurFocus Retourne l’index de l’élément qui a le focus dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETCURFOCUS.
TabCtrl_GetCurSel Détermine l’onglet actuellement sélectionné dans un contrôle Onglet. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETCURSEL.
TabCtrl_GetExtendedStyle Récupère les styles étendus actuellement utilisés pour le contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETEXTENDEDSTYLE.
TabCtrl_GetImageList Récupère la liste d’images associée à un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETIMAGELIST.
TabCtrl_GetItem Récupère des informations sur un onglet dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETITEM.
TabCtrl_GetItemCount Récupère le nombre d’onglets dans le contrôle Tab. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETITEMCOUNT.
TabCtrl_GetItemRect Récupère le rectangle englobant d’un onglet dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETITEMRECT.
TabCtrl_GetRowCount Récupère le nombre actuel de lignes d’onglets dans un contrôle Tab. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETROWCOUNT.
TabCtrl_GetToolTips Récupère le handle dans le contrôle d’info-bulle associé à un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETTOOLTIPS.
TabCtrl_GetUnicodeFormat Récupère l’indicateur de format de caractère UNICODE pour le contrôle. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETUNICODEFORMAT.
TabCtrl_HighlightItem Définit l’état de surbrillance d’un élément d’onglet. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_HIGHLIGHTITEM.
TabCtrl_HitTest Détermine l’onglet, le cas échéant, à une position d’écran spécifiée. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_HITTEST.
TabCtrl_InsertItem Insère un nouvel onglet dans un contrôle Tab. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_INSERTITEM.
TabCtrl_RemoveImage Supprime une image de la liste d’images d’un contrôle Tab. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_REMOVEIMAGE.
TabCtrl_SetCurFocus Définit le focus sur un onglet spécifié dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETCURFOCUS.
TabCtrl_SetCurSel Sélectionne un onglet dans un contrôle Onglet. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETCURSEL.
TabCtrl_SetExtendedStyle Définit les styles étendus que le contrôle tabulation utilisera. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETEXTENDEDSTYLE.
TabCtrl_SetImageList Affecte une liste d’images à un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETIMAGELIST.
TabCtrl_SetItem Définit certains ou tous les attributs d’un onglet. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETITEM.
TabCtrl_SetItemExtra Définit le nombre d’octets par onglet réservé aux données définies par l’application dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETITEMEXTRA.
TabCtrl_SetItemSize Définit la largeur et la hauteur des onglets dans un contrôle tabulation dessiné par le propriétaire ou à largeur fixe. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETITEMSIZE.
TabCtrl_SetMinTabWidth Définit la largeur minimale des éléments dans un contrôle Tab. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETMINTABWIDTH.
TabCtrl_SetPadding Définit la quantité d’espace (remplissage) autour de l’icône et de l’étiquette de chaque onglet dans un contrôle Tab. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETPADDING.
TabCtrl_SetToolTips Affecte un contrôle d’info-bulle à un contrôle Tab. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETTOOLTIPS.
TabCtrl_SetUnicodeFormat Définit l’indicateur de format de caractère Unicode pour le contrôle. Ce message vous permet de modifier le jeu de caractères utilisé par le contrôle au moment de l’exécution plutôt que de devoir recréer le contrôle. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_SETUNICODEFORMAT.

Messages

Sujet Contenu
TCM_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 spécifiée. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_AdjustRect.
TCM_DELETEALLITEMS Supprime tous les éléments d’un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_DeleteAllItems.
TCM_DELETEITEM Supprime un élément d’un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_DeleteItem.
TCM_DESELECTALL Réinitialise les éléments d’un contrôle tabulation, ce qui a été défini sur l’état TCIS_BUTTONPRESSED. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_DeselectAll.
TCM_GETCURFOCUS Retourne l’index de l’élément qui a le focus dans un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetCurFocus.
TCM_GETCURSEL Détermine l’onglet actuellement sélectionné dans un contrôle Onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetCurSel.
TCM_GETEXTENDEDSTYLE Récupère les styles étendus actuellement utilisés pour le contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetExtendedStyle.
TCM_GETIMAGELIST Récupère la liste d’images associée à un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetImageList.
TCM_GETITEM Récupère des informations sur un onglet dans un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetItem.
TCM_GETITEMCOUNT Récupère le nombre d’onglets dans le contrôle Tab. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetItemCount.
TCM_GETITEMRECT Récupère le rectangle englobant d’un onglet dans un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetItemRect.
TCM_GETROWCOUNT Récupère le nombre actuel de lignes d’onglets dans un contrôle Tab. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetRowCount.
TCM_GETTOOLTIPS Récupère le handle dans le contrôle d’info-bulle associé à un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetToolTips.
TCM_GETUNICODEFORMAT Récupère l’indicateur de format de caractère Unicode pour le contrôle. Vous pouvez envoyer ce message explicitement ou utiliser la macro TabCtrl_GetUnicodeFormat.
TCM_HIGHLIGHTITEM Définit l’état de surbrillance d’un élément d’onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_HighlightItem.
TCM_HITTEST Détermine l’onglet, le cas échéant, à une position d’écran spécifiée. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_HitTest.
TCM_INSERTITEM Insère un nouvel onglet dans un contrôle Tab. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_InsertItem.
TCM_REMOVEIMAGE Supprime une image de la liste d’images d’un contrôle Tab. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_RemoveImage.
TCM_SETCURFOCUS Définit le focus sur un onglet spécifié dans un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetCurFocus.
TCM_SETCURSEL Sélectionne un onglet dans un contrôle Onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetCurSel.
TCM_SETEXTENDEDSTYLE Définit les styles étendus que le contrôle tabulation utilisera. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetExtendedStyle.
TCM_SETIMAGELIST Affecte une liste d’images à un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetImageList.
TCM_SETITEM Définit certains ou tous les attributs d’un onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetItem.
TCM_SETITEMEXTRA Définit le nombre d’octets par onglet réservé aux données définies par l’application dans un contrôle tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetItemExtra.
TCM_SETITEMSIZE Définit la largeur et la hauteur des onglets dans un contrôle tabulation dessiné par le propriétaire ou à largeur fixe. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetItemSize.
TCM_SETMINTABWIDTH Définit la largeur minimale des éléments dans un contrôle Tab. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetMinTabWidth.
TCM_SETPADDING Définit la quantité d’espace (remplissage) autour de l’icône et de l’étiquette de chaque onglet dans un contrôle Tab. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetPadding.
TCM_SETTOOLTIPS Affecte un contrôle d’info-bulle à un contrôle Tab. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetToolTips.
TCM_SETUNICODEFORMAT Définit l’indicateur de format de caractère Unicode pour le contrôle. Ce message vous permet de modifier le jeu de caractères utilisé par le contrôle au moment de l’exécution plutôt que de devoir recréer le contrôle. Vous pouvez envoyer ce message explicitement ou utiliser la macro TabCtrl_SetUnicodeFormat.

Notifications

Sujet Contenu
NM_CLICK (onglet) Avertit la fenêtre parente d’un contrôle tabulation que l’utilisateur a cliqué sur le bouton gauche de la souris dans le contrôle. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY.
NM_DBLCLK (onglet) Avertit une fenêtre parente d’un contrôle Tab que l’utilisateur a double-cliqué sur le bouton gauche de la souris dans le contrôle. Cette notification est envoyée sous la forme d’un message WM_NOTIFY.
NM_RCLICK (onglet) Avertit la fenêtre parente d’un contrôle Tab que l’utilisateur a cliqué sur le bouton droit de la souris dans le contrôle. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY.
NM_RDBLCLK (onglet) Avertit la fenêtre parente d’un contrôle Tab que l’utilisateur a double-cliqué sur le bouton droit de la souris dans le contrôle. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY.
NM_RELEASEDCAPTURE (onglet) Avertit la fenêtre parente d’un contrôle Tab que le contrôle libère la capture de la souris. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY.
TCN_FOCUSCHANGE Avertit la fenêtre parente d’un contrôle Tab que le focus du bouton a changé. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY.
TCN_GETOBJECT Envoyé par un contrôle Tab lorsqu’il a le style étendu TCS_EX_REGISTERDROP et qu’un objet est déplacé sur un élément d’onglet dans le contrôle. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY.
TCN_KEYDOWN Avertit la fenêtre parente d’un contrôle Tab qu’une touche a été enfoncée. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY.
TCN_SELCHANGE Avertit la fenêtre parente d’un contrôle Tab que l’onglet actuellement sélectionné a changé. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY.
TCN_SELCHANGING Avertit la fenêtre parente d’un contrôle Tab que l’onglet actuellement sélectionné est sur le point de changer. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY.

Structures

Sujet Contenu
NMTCKEYDOWN Contient des informations sur une touche d’appui dans un contrôle Tab. Il est utilisé avec le code de notification TCN_KEYDOWN. Cette structure remplace la structure TC_KEYDOWN.
TCHITTESTINFO Contient des informations sur un test de positionnement. Cette structure remplace la structure TC_HITTESTINFO.
TCITEM Spécifie ou reçoit les attributs d’un élément d’onglet. Il est utilisé avec les messages TCM_INSERTITEM, TCM_GETITEMet TCM_SETITEM. Cette structure remplace la structure TC_ITEM.
TCITEMHEADER Spécifie ou reçoit les attributs d’un onglet. Il est utilisé avec les messages TCM_INSERTITEM, TCM_GETITEMet TCM_SETITEM. Cette structure remplace la structure TC_ITEMHEADER.

Constantes

Sujet Contenu
styles étendus de contrôle onglet Le contrôle tabulation prend désormais en charge les styles étendus. Ces styles sont manipulés à l’aide des messages TCM_GETEXTENDEDSTYLE et TCM_SETEXTENDEDSTYLE et ne doivent pas être confondus avec les styles de fenêtre étendus passés à CreateWindowEx.
États d’élément de contrôle tabulation Les éléments de contrôle tabulation prennent désormais en charge un état d’élément pour prendre en charge le message TCM_DESELECTALL. En outre, la structureTCITEMprend en charge les valeurs d’état d’élément.
Styles de contrôle tabulation Cette section répertorie les styles de contrôle d’onglet pris en charge.