Partager via


ON_MESSAGE

Indique qui fonctionnent traiteront un message défini par l'utilisateur.

ON_MESSAGE(message, memberFxn)

Paramètres

  • message
    ID du message.

  • memberFxn
    Le nom de la fonction gestionnaire de messages à laquelle le message est mappé.

    Le type de la fonction doit être afx_msg LRESULT (CWnd::*)(WPARAM, LPARAM).

Notes

Les messages définis par l'utilisateur sont tous des messages qui ne sont pas des messages standard d' WM_MESSAGE windows.En sélectionnant un ID de message, vous devez utiliser des valeurs dans la marge des WM_USER (0x0400) à 0x7FFF ou à WM_APP (0x8000) à 0xBFFF.Pour plus d'informations sur les ID de message, consultez WM_APP.

Il doit y avoir exactement une macro instruction d' ON_MESSAGE dans votre table des messages pour chaque message défini par l'utilisateur qui doit être mappé à une fonction gestionnaire de messages.

[!REMARQUE]

Outre les messages définis par l'utilisateur, ON_MESSAGE traite moins de messages communs windows.Pour plus d'informations, consultez l'article de la Base de 99848 : INFO : Macro de l'utilisation ON_ MESSAGE() pour mapper les messages de la moins couranteconnaissances.

Pour plus d'informations et d'exemples, consultez Rubriques de gestion des messages et de mappage et l' Gestionnaires définis par l'utilisateur

Exemple

#define WM_MYMESSAGE (WM_USER + 100)
BEGIN_MESSAGE_MAP(CMyWnd2, CWnd)
   ON_MESSAGE(WM_MYMESSAGE, OnMyMessage)
END_MESSAGE_MAP()
// inside the class declaration
 afx_msg LRESULT OnMyMessage(WPARAM wParam, LPARAM lParam);
LRESULT CMyWnd2::OnMyMessage(WPARAM wParam, LPARAM lParam)
{
   UNREFERENCED_PARAMETER(wParam);
   UNREFERENCED_PARAMETER(lParam);

   // Handle message here.

   return 0;
}

Configuration requise

Header: afxmsg_.h

Voir aussi

Référence

ON_UPDATE_COMMAND_UI

ON_CONTROL

ON_REGISTERED_MESSAGE

ON_COMMAND

Concepts

Macro MFC et Globals