ALT_MSG_MAP ( msgMapID )
Paramètres
msgMapID
[en] L'identificateur de message (carte).
Remarques
Marque le début d'une carte de remplacement de message. ATL identifie la carte par un certain nombre de chaque message. La carte de message par défaut (déclarée avec la macro BEGIN_MSG_MAP ) est identifiée par 0. Une carte de remplacement de message est identifiée par msgMapID.
Cartes message sont utilisées pour traiter les messages envoyés à une fenêtre. Par exemple, CContainedWindow vous permet de spécifier l'identificateur d'une carte message dans l'objet contenant. CContainedWindow::WindowProc utilise ensuite cette carte message pour diriger les messages de la fenêtre de contenu à la fonction de gestionnaire d'événements approprié ou à une autre carte de message. Pour une liste de macros que déclarer des fonctions de gestionnaire d'événements, voir BEGIN_MSG_MAP.
Toujours commencer une carte message avec BEGIN_MSG_MAP. Vous pouvez ensuite déclarer message remplaçant les cartes. L'exemple suivant montre la carte de message par défaut et la carte d'un autre message, chacun contenant une fonction de gestionnaire d'événements:
BEGI&N_MSG_MAP(CMyClass)
nbsp ; MESSAGE_HANDLER (WM_PAINT, OnPaint)
ALT_MSG_MAP(1)
MESSAGE_HANDLER (WM_SETFOCUS, OnSetFocus)
END_MSG_MAP()
L'exemple suivant montre deux cartes message remplaçant. La carte de message par défaut est vide.
BEGI&N_MSG_MAP(CMyClass)
ALT_MSG_MAP(1)
nbsp ; MESSAGE_HANDLER (WM_PAINT, OnPaint)
MESSAGE_HANDLER (WM_SETFOCUS, OnSetFocus)
ALT_MSG_MAP(2)
MESSAGE_HANDLER (WM_CREATE, OnCreate)
END_MSG_MAP()
La macro END_MSG_MAP marque la fin de la carte de message. Notez qu'il y a toujours exactement une instance de BEGIN_MSG_MAP et END_MSG_MAP.
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_HANDLER, CMessageMap, CDynamicChain