AFX, messages
Ces messages sont utilisés dans MFC.
Messages
Le tableau suivant répertorie les messages utilisés dans la bibliothèque MFC :
| Message | Description | [in] wParam | lParam (Tous les paramètres sont [in] sauf indication contraire.) | Valeur de retour |
|---|---|---|---|---|
| AFX_WM_ACCGETOBJECT | Non utilisé. | Non utilisé. | Non applicable. | Non applicable. |
| AFX_WM_ACCGETSTATE | Utilisé pour la prise en charge de l’accessibilité. Envoyez ce message ou CMFCPopupMenu CMFCRibbonPanelMenu récupérez l’état de l’élément actuel. |
Index de l’élément, qui peut être un bouton de menu ou un séparateur. | Aucun affichage. | État de l’élément. Il s’agit de -1 si l’index n’est pas valide, 0 si le bouton de menu n’a aucun attribut spécial. Sinon, il s’agit d’une combinaison des indicateurs suivants : TBBS_DISABLED : l’élément est désactivé TBBS_CHECKED — l’élément est coché TBBS_BUTTON : l’élément est un bouton pushbutton standard TBBS_PRESSED : le bouton est enfoncé TBBS_INDETERMINATE — état non défini TBBS_SEPARATOR - plutôt qu’un bouton de menu, cet élément forme une séparation entre d’autres éléments de menu |
| AFX_WM_CHANGE_ACTIVE_TAB | L’infrastructure envoie ce message au contrôle de barre de contrôle redimensionnable. Traitez ce message pour recevoir des notifications d’objets CMFCTabCtrl lorsqu’un utilisateur modifie un onglet actif. |
Index d’un onglet. | Aucun affichage. | Différent de zéro. |
| AFX_WM_CHANGE_CURRENT_FOLDER | L’infrastructure envoie ce message au parent de CMFCShellListCtrl la modification du dossier actif par l’utilisateur. |
Non utilisé. | Non utilisé. | Non utilisé. |
| AFX_WM_CHANGEVISUALMANAGER | L’infrastructure envoie ce message à toutes les fenêtres d’images lorsque l’utilisateur modifie le Gestionnaire visuel actuel. En réponse à ce message, une fenêtre frame recalcule sa région et ajuste d’autres paramètres en fonction des besoins. Vous pouvez traiter le message AFX_WM_CHANGEVISUALMANAGER dans votre application si vous devez être informé de cet événement. Vous devez appeler le gestionnaire de classes de base (OnChangeVisualManager) pour vous assurer que le traitement interne du framework de cet événement a lieu. |
Non utilisé. | Non utilisé. | Non utilisé. |
| AFX_WM_CHANGING_ACTIVE_TAB | Envoyé au parent de l’objet CMFCTabCtrl . Traitez ce message si vous souhaitez recevoir des notifications d’objets CMFCTabCtrl lorsqu’un utilisateur réinitialise un onglet. |
Index de l’onglet en cours d’activation. | Aucun affichage. | Différent de zéro. |
| AFX_WM_CHECKEMPTYMINIFRAME | Réservé exclusivement à un usage interne. | Non applicable. | Non applicable. | Non applicable. |
| AFX_WM_CREATETOOLBAR | Envoyé à partir du CMFCToolBarsListPropertyPage moment où un utilisateur crée une barre d’outils pendant le processus de personnalisation. Vous pouvez traiter ce message pour instancier un objet dérivé de CMFCToolBar personnalisé. Si vous gérez ce message et créez votre propre barre d’outils, omettez l’appel au gestionnaire par défaut. |
Aucun affichage. | Pointeur vers une chaîne qui contient le nom de la barre d’outils. | Pointeur vers la barre d’outils nouvellement créée. NULL indique que la création de la barre d’outils a été annulée. |
| AFX_WM_CUSTOMIZEHELP | Envoyé à la fenêtre cadre principale à partir de la feuille CMFCToolbarCustomize Dialog de propriétés de personnalisation lorsque l’utilisateur appuie sur le bouton Aide ou la touche F1. |
Spécifie la page active de la feuille de propriétés de personnalisation. | Pointeur vers un objet CMFCToolbarCustomize Dialog. |
Zéro. |
| AFX_WM_CUSTOMIZETOOLBAR | Le CMFCToolbarCustomize Dialog message envoie ce message pour avertir le cadre parent que l’utilisateur crée une nouvelle barre d’outils. |
TRUE lorsque la personnalisation est démarrée, FALSE lorsque la personnalisation est terminée. | Aucun affichage. | Zéro. |
| AFX_WM_DELETETOOLBAR | Envoyé à la fenêtre cadre principale lorsque l’utilisateur est sur le point de supprimer une barre d’outils en mode de personnalisation. Traitez ce message pour effectuer des actions supplémentaires lorsqu’un utilisateur supprime une barre d’outils en mode de personnalisation. Vous devez également appeler le gestionnaire par défaut ( OnToolbarDelete), qui supprime la barre d’outils. Le gestionnaire par défaut retourne une valeur qui indique s’il est possible de supprimer la barre d’outils. |
Aucun affichage. | Pointeur vers un CMFCToolBar objet à supprimer. |
Différent de zéro si une barre d’outils ne peut pas être supprimée ; sinon 0. |
| AFX_WM_GETDOCUMENTCOLORS | CMFCColorMenuButton envoie ce message à la fenêtre de cadre principale pour récupérer les couleurs du document. |
Aucun affichage. | [in, out] Pointeur vers un CList<COLORREF, COLORREF> objet. |
Zéro. |
| AFX_WM_GETDRAGBOUNDS | Réservé exclusivement à un usage interne. | Non applicable. | Non applicable. | Non applicable. |
| AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM | Envoyé à la fenêtre de cadre principale lorsqu’un utilisateur met en surbrillance un élément de liste de ruban. | Index de l’élément mis en surbrillance | Pointeur vers CMFCBaseRibbonElement |
Aucun affichage. |
| AFX_WM_ON_AFTER_SHELL_COMMAND | Envoyé à un parent ou à un CMFCShellListCtrl CMFCShellTreeCtrl contrôle lorsqu’un utilisateur termine l’exécution d’une commande shell. |
ID de la commande exécutée par l’utilisateur | Aucun affichage. | Si l’application traite ce message, elle doit retourner zéro. |
| AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU | L’infrastructure envoie ce message au parent du ruban avant d’afficher le menu contextuel. Vous pouvez traiter ce message et modifier les menus contextuels à tout moment. | Aucun affichage. | Pointeur vers CMFCBaseRibbonElement |
Aucun affichage. |
| AFX_WM_ON_CANCELTABMOVE | Réservé exclusivement à un usage interne. | Non applicable. | Non applicable. | |
| AFX_WM_ON_CHANGE_RIBBON_CATEGORY | L’infrastructure envoie ce message au cadre principal lorsque l’utilisateur modifie la catégorie de contrôle du ruban actif. | Aucun affichage. | Pointeur vers la catégorie dont la CMFCRibbonBar catégorie a changé. |
Aucun affichage. |
| AFX_WM_ON_CLOSEPOPUPWINDOW | Le framework envoie ce message pour avertir le propriétaire de cette fenêtre est sur le point d’être CMFCDesktopAlertWnd fermé. |
Aucun affichage. | Pointeur vers l’objet CMFCDesktopAlertWnd . |
Aucun affichage. |
| AFX_WM_ON_DRAGCOMPLETE | Réservé exclusivement à un usage interne. | Non applicable. | Non applicable. | Non applicable. |
| AFX_WM_ON_GET_TAB_TOOLTIP | Envoyé à la fenêtre de cadre principale lorsqu’une fenêtre onglet est sur le point d’afficher une info-bulle pour un onglet, si des info-bulles personnalisées sont activées. | Aucun affichage. | Pointeur vers une CMFCTabToolTipInfo structure. |
Aucun affichage. |
| AFX_WM_ON_HSCROLL | Envoyé au contrôle de barre de contrôle redimensionnable. Traitez ce message pour recevoir des notifications d’objets CMFCTabCtrl lorsqu’un événement de défilement se produit dans la barre de défilement horizontale du widget à onglets. |
Le mot de bas ordre spécifie une valeur de barre de défilement qui indique la demande de défilement de l’utilisateur. Pour plus d'informations, consultez la table plus loin dans cette rubrique. | Aucun affichage. | Différent de zéro. |
| AFX_WM_ON_MOVE_TAB | Envoyé au parent d’une fenêtre à onglets lorsqu’un utilisateur fait glisser un onglet vers une nouvelle position. | Index de base zéro de l’onglet dans sa position d’origine. | [out] Index de base zéro de l’onglet dans sa nouvelle position. | Zéro. |
| AFX_WM_ON_MOVETABCOMPLETE | Réservé exclusivement à un usage interne. | Non applicable. | Non applicable. | Non applicable. |
| AFX_WM_ON_MOVETOTABGROUP | Envoyé à la fenêtre cadre principale lorsqu’un utilisateur déplace une fenêtre enfant MDI d’un groupe à onglets vers un autre. | Poignée de fenêtre tabulation (CMFCTabCtrl) à partir de laquelle la fenêtre enfant MDI a été supprimée. |
[out] Poignée de fenêtre tabulation (CMFCTabCtrl) à laquelle la fenêtre enfant MDI a été insérée. |
Ignoré. |
| AFX_WM_ON_PRESS_CLOSE_BUTTON | Envoyé à un parent du CDockablePane moment où l’utilisateur clique sur le bouton Fermer dans la légende de la barre de contrôle. |
Aucun affichage. | Pointeur vers un volet ancre sur lequel l’utilisateur a cliqué sur le bouton Fermer . | TRUE si un volet ne peut pas être fermé ; sinon FALSE. |
| AFX_WM_ON_RENAME_TAB | Envoyé au parent de la fenêtre à onglets après que l’utilisateur a renommé un onglet modifiable. | Index de base zéro de l’onglet renommé. | [out] Pointeur vers une chaîne qui contient le nouveau nom d’onglet. | Différent de zéro si l’application traite ce message ; l’infrastructure supprime l’appel à CMFCBaseTabCtrl::SetTabLabel. Si zéro est retourné, CMFCBaseTabCtrl::SetTabLabel il est appelé par l’infrastructure. |
| AFX_WM_ON_RIBBON_CUSTOMIZE | Envoyé au cadre parent lorsque l’utilisateur démarre la personnalisation. Traitez ce message si vous souhaitez afficher votre propre boîte de dialogue de personnalisation. | Aucun affichage. | Pointeur vers le contrôle du ruban à personnaliser. | Différent de zéro si l’application traite ce message et affiche sa propre boîte de dialogue de personnalisation. Si l’application retourne zéro, l’infrastructure affiche la boîte de dialogue de personnalisation intégrée. |
| AFX_WM_ON_TABGROUPMOUSEMOVE | Réservé exclusivement à un usage interne. | Non applicable. | Non applicable. | Non applicable. |
| AFX_WM_POSTSETPREVIEWFRAME | Envoyé pour avertir le cadre principal que l’utilisateur a modifié le mode aperçu avant impression | TRUE indique que le mode aperçu avant impression est défini. FALSE indique que le mode aperçu avant impression est désactivé. | Non utilisé. | Non utilisé. |
| AFX_WM_PROPERTY_CHANGED | Envoyé au propriétaire du contrôle de grille de propriétés (CMFCPropertyGridCtrl) lorsque l’utilisateur modifie la valeur de la propriété sélectionnée. |
ID de contrôle de la liste des propriétés. | Pointeur vers la propriété (CMFCPropertyGridProperty) qui a changé. |
Aucun affichage. |
| AFX_WM_RESETCONTEXTMENU | Envoyé à la fenêtre cadre principale lorsque l’utilisateur réinitialise le menu contextuel lors de la personnalisation. | ID de ressource du menu contextuel. | Pointeur vers le menu contextuel actuel. CMFCPopupMenu |
Aucun affichage. |
| AFX_WM_RESETKEYBOARD | L’infrastructure envoie ce message à la fenêtre de trame principale lorsque l’utilisateur réinitialise tous les accélérateurs clavier lors de la personnalisation. | Non utilisé. | Non utilisé. | Non utilisé. |
| AFX_WM_RESETMENU | L’infrastructure envoie ce message au propriétaire du menu (fenêtre frame) lorsque l’utilisateur réinitialise un menu frame d’application lors de la personnalisation | ID de ressource de menu. | Non utilisé. | Non utilisé. |
| AFX_WM_RESETPROMPT | L’infrastructure envoie ce message lorsque l’utilisateur réinitialise une barre d’outils à partir de la boîte de dialogue personnaliser la barre d’outils. Le gestionnaire par défaut affiche une boîte de message qui demande si l’utilisateur souhaite réinitialiser la barre d’outils. | Non utilisé. | Non utilisé. | Non utilisé. |
| AFX_WM_RESETTOOLBAR | Un CMFCToolBar objet envoie ce message lorsqu’une barre d’outils est restaurée à son état d’origine, qui est chargé à partir des ressources. Traitez ce message pour réinsérer les boutons de CMFCToolbarButtonbarre d’outils dont les classes sont dérivées . Pour plus d’informations, consultez CMFCToolbarComboBoxButton. |
ID de ressource d’une barre d’outils dont l’état a été restauré. | Aucun affichage. | Zéro. |
| AFX_WM_SHOWREGULARMENU | CMFCToolbarMenuButton l’objet envoie ce message à son propriétaire lorsque l’utilisateur clique sur un bouton de menu normal. Traitez ce message chaque fois que vous utilisez CMFCToolbarMenuButton pour afficher un menu contextuel lorsque l’utilisateur clique sur un bouton. |
ID de commande d’un bouton qui envoie le message. | Coordonnées de l’écran du curseur. Le mot de bas ordre spécifie la coordonnée x. Le mot à ordre élevé spécifie la coordonnée y. | Aucun affichage. |
| AFX_WM_TOOLBARMENU | Envoyé à la fenêtre d’image principale lorsque l’utilisateur relâche le bouton droit d’une souris pendant que le pointeur de la souris se trouve dans la zone cliente ou non cliente d’un volet. | Aucun affichage. | Coordonnées de l’écran du pointeur de la souris. Le mot de bas ordre spécifie la coordonnée x. Le mot à ordre élevé spécifie la coordonnée y. | Zéro si l’application traite ce message ; sinon, non zéro. |
| AFX_WM_UPDATETOOLTIPS | Envoyé à tous les propriétaires d’info-bulles pour indiquer que leurs contrôles d’info-bulle doivent être recréés. | Type de contrôle qui doit traiter ce message. Consultez le tableau plus loin dans cette rubrique pour obtenir la liste des valeurs possibles. | Non utilisé. | Non utilisé. |
| AFX_WM_WINDOW_HELP | CMFCWindowsManagerDialog envoie ce message au cadre parent lorsque l’utilisateur clique sur le bouton Aide ou entre en mode d’aide en cliquant sur le bouton de légende d’aide ou sur la touche F1. |
Aucun affichage. | Pointeur vers l’instance de CMFCWindowsManagerDialog. |
Aucun affichage. |
Le tableau suivant présente les valeurs du mot faible du paramètre lParam de la méthode AFX_WM_HSCROLL :
| Valeur | Signification |
|---|---|
| SB_ENDSCROLL | L’utilisateur termine le défilement. |
| SB_LEFT | L’utilisateur fait défiler jusqu’en haut à gauche. |
| SB_RIGHT | L’utilisateur fait défiler jusqu’en bas à droite. |
| SB_LINELEFT | L’utilisateur fait défiler vers la gauche d’une unité. |
| SB_LINERIGHT | L’utilisateur fait défiler vers la droite d’une unité. |
| SB_PAGELEFT | L’utilisateur fait défiler vers la gauche la largeur de la fenêtre. |
| SB_PAGERIGHT | L’utilisateur fait défiler vers la droite la largeur de la fenêtre. |
| SB_THUMBPOSITION | L’utilisateur a fait glisser la zone de défilement (le curseur) et a relâché le bouton de la souris. Le mot à ordre élevé indique la position de la zone de défilement à la fin de l’opération de glisser. |
| SB_THUMBTRACK | L’utilisateur fait glisser la case de défilement. Le message AFX_WM_ON_HSCROLL est envoyé à plusieurs reprises avec cette valeur jusqu’à ce que l’utilisateur relâche le bouton de la souris. Le mot à ordre élevé indique la position vers laquelle la zone de défilement a été déplacée. |
Remarque
Le mot à ordre élevé du paramètre lParam spécifie la position actuelle de la zone de défilement si le mot de bas ordre est SB_THUMBPOSITION ou SB_THUMBTRACK ; sinon, ce mot n’est pas utilisé.
Le tableau suivant répertorie les valeurs d’indicateur pour le paramètre lParam du message AFX_WM_UPDATETOOLTIPS :
| Indicateur | Valeur |
|---|---|
| AFX_TOOLTIP_TYPE_DEFAULT | 0x0001 |
| AFX_TOOLTIP_TYPE_TOOLBAR | 0x0002 |
| AFX_TOOLTIP_TYPE_TAB | 0x0004 |
| AFX_TOOLTIP_TYPE_MINIFRAME | 0x0008 |
| AFX_TOOLTIP_TYPE_DOCKBAR | 0x0010 |
| AFX_TOOLTIP_TYPE_EDIT | 0x0020 |
| AFX_TOOLTIP_TYPE_BUTTON | 0x0040 |
| AFX_TOOLTIP_TYPE_TOOLBOX | 0x0080 |
| AFX_TOOLTIP_TYPE_ALL | 0xFFFF |