Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
AFX, messages
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

AFX, messages

Ces messages sont utilisés dans MFC.

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 à CMFCPopupMenu ou à CMFCRibbonPanelMenu pour récupérer l'état de l'élément actuel.

Indice de l'élément, qui peut être un bouton de menu ou un séparateur.

Non utilisé.

L'état de l'élément. La valeur est -1 si l'indice n'est pas valide, 0 si le bouton de menu n'a pas d'attribut spécial. Sinon il s'agit d'une combinaison des indicateurs suivants :

TBBS_DISABLED – le service est désactivé

TBBS_CHECKED – l'élément est activé

TBBS_BUTTON – l'élément est un bouton poussoir standard

TBBS_PRESSED – le bouton est pressé

TBBS_INDETERMINATE – état indé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 dans le contrôle redimensionnable de la barre de contrôle. Traitez ce message pour recevoir des notifications d'objets CMFCTabCtrl lorsqu'un utilisateur modifie un onglet actif.

L'indice d'un onglet.

Non utilisé.

Une valeur différente de zéro.

AFX_WM_CHANGE_CURRENT_FOLDER

L'infrastructure envoie le message au parent de CMFCShellListCtrl lorsque l'utilisateur a modifié le dossier actif.

Non utilisé.

Non utilisé.

Non utilisé.

AFX_WM_CHANGEVISUALMANAGER

L'infrastructure envoie ce message à toutes les fenêtres cadres lorsque l'utilisateur modifie le gestionnaire visuel actuel. En réponse à ce message, une fenêtre cadre recalcule la zone et ajuste les autres paramètres si nécessaire. Vous pouvez traiter le message 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 CMFCTabCtrl. Traitez ce message si vous souhaitez recevoir des notifications d'objets CMFCTabCtrl lorsqu'un utilisateur réinitialise un onglet.

Indice de l'onglet activé.

Non utilisé.

Une valeur différente de zéro.

AFX_WM_CHECKEMPTYMINIFRAME

Uniquement réservé à un usage interne.

Non applicable.

Non applicable.

Non applicable.

AFX_WM_CREATETOOLBAR

Envoyé de CMFCToolBarsListPropertyPage lorsqu'un utilisateur crée une barre d'outils lors du processus de personnalisation. Vous pouvez traiter ce message pour instancier un objet personnalisé dérivé de CMFCToolBar. Si vous traitez ce message et créez votre propre barre d'outils, omettez l'appel au gestionnaire par défaut.

Non utilisé.

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 principale cadre de la feuille de propriétés de personnalisation CMFCToolbarCustomizeDialog 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 CMFCToolbarCustomizeDialog.

Zéro.

AFX_WM_CUSTOMIZETOOLBAR

Le CMFCToolbarCustomizeDialog envoie ce message pour notifier le cadre parent que l'utilisateur crée une barre d'outils.

TRUE lorsque la personnalisation est démarrée, FALSE lorsque la personnalisation est terminée.

Non utilisé.

Zéro.

AFX_WM_DELETETOOLBAR

Envoyé à la fenêtre principale cadre lorsque l'utilisateur est sur le point de supprimer une barre d'outils dans le mode de personnalisation.

Traitez ce message pour entreprendre des actions supplémentaires lorsque l'utilisateur supprime une barre d'outils dans le mode de personnalisation. Vous devez appeler le gestionnaire par défaut (OnToolbarDelete), ce 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 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 ce message à la fenêtre principale cadre pour récupérer les couleurs de document.

Non utilisé.

[in, out] Pointeur vers un objet CList<COLORREF, COLORREF>.

Zéro.

AFX_WM_GETDRAGBOUNDS

Uniquement réservé à un usage interne.

Non applicable.

Non applicable.

Non applicable.

AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM

Envoyé à la fenêtre principale cadre lorsqu'un utilisateur met en surbrillance un élément de la liste de ruban.

Indice de l'élément surligné.

Un pointeur vers CMFCBaseRibbonElement.

Non utilisé.

AFX_WM_ON_AFTER_SHELL_COMMAND

Envoyé à un parent des contrôles CMFCShellListCtrl ou CMFCShellTreeCtrl lorsqu'un utilisateur a fini d'exécuter une commande d'environnement.

