Messages d'AFX
Ces messages sont utilisés dans MFC.
Messages
Le tableau suivant répertorie les messages qui sont 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 d'accessibilité.Envoyez ce message à CMFCPopupMenu ou à CMFCRibbonPanelMenu pour récupérer l'état de l'élément actuel. |
Index de l'élément, qui peut être un bouton de menu ou un séparateur. |
Non utilisé. |
L'état de l'élément.Il est -1 si l'index est incorrect, 0 si le bouton de menu n'a pas d'attribut spécial.Sinon c'est une combinaison des indicateurs suivants : TBBS_DISABLED – l'élément est désactivé TBBS_CHECKED – l'élément est contrôlé TBBS_BUTTON – l'élément est un bouton poussoir 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 autres éléments de menu |
AFX_WM_CHANGE_ACTIVE_TAB |
L'infrastructure envoie le message au contrôle redimensionnable de barres de contrôles.Traitez ce message pour recevoir des notifications des objets d' CMFCTabCtrl lorsqu'un utilisateur modifie une table active. |
L'index d'une table. |
Non utilisé. |
Une valeur différente de zéro. |
AFX_WM_CHANGE_CURRENT_FOLDER |
L'infrastructure envoie le message au parent d' CMFCShellListCtrl lorsque l'utilisateur a modifié le dossier actif. |
Non utilisé. |
Non utilisé. |
Non utilisé. |
AFX_WM_CHANGEVISUALMANAGER |
L'infrastructure envoie le message à toutes les fenêtres frames lorsque l'utilisateur modifie le gestionnaire visuel actuel.En réponse à ce message, une fenêtre frame recalcule sa zone et règle d'autres paramètres selon les besoins.Vous pouvez traiter le message d'AFX_WM_CHANGEVISUALMANAGER dans votre application si vous devez être informé sur cet événement.Vous devez appeler le gestionnaire de classe de base (OnChangeVisualManager) pour garantir que le traitement interne de l'infrastructure de cet événement a lieu. |
Non utilisé. |
Non utilisé. |
Non utilisé. |
AFX_WM_CHANGING_ACTIVE_TAB |
Envoyé au parent de l'objet d' CMFCTabCtrl .Traitez ce message si vous voulez recevoir des notifications des objets d' CMFCTabCtrl lorsqu'un utilisateur réinitialise une table. |
L'index de l'onglet qui est activé. |
Non utilisé. |
Une valeur différente de zéro. |
AFX_WM_CHECKEMPTYMINIFRAME |
À usage interne uniquement. |
Non applicable. |
Non applicable. |
Non applicable. |
AFX_WM_CREATETOOLBAR |
Envoi d' CMFCToolBarsListPropertyPage lorsqu'un utilisateur crée une nouvelle barre d'outils pendant le processus de personnalisation.Vous pouvez traiter ce message pour instancier un objet CMFCToolBar-dérivé personnalisé.Si vous exécutez ce message et créez votre propre barre d'outils, omettez l'appel au gestionnaire par défaut. |
Non utilisé. |
Un pointeur vers une chaîne contenant le nom de la barre d'outils. |
Un pointeur vers la barre d'outils de création récente.NULL indique que la création de barre d'outils a été annulée. |
AFX_WM_CUSTOMIZEHELP |
Envoyé à la fenêtre frame principale de la feuille de propriétés CMFCToolbarCustomizeDialog 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. |
Un pointeur vers un objet d' CMFCToolbarCustomizeDialog . |
Zéro. |
AFX_WM_CUSTOMIZETOOLBAR |
CMFCToolbarCustomizeDialog envoie le message pour informer le frame 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é. |
Non utilisé. |
Zéro. |
AFX_WM_DELETETOOLBAR |
Envoyé à la fenêtre frame principale lorsque l'utilisateur est sur le point de supprimer une barre d'outils en mode de personnalisation. Traitez ce message pour prendre des mesures 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. |
Non utilisé. |
Pointeur vers un objet d' CMFCToolBar à supprimer. |
Une valeur différente de zéro si une barre d'outils ne peut pas être supprimée ; sinon 0. |
AFX_WM_GETDOCUMENTCOLORS |
CMFCColorMenuButton envoie le message à la fenêtre frame principale pour récupérer les couleurs de document. |
Non utilisé. |
dans [,] pointeur vers un objet d' CList<COLORREF, COLORREF> . |
Zéro. |
AFX_WM_GETDRAGBOUNDS |
À usage interne uniquement. |
Non applicable. |
Non applicable. |
Non applicable. |
AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM |
Envoyé à la fenêtre frame principale lorsqu'un utilisateur met en surbrillance un élément de liste du ruban. |
Index de l'élément en surbrillance |
Un pointeur vers CMFCBaseRibbonElement |
Non utilisé. |
AFX_WM_ON_AFTER_SHELL_COMMAND |
Envoyé à un parent d' CMFCShellListCtrl ou des contrôles d' CMFCShellTreeCtrl lorsqu'un utilisateur termine d'exécuter une commande d'environnement. |
L'ID de la commande que l'utilisateur a exécuté |
Non utilisé. |
Si les processus d'application ce message, il retourne zéro. |
AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU |
L'infrastructure envoie le message à le parent du ruban avant qu'elle affiche le menu contextuel.Vous pouvez traiter ce message et modifier des menus contextuels à tout moment. |
Non utilisé. |
Un pointeur vers CMFCBaseRibbonElement |
Non utilisé. |
AFX_WM_ON_CANCELTABMOVE |
À usage interne uniquement. |
Non applicable. |
Non applicable. |
|
AFX_WM_ON_CHANGE_RIBBON_CATEGORY |
L'infrastructure envoie le message au frame principal lorsque l'utilisateur modifie la catégorie active de contrôle du ruban. |
Non utilisé. |
Un pointeur vers CMFCRibbonBar dont la catégorie a changé. |
Non utilisé. |
AFX_WM_ON_CLOSEPOPUPWINDOW |
L'infrastructure envoie le message pour informer le propriétaire d' CMFCDesktopAlertWnd que la fenêtre est sur le point d'être fermé. |
Non utilisé. |
Pointeur vers l'objet d' CMFCDesktopAlertWnd . |
Non utilisé. |
AFX_WM_ON_DRAGCOMPLETE |
À usage interne uniquement. |
Non applicable. |
Non applicable. |
Non applicable. |
AFX_WM_ON_GET_TAB_TOOLTIP |
Envoyé à la fenêtre frame principale lorsqu'une fenêtre d'onglet est sur le point d'afficher une info-bulle pour un onglet, si des info-bulles personnalisées sont activées. |
Non utilisé. |
Un pointeur vers une structure d' CMFCTabToolTipInfo . |
Non utilisé. |
AFX_WM_ON_HSCROLL |
Envoyé au contrôle redimensionnable de barres de contrôles.Traitez ce message pour recevoir des notifications des objets d' CMFCTabCtrl lorsqu'un événement de défilement se produit dans la barre de défilement horizontale de widget avec tabulation. |
Le mot de poids faible spécifie une valeur de barre de défilement qui indique la demande de défilement de l'utilisateur.Pour plus d'informations, consultez le tableau plus loin dans cette rubrique. |
Non utilisé. |
Une valeur différente de zéro. |
AFX_WM_ON_MOVE_TAB |
Envoyé au parent d'une fenêtre avec tabulation lorsqu'un utilisateur fait glisser un onglet vers une nouvelle position. |
L'index de base zéro de l'onglet dans sa position d'origine. |
[out] l'index de base zéro de l'onglet dans sa nouvelle position. |
Zéro. |
AFX_WM_ON_MOVETABCOMPLETE |
À usage interne uniquement. |
Non applicable. |
Non applicable. |
Non applicable. |
AFX_WM_ON_MOVETOTABGROUP |
Envoyé à la fenêtre frame principale lorsqu'un utilisateur déplace une fenêtre MDI enfant d'un groupe tabulé vers un autre. |
Un handle dans la fenêtre avec tabulation (CMFCTabCtrl) de laquelle la fenêtre MDI enfant a été supprimée. |
[out] handle d'Un à la fenêtre avec tabulation (CMFCTabCtrl) dans laquelle la fenêtre MDI enfant a été insérée. |
Ignoré. |
AFX_WM_ON_PRESS_CLOSE_BUTTON |
Envoyé à un parent d' CDockablePane lorsque l'utilisateur clique sur le bouton Fermer sur la légende de la barre de contrôles. |
Non utilisé. |
Un pointeur vers un volet ancrable sur lequel l'utilisateur a cliqué sur le bouton Fermer . |
TRUE si un volet ne peut pas être fermée ; sinon FALSE. |
AFX_WM_ON_RENAME_TAB |
Envoyé au parent de la fenêtre avec tabulations après l'utilisateur renommé une table modifiable. |
L'index de base zéro de la table renommée. |
[out] pointeur à une chaîne qui contient le nouveau nom de l'onglet. |
Une valeur différente de zéro si les processus d'application ce message ; l'infrastructure supprimera l'appel à CMFCBaseTabCtrl::SetTabLabel.Si zéro est retourné, le CMFCBaseTabCtrl::SetTabLabel est appelée par l'infrastructure. |
AFX_WM_ON_RIBBON_CUSTOMIZE |
Envoyé au frame parent lorsque l'utilisateur commence la personnalisation.Traitez ce message si vous souhaitez afficher votre propre boîte de dialogue personnalisation. |
Non utilisé. |
Pointeur vers le contrôle de ruban à personnaliser. |
Une valeur différente de zéro si les processus d'application ces messages et affiche sa propre boîte de dialogue personnalisation.Si l'application retourne zéro, l'infrastructure affiche la boîte de dialogue intégrée de personnalisation. |
AFX_WM_ON_TABGROUPMOUSEMOVE |
À usage interne uniquement. |
Non applicable. |
Non applicable. |
Non applicable. |
AFX_WM_POSTSETPREVIEWFRAME |
Envoyé pour informer le frame principal que l'utilisateur a modifié l'état d'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. |
L'ID du contrôle de la liste de propriétés. |
Un pointeur à la propriété (CMFCPropertyGridProperty) qui a changé. |
Non utilisé. |
AFX_WM_RESETCONTEXTMENU |
Envoyé à la fenêtre frame principale lorsque l'utilisateur réinitialise le menu contextuel lors de la personnalisation. |
L'ID de ressource dans le menu contextuel. |
Pointeur vers le menu contextuel actuel, CMFCPopupMenu. |
Non utilisé. |
AFX_WM_RESETKEYBOARD |
L'infrastructure envoie le message à la fenêtre frame principale lorsque l'utilisateur réinitialise tous les accélérateurs clavier pendant la personnalisation. |
Non utilisé. |
Non utilisé. |
Non utilisé. |
AFX_WM_RESETMENU |
L'infrastructure envoie le message au propriétaire de menu (une fenêtre frame) lorsque l'utilisateur réinitialise un menu de frame d'application pendant la personnalisation |
L'ID de ressource menu |
Non utilisé. |
Non utilisé. |
AFX_WM_RESETPROMPT |
L'infrastructure envoie le message lorsque l'utilisateur réinitialise une barre d'outils de la barre d'outils personnaliser la boîte de dialogue.Le gestionnaire par défaut affiche un message qui demande si l'utilisateur souhaite réinitialiser la barre d'outils. |
Non utilisé. |
Non utilisé. |
Non utilisé. |
AFX_WM_RESETTOOLBAR |
Un objet d' CMFCToolBar envoie le message lorsqu'une barre d'outils est restaurée à son état d'origine, c. autrement dit., le chargement des ressources.Traitez ce message de réinsérer les boutons de barre d'outils dont les classes sont dérivées d' CMFCToolbarButton.Pour plus d'informations, consultez CMFCToolbarComboBoxButton. |
L'ID de ressource d'une barre d'outils dont l'état a été restauré. |
Non utilisé. |
Zéro. |
AFX_WM_SHOWREGULARMENU |
l'objet d'CMFCToolbarMenuButton envoie le 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. |
L'ID de commande d'un bouton qui envoie le message. |
Coordonnées d'écran du curseur.Le mot de poids faible spécifie la coordonnée x.Le mot de poids fort spécifie la coordonnée y. |
Non utilisé. |
AFX_WM_TOOLBARMENU |
Envoyé à la fenêtre frame principale lorsque l'utilisateur relâche le bouton droit de la souris lorsque le pointeur de la souris se trouve dans la zone cliente ou non cliente d'un volet. |
Non utilisé. |
Coordonnées d'écran du pointeur de la souris.Le mot de poids faible spécifie la coordonnée x.Le mot de poids fort spécifie la coordonnée y. |
Zéro si les processus d'application ce message ; sinon, une valeur différente de zéro. |
AFX_WM_UPDATETOOLTIPS |
Envoyé à tous les propriétaires d'info-bulle pour indiquer que leurs contrôles d'info-bulle doivent être recréés. |
Le type de contrôle qui doit traiter ce message.Consultez le tableau plus loin dans cette rubrique pour obtenir une liste de valeurs possibles. |
Non utilisé. |
Non utilisé. |
AFX_WM_WINDOW_HELP |
CMFCWindowsManagerDialog envoie le message au frame parent lorsque l'utilisateur clique sur le bouton Aide, ou entre le mode d'aide en cliquant sur le bouton de légende Aide ou la touche F1. |
Non utilisé. |
Pointeur vers l'instance d' CMFCWindowsManagerDialog. |
Non utilisé. |
Le tableau suivant indique les valeurs pour le bas mot du paramètre d' lParam de la méthode d'AFX_WM_HSCROLL :
Valeur |
Signification |
SB_ENDSCROLL |
L'utilisateur effectue un défilement. |
SB_LEFT |
L'utilisateur fait défiler au supérieur gauche. |
SB_RIGHT |
L'utilisateur fait défiler dans l'angle inférieur droit. |
SB_LINELEFT |
L'utilisateur fait défiler à gauche d'une unité. |
SB_LINERIGHT |
L'utilisateur fait défiler uniquement par une unité. |
SB_PAGELEFT |
L'utilisateur fait défiler à gauche dans la largeur de la fenêtre. |
SB_PAGERIGHT |
L'utilisateur fait défiler uniquement par la largeur de la fenêtre. |
SB_THUMBPOSITION |
L'utilisateur a déplacé la case de défilement (curseur de défilement) et a libéré le bouton de la souris.Le mot de poids fort indique la position de la case de défilement à la fin de l'opération glisser. |
SB_THUMBTRACK |
L'utilisateur fait glisser la case de défilement.Le message d'AFX_WM_ON_HSCROLL est envoyé à plusieurs reprises à cette valeur jusqu'à ce que l'utilisateur relâche le bouton de la souris.Le mot de poids fort indique la position dans laquelle la case de défilement a été fait glisser. |
[!REMARQUE]
Le mot de poids fort du paramètre d' lParam spécifie la position actuelle de la case de défilement si le mot de poids faible 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 d' lParam du message d'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 |