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