ID de la commande que l'utilisateur a exécutée

Non utilisé.

Si l'application traite les messages, elle devrait retourner zéro.

AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU

L'infrastructure envoie ce message vers le parent du ruban pour qu'il affiche le menu contextuel. Vous pouvez traiter ce message et modifier les menus contextuels à tout moment.

Non utilisé.

Un pointeur vers CMFCBaseRibbonElement.

Non utilisé.

AFX_WM_ON_CANCELTABMOVE

Uniquement réservé à un usage interne.

Non applicable.

Non applicable.

AFX_WM_ON_CHANGE_RIBBON_CATEGORY

L'infrastructure envoie ce message dans le cadre principal lorsque l'utilisateur modifie la catégorie active de contrôle du ruban.

Non utilisé.

Un pointeur vers le CMFCRibbonBar dont la catégorie a changé.

Non utilisé.

AFX_WM_ON_CLOSEPOPUPWINDOW

L'infrastructure envoie ce message pour notifier le propriétaire de CMFCDesktopAlertWnd que la fenêtre va être fermée.

Non utilisé.

Un pointeur vers un objet CMFCDesktopAlertWnd.

Non utilisé.

AFX_WM_ON_DRAGCOMPLETE

Uniquement réservé à un usage interne.

Non applicable.

Non applicable.

Non applicable.

AFX_WM_ON_GET_TAB_TOOLTIP

Envoyé à la fenêtre principale cadre lorsqu'une fenêtre d'onglet est sur le point d'afficher une info-bulle de l'onglet, si les info-bulles personnalisées sont activées.

Non utilisé.

Pointeur vers une structure CMFCTabToolTipInfo.

Non utilisé.

AFX_WM_ON_HSCROLL

Envoyé au contrôle redimensionnable de la barre de contrôle. Traitez ce message pour recevoir des notifications d'objets CMFCTabCtrl lorsqu'un événement de défilement apparaît dans la barre de défilement horizontale de widget à onglets.

Le mot d'ordre réduit 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.

Non utilisé.

Une valeur différente de zéro.

AFX_WM_ON_MOVE_TAB

Envoyé au parent d'une fenêtre avec onglets lorsqu'un utilisateur fait glisser un onglet vers une nouvelle position.

Indice de base zéro de l'onglet dans son emplacement d'origine.

[out] Indice de base zéro de l'onglet dans son nouvel emplacement.

Zéro.

AFX_WM_ON_MOVETABCOMPLETE

Uniquement réservé à un usage interne.

Non applicable.

Non applicable.

Non applicable.

AFX_WM_ON_MOVETOTABGROUP

Envoyé à la fenêtre principale cadre lorsqu'un utilisateur déplace une fenêtre enfant MDI d'un groupe tabulé à un autre.

Un handle à la fenêtre avec onglets (CMFCTabCtrl) de laquelle la fenêtre enfant MDI a été supprimée.

[out] handle de la fenêtre avec onglets(CMFCTabCtrl) à laquelle la fenêtre enfant MDI a été insérée.

Ignoré.

AFX_WM_ON_PRESS_CLOSE_BUTTON

Envoyé à un parent de CDockablePane lorsque l'utilisateur clique sur le bouton Fermer sur la légende de la barre de contrôle.

Non utilisé.

Pointeur vers un volet ancrable dans lequel l'utilisateur a cliqué sur le bouton Fermer.

TRUE si le volet ne peut pas être fermé ; FALSE sinon.

AFX_WM_ON_RENAME_TAB

Envoyé au parent de la fenêtre avec onglets après que l'utilisateur ait renommé un onglet modifiable.

Indice de base zéro de l'onglet renommé.

[out] Pointeur vers la chaîne qui contient le nouveau nom d'onglet.

Une valeur différente de zéro si l'application traite ce message ; l'infrastructure supprimera l'appel à CMFCBaseTabCtrl::SetTabLabel. Si NULL est retourné, alors CMFCBaseTabCtrl::SetTabLabel est appelé par l'infrastructure.

AFX_WM_ON_RIBBON_CUSTOMIZE

Envoyé au cadre parent lorsque l'utilisateur lance la personnalisation. Traitez ce message si vous souhaitez afficher votre propre boîte de dialogue de personnalisation.

Non utilisé.

Pointeur vers le contrôle de ruban à personnaliser.

Une valeur différente 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 intégrée de personnalisation.

AFX_WM_ON_TABGROUPMOUSEMOVE

Uniquement réservé à un usage interne.

Non applicable.

Non applicable.

Non applicable.

AFX_WM_POSTSETPREVIEWFRAME

Envoyé pour notifier 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 la grille des 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

Pointeur vers la propriété (CMFCPropertyGridProperty) qui a changé.

Non utilisé.

AFX_WM_RESETCONTEXTMENU

Envoyé à la fenêtre principale cadre lorsque l'utilisateur réinitialise le menu contextuel de la personnalisation.

Numéro de l'ID du menu de contexte.

Un pointeur au menu de contexte actuel, CMFCPopupMenu.

Non utilisé.

AFX_WM_RESETKEYBOARD

L'infrastructure envoie ce message à la fenêtre principale cadre lorsque l'utilisateur réinitialise toutes les touches d'accès rapides pendant la personnalisation.

Non utilisé.

Non utilisé.

Non utilisé.

AFX_WM_RESETMENU

L'infrastructure envoie le message au propriétaire du menu (une fenêtre cadre) lorsque l'utilisateur réinitialise un menu du cadre d'application pendant la personnalisation

L'ID de ressource menu.

Non utilisé.

Non utilisé.

AFX_WM_RESETPROMPT

L'infrastructure envoie ce message lorsque l'utilisateur réinitialise une barre d'outils de la boîte de dialogue de personnalisation. Le gestionnaire par défaut affiche un message qui vous demande si l'utilisateur souhaite réinitialiser la barre d'outils.

Non utilisé.

Non utilisé.

Non utilisé.

AFX_WM_RESETTOOLBAR

Un objet CMFCToolBar envoie ce message lorsqu'une barre d'outils est restaurée à son état initial, ie chargée à partir des ressources. Traitez ce message pour réinsérer les boutons de la barre d'outils dont les classes sont dérivées de 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 CMFCToolbarMenuButton envoie ce message à son propriétaire lorsque l'utilisateur clique sur un bouton de menu standard. 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 d'écran du curseur. Le mot d'ordre réduit 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 principale cadre lorsque l'utilisateur libère le bouton droit de la souris pendant que le pointeur de la souris est dans la zone cliente ou non cliente d'un volet.

Non utilisé.

Coordonnées écran du pointeur de la souris. Le mot d'ordre réduit spécifie la coordonnée x. Le mot de poids fort spécifie la coordonnée y.

Zéro si l'application traite ce message ; sinon, la valeur est différente de zéro.

AFX_WM_UPDATETOOLTIPS

Diffusé à tous les propriétaires d'info-bulle pour indiquer que les 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 la liste des valeurs possibles.

Non utilisé.

Non utilisé.

AFX_WM_WINDOW_HELP

CMFCWindowsManagerDialog envoie ce message dans le cadre 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 de CMFCWindowsManagerDialog.

Non utilisé.

Le tableau suivant indique les valeurs pour le bas mot du paramètre lParam de la méthode d'AFX_WM_HSCROLL :

Valeur

Signification

SB_ENDSCROLL

L'utilisateur termine le défilement.

SB_LEFT

L'utilisateur défile dans la direction supérieure gauche.

SB_RIGHT

L'utilisateur défile dans la direction bas droite.

SB_LINELEFT

L'utilisateur fait défiler à gauche d'une unité.

SB_LINERIGHT

L'utilisateur fait défiler à droite d'une unité.

SB_PAGELEFT

L'utilisateur fait défiler à gauche de la largeur de la fenêtre.

SB_PAGERIGHT

L'utilisateur fait défiler à droite de la largeur de la fenêtre.

SB_THUMBPOSITION

L'utilisateur a déplacé la case de défilement (curseur de défilement) et laché 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-déplacer.

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 lache le bouton de la souris. Le mot de poids fort indique la position à laquelle la case de défilement a été déplacée.

Remarque Remarque

Le mot de poids fort du paramètre 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, le 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

Afficher:
© 2015 Microsoft