MESSAGE_HANDLER

MESSAGE_HANDLER ( msg, func )

Paramètres

msg

[en] Le message de Windows.

func

[en] Le nom de la fonction gestionnaire de messages.

Remarques

Définit une entrée dans une carte message. MESSAGE_HANDLER mappe un message Windows à la fonction de gestionnaire d'événements spécifié. Par exemple:

classe CMyClass:...
{
public :
 nbsp ; ...

BEGI&N_MSG_MAP(CMyClass)
      MESSAGE_HANDLER (WM_PAINT, OnPaint)
      ...
   END_MSG_MAP()

/ / Quand un objet CMyClass reçoit un WM_PAINT
   / message, le message est réalisé à
   / / CMyClass::OnPaint pour la réelle transformation.
   OnPaint LRESULT (...)
   { ... }

}

Toute fonction spécifiée dans une macro MESSAGE_HANDLER doit définie comme suit:

LRESULT MessageHandler(UINT uMsg, WP&ARAM wParam, LPARAM lParam, BOOLamp; bHandled)

Les jeux de carte message bHandled vrai avant MessageHandler est appelée. Si MessageHandler ne gère pas entièrement le message, il faut définir bHandled faux pour indiquer le message nécessite un traitement supplémentaire.

&Notenbsp ;  Toujours commencer une carte message avec BEGIN_MSG_MAP. Vous pouvez ensuite déclarer message remplaçant les cartes avec ALT_MSG_MAP. La macro END_MSG_MAP marque la fin de la carte de message. Chaque carte message doit avoir exactement une instance de BEGIN_MSG_MAP et END_MSG_MAP.

En plus de MESSAGE_HANDLER, vous pouvez utiliser COMMAND_HANDLER et NOTIFY_HANDLER à la carte WM_COMMAND et WM_NOTIFY messages, respectivement.

Pour plus d'informations sur l'utilisation des cartes message dans ATL, consultez Message des cartes dans l'article « Classes de fenêtre ATL. »

Les Macros ATL et fonctions globales

Voir aussi

MESSAGE_RANGE_HANDLER

Index