Tab (contrôles Windows)
Cette section contient des informations sur les éléments de programmation utilisés avec les contrôles Tab.
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 des contrôles Tab | Cette rubrique contient deux exemples qui utilisent des contrôles onglet. |
Macros
| Rubrique | Contenu |
|---|---|
| TabCtrl _ AdjustRect | Calcule la zone d’affichage d’un contrôle onglet en fonction d’un rectangle de fenêtre, ou calcule le rectangle de la fenêtre qui correspondrait à une zone d’affichage spécifiée. Vous pouvez utiliser cette macro ou envoyer le message _ ADJUSTRECT TCM de manière explicite. |
| TabCtrl _ DeleteAllItems | Supprime tous les éléments d’un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ DELETEALLITEMS TCM de manière explicite. |
| TabCtrl _ DeleteItem | Supprime un élément d’un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message TCM _ DELETEITEM de manière explicite. |
| TabCtrl _ DeselectAll | Réinitialise des éléments dans un contrôle onglet, en effaçant tous ceux qui ont été définis sur l’état TCIS _ BUTTONPRESSED . Vous pouvez utiliser cette macro ou envoyer le message _ DESELECTALL TCM de manière explicite. |
| TabCtrl _ GetCurFocus | Retourne l’index de l’élément qui a le focus dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ GETCURFOCUS TCM de manière explicite. |
| TabCtrl _ GetCurSel | Détermine l’onglet actuellement sélectionné dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ GETCURSEL TCM de manière explicite. |
| TabCtrl _ GetExtendedStyle | Récupère les styles étendus en cours d’utilisation pour le contrôle Tab. Vous pouvez utiliser cette macro ou envoyer le message _ GETEXTENDEDSTYLE TCM de manière explicite. |
| TabCtrl _ GetImageList | Récupère la liste d’images associée à un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ GETIMAGELIST TCM de manière explicite. |
| TabCtrl _ GetItem | Récupère des informations sur un onglet dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message TCM _ GETITEM de manière explicite. |
| TabCtrl _ GetItemCount | Récupère le nombre d’onglets dans le contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ GETITEMCOUNT TCM de manière explicite. |
| TabCtrl _ GetItemRect | Récupère le rectangle englobant d’un onglet dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ GETITEMRECT TCM de manière explicite. |
| TabCtrl, _ GetRowCount | Récupère le nombre actuel de lignes d’onglets dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer explicitement le message de _ GETROWCOUNT de TCM . |
| TabCtrl _ GetToolTips | Récupère le handle du contrôle ToolTip associé à un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ GETTOOLTIPS TCM de manière explicite. |
| TabCtrl _ GetUnicodeFormat | Récupère l’indicateur de format de caractère UNICODE pour le contrôle. Vous pouvez utiliser cette macro ou envoyer le message _ GETUNICODEFORMAT TCM de manière explicite. |
| TabCtrl _ HighlightItem | Définit l’état de surbrillance d’un élément d’onglet. Vous pouvez utiliser cette macro ou envoyer le message _ HIGHLIGHTITEM TCM de manière explicite. |
| TabCtrl _ HitTest | Détermine l’onglet, le cas échéant, à la position d’écran spécifiée. Vous pouvez utiliser cette macro ou envoyer le message TCM _ HITTEST de manière explicite. |
| TabCtrl _ InsertItem | Insère un nouvel onglet dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message TCM _ INSERTITEM de manière explicite. |
| TabCtrl _ RemoveImage | Supprime une image de la liste d’images d’un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ REMOVEIMAGE TCM de manière explicite. |
| TabCtrl _ SetCurFocus | Définit le focus sur un onglet spécifié dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ SETCURFOCUS TCM de manière explicite. |
| TabCtrl _ SetCurSel | Sélectionne un onglet dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ SETCURSEL TCM de manière explicite. |
| TabCtrl _ SetExtendedStyle | Définit les styles étendus que le contrôle onglet utilisera. Vous pouvez utiliser cette macro ou envoyer le message _ SETEXTENDEDSTYLE TCM de manière explicite. |
| TabCtrl _ SetImageList | Assigne une liste d’images à un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ SETIMAGELIST TCM de manière explicite. |
| TabCtrl _ SetItem | Définit tout ou partie des attributs d’un onglet. Vous pouvez utiliser cette macro ou envoyer le message _ SETITEM TCM de manière explicite. |
| TabCtrl _ SetItemExtra | Définit le nombre d’octets par onglet réservé pour les données définies par l’application dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ SETITEMEXTRA TCM de manière explicite. |
| TabCtrl _ SetItemSize | Définit la largeur et la hauteur des onglets dans un contrôle onglet à largeur fixe ou owner-drawn. Vous pouvez utiliser cette macro ou envoyer le message _ SETITEMSIZE TCM de manière explicite. |
| TabCtrl _ SetMinTabWidth | Définit la largeur minimale des éléments dans un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ SETMINTABWIDTH TCM de manière explicite. |
| 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 onglet. Vous pouvez utiliser cette macro ou envoyer le message _ SETPADDING TCM de manière explicite. |
| TabCtrl _ SetToolTips | Assigne un contrôle ToolTip à un contrôle onglet. Vous pouvez utiliser cette macro ou envoyer le message _ SETTOOLTIPS TCM de manière explicite. |
| 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 le message _ SETUNICODEFORMAT TCM de manière explicite. |
Messages
| Rubrique | Contenu |
|---|---|
| _ADJUSTRECT TCM | Calcule la zone d’affichage d’un contrôle onglet en fonction d’un rectangle de fenêtre, ou calcule le rectangle de la 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 . |
| _DELETEALLITEMS TCM | Supprime tous les éléments d’un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ DeleteAllItems . |
| TCM _ DELETEITEM | Supprime un élément d’un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ DeleteItem . |
| _DESELECTALL TCM | Réinitialise des éléments dans un contrôle onglet, 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 . |
| _GETCURFOCUS TCM | Retourne l’index de l’élément qui a le focus dans un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ GetCurFocus . |
| _GETCURSEL TCM | 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 . |
| _GETEXTENDEDSTYLE TCM | Récupère les styles étendus en cours d’utilisation pour le contrôle Tab. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ GetExtendedStyle . |
| _GETIMAGELIST TCM | Récupère la liste d’images associée à un contrôle onglet. 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 onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ GetItem . |
| _GETITEMCOUNT TCM | Récupère le nombre d’onglets dans le contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ GetItemCount . |
| _GETITEMRECT TCM | Récupère le rectangle englobant d’un onglet dans un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ GetItemRect . |
| GETROWCOUNT de TCM _ | Récupère le nombre actuel de lignes d’onglets dans un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ GetRowCount . |
| _GETTOOLTIPS TCM | Récupère le handle du contrôle ToolTip associé à un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ GetToolTips . |
| _GETUNICODEFORMAT TCM | Récupère l’indicateur de format de caractère Unicode pour le contrôle. Vous pouvez envoyer ce message de manière explicite ou utiliser la macro TabCtrl _ GetUnicodeFormat . |
| _HIGHLIGHTITEM TCM | 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, à la position d’écran spécifiée. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ HitTest . |
| INSERTITEM de TCM _ | Insère un nouvel onglet dans un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ InsertItem . |
| _REMOVEIMAGE TCM | Supprime une image de la liste d’images d’un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ RemoveImage . |
| _SETCURFOCUS TCM | Définit le focus sur un onglet spécifié dans un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetCurFocus . |
| _SETCURSEL TCM | Sélectionne un onglet dans un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetCurSel . |
| _SETEXTENDEDSTYLE TCM | Définit les styles étendus que le contrôle onglet utilisera. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetExtendedStyle . |
| _SETIMAGELIST TCM | Assigne une liste d’images à un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetImageList . |
| _SETITEM TCM | Définit tout ou partie des attributs d’un onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetItem . |
| _SETITEMEXTRA TCM | Définit le nombre d’octets par onglet réservé pour les données définies par l’application dans un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetItemExtra . |
| _SETITEMSIZE TCM | Définit la largeur et la hauteur des onglets dans un contrôle onglet à largeur fixe ou owner-drawn. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetItemSize . |
| _SETMINTABWIDTH TCM | Définit la largeur minimale des éléments dans un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetMinTabWidth . |
| _SETPADDING TCM | Définit la quantité d’espace (remplissage) autour de l’icône et de l’étiquette de chaque onglet dans un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetPadding . |
| _SETTOOLTIPS TCM | Assigne un contrôle ToolTip à un contrôle onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl _ SetToolTips . |
| _SETUNICODEFORMAT TCM | 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 de manière explicite ou utiliser la macro TabCtrl _ SetUnicodeFormat . |
Notifications
| Rubrique | Contenu |
|---|---|
| NM _ , clic (tabulation) | Notifie la fenêtre parente d’un contrôle onglet sur lequel l’utilisateur a cliqué avec le bouton gauche de la souris dans le contrôle. Ce code de notification est envoyé sous la forme d’un message WM _ Notify . |
| _DBLCLK nm (tabulation) | Avertit une fenêtre parente d’un contrôle onglet 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 . |
| _RCLICK nm (tabulation) | Notifie la fenêtre parente d’un contrôle onglet sur lequel l’utilisateur a cliqué avec le bouton droit de la souris dans le contrôle. Ce code de notification est envoyé sous la forme d’un message WM _ Notify . |
| _RDBLCLK nm (tabulation) | Notifie la fenêtre parente d’un contrôle onglet sur lequel l’utilisateur a double-cliqué dans le contrôle avec le bouton droit de la souris. Ce code de notification est envoyé sous la forme d’un message WM _ Notify . |
| _RELEASEDCAPTURE nm (tabulation) | Avertit une fenêtre parente d’un contrôle 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 une fenêtre parente d’un contrôle 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 onglet lorsqu’il a le style étendu TCS _ ex _ REGISTERDROP et qu’un objet est glissé 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 _ | Avertit une fenêtre parente d’un contrôle 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 une fenêtre parente d’un contrôle 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 une fenêtre parente d’un contrôle onglet que l’onglet actuellement sélectionné va être modifié. Ce code de notification est envoyé sous la forme d’un message WM _ Notify . |
Structures
| Rubrique | Contenu |
|---|---|
| NMTCKEYDOWN | Contient des informations sur une pression sur une touche dans un contrôle onglet. Elle est utilisée avec le code de notification _ keyverse TCN . Cette structure remplace la structure de la _ touche TC . |
| 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. Elle est utilisée avec les messages TCM _ INSERTITEM, TCM _ GETITEMet TCM _ SETITEM . Cette structure remplace la structure d' _ élément TC . |
| TCITEMHEADER | Spécifie ou reçoit les attributs d’un onglet. Elle est utilisée avec les messages TCM _ INSERTITEM, TCM _ GETITEMet TCM _ SETITEM . Cette structure remplace la structure TC _ ITEMHEADER . |
Constantes
| Rubrique | Contenu |
|---|---|
| Styles étendus de contrôle onglet | Le contrôle 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 passés à CreateWindowEx. |
| États des éléments de contrôle d’onglet | Les éléments de contrôle d’onglet prennent désormais en charge l’état d’un élément pour prendre en charge le message _ DESELECTALL TCM . En outre, la structure TCITEM prend en charge les valeurs d’état des éléments. |
| Styles du contrôle onglet | Cette section répertorie les styles de contrôle onglets pris en charge. |