Onglet (Contrôles Windows)

  • Article

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

Vues d'ensemble

Rubrique Contenu
À propos des contrôles Tab Un contrôle tab équivaut aux intercalaires dans un classeur ou aux étiquettes dans une armoire de classement. 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.
Utilisation de contrôles Tab Cette rubrique contient deux exemples qui utilisent des contrôles d’onglet.

Macros

Rubrique Contenu
TabCtrl_AdjustRect Calcule la zone d’affichage d’un contrôle tabulation en fonction d’un rectangle de fenêtre, ou calcule le rectangle de fenêtre qui correspondrait à une zone d’affichage spécifiée. Vous pouvez utiliser cette macro ou envoyer le message TCM_ADJUSTRECT explicitement.
TabCtrl_DeleteAllItems Supprime tous les éléments d’un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_DELETEALLITEMS explicitement.
TabCtrl_DeleteItem Supprime un élément d’un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_DELETEITEM explicitement.
TabCtrl_DeselectAll Réinitialise les éléments d’un contrôle tabulation, en effaçant tous ceux qui ont été définis sur l’état TCIS_BUTTONPRESSED . Vous pouvez utiliser cette macro ou envoyer le message TCM_DESELECTALL explicitement.
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 le message TCM_GETCURFOCUS explicitement.
TabCtrl_GetCurSel Détermine l’onglet actuellement sélectionné dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_GETCURSEL explicitement.
TabCtrl_GetExtendedStyle Récupère les styles étendus actuellement utilisés pour le contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_GETEXTENDEDSTYLE explicitement.
TabCtrl_GetImageList Récupère la liste d’images associée à un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_GETIMAGELIST explicitement.
TabCtrl_GetItem Récupère des informations sur un onglet dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_GETITEM explicitement.
TabCtrl_GetItemCount Récupère le nombre d’onglets dans le contrôle Tab. Vous pouvez utiliser cette macro ou envoyer le message TCM_GETITEMCOUNT explicitement.
TabCtrl_GetItemRect Récupère le rectangle englobant d’un onglet dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_GETITEMRECT explicitement.
TabCtrl_GetRowCount Récupère le nombre actuel de lignes d’onglets dans un contrôle Tab. Vous pouvez utiliser cette macro ou envoyer le message TCM_GETROWCOUNT explicitement.
TabCtrl_GetToolTips Récupère le handle du contrôle d’info-bulle associé à un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_GETTOOLTIPS explicitement.
TabCtrl_GetUnicodeFormat Récupère l’indicateur de format de caractères UNICODE pour le contrôle. Vous pouvez utiliser cette macro ou envoyer le message TCM_GETUNICODEFORMAT explicitement.
TabCtrl_HighlightItem Définit l’état de surbrillance d’un élément de tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_HIGHLIGHTITEM explicitement.
TabCtrl_HitTest Détermine quel onglet, le cas échéant, se trouve à une position d’écran spécifiée. Vous pouvez utiliser cette macro ou envoyer le message TCM_HITTEST explicitement.
TabCtrl_InsertItem Insère un nouvel onglet dans un contrôle tab. Vous pouvez utiliser cette macro ou envoyer le message TCM_INSERTITEM explicitement.
TabCtrl_RemoveImage Supprime une image de la liste d’images d’un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_REMOVEIMAGE explicitement.
TabCtrl_SetCurFocus Définit le focus sur un onglet spécifié dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETCURFOCUS explicitement.
TabCtrl_SetCurSel Sélectionne un onglet dans un contrôle tab. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETCURSEL explicitement.
TabCtrl_SetExtendedStyle Définit les styles étendus que le contrôle tabulation utilisera. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETEXTENDEDSTYLE explicitement.
TabCtrl_SetImageList Affecte une liste d’images à un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETIMAGELIST explicitement.
TabCtrl_SetItem Définit tout ou partie des attributs d’un onglet. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETITEM explicitement.
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 le message TCM_SETITEMEXTRA explicitement.
TabCtrl_SetItemSize Définit la largeur et la hauteur des onglets dans un contrôle d’onglet à largeur fixe ou dessiné par le propriétaire. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETITEMSIZE explicitement.
TabCtrl_SetMinTabWidth Définit la largeur minimale des éléments dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETMINTABWIDTH explicitement.
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 tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETPADDING explicitement.
TabCtrl_SetToolTips Affecte un contrôle d’info-bulle à un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETTOOLTIPS explicitement.
TabCtrl_SetUnicodeFormat Définit l’indicateur de format de caractères 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 d’avoir à recréer le contrôle. Vous pouvez utiliser cette macro ou envoyer le message TCM_SETUNICODEFORMAT explicitement.

Messages

Rubrique Contenu
TCM_ADJUSTRECT Calcule la zone d’affichage d’un contrôle tabulation en fonction d’un rectangle de fenêtre, ou calcule le rectangle de fenêtre qui correspondrait à 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, en effaçant tous ceux qui ont été définis 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 tabulation. 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 du 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ères 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 de tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_HighlightItem .
TCM_HITTEST Détermine quel onglet, le cas échéant, se trouve à 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 tabulation. 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 tab. 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 tout ou partie des 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 d’onglet à largeur fixe ou dessiné par le propriétaire. 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 tabulation. 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 tabulation. 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 tabulation. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_SetToolTips .
TCM_SETUNICODEFORMAT Définit l’indicateur de format de caractères 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 d’avoir à recréer le contrôle. Vous pouvez envoyer ce message explicitement ou utiliser la macro TabCtrl_SetUnicodeFormat .

Notifications

Rubrique Contenu
NM_CLICK (onglet) Avertit la fenêtre parente d’un contrôle onglet 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 Onglet 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 Onglet 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 d’onglet 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 d’onglet 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 d’onglet 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 d’onglet 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 d’onglet 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 d’onglet 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

Rubrique Contenu
NMTCKEYDOWN Contient des informations sur une touche d’appui dans un contrôle tabulation. 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_GETITEM et 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_GETITEM et TCM_SETITEM . Cette structure remplace la structure TC_ITEMHEADER .

Constantes

Rubrique Contenu
Styles étendus du contrôle tabulation Le contrôle d’onglet 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 qui sont passés à CreateWindowEx.
Onglet Control Item States 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 structure TCITEM prend 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.