ALT_MSG_MAP

Marque le début d'une table des messages secondaire.

ALT_MSG_MAP( msgMapID )

Paramètres

  • msgMapID
    [in] L'identificateur de la table des messages.

Notes

ATL identifie chaque table des messages par un nombre.La table des messages par défaut (déclarée avec la macro d' BEGIN_MSG_MAP ) est identifiée par 0.Une table des messages secondaire est identifiée par msgMapID.

Les tables des messages sont utilisées pour traiter les messages envoyés vers une fenêtre.Par exemple, CContainedWindow vous permet de spécifier l'identificateur d'une table des messages dans l'objet contenant.CContainedWindow::WindowProc utilise cette table des messages pour exécuter les messages de la fenêtre contenue dans la fonction gestionnaire appropriée ou une autre table des messages.Pour une liste des macros qui déclarent des fonctions gestionnaires, consultez BEGIN_MSG_MAP.

Commencez toujours une table des messages avec BEGIN_MSG_MAP.Vous pouvez déclarer les tables des messages secondaires ultérieures.

La macro d' END_MSG_MAP marque la carte du message.Notez qu'il existe toujours exactement une instance d' BEGIN_MSG_MAP et d' END_MSG_MAP.

Pour plus d'informations sur l'utilisation des tables des messages dans ATL, consultez tables des messages.

Exemple

L'exemple suivant montre la table des messages par défaut et une table des messages secondaire, chaque une fonction gestionnaire conteneur :

BEGIN_MSG_MAP(CMyOneAltClass)
   MESSAGE_HANDLER(WM_PAINT, OnPaint)
ALT_MSG_MAP(1)
   MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
END_MSG_MAP()

L'exemple suivant montre deux tables des messages secondaires.La table des messages par défaut est vide.

BEGIN_MSG_MAP(CMyClass)
ALT_MSG_MAP(1)
   MESSAGE_HANDLER(WM_PAINT, OnPaint)
   MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
ALT_MSG_MAP(2)
   MESSAGE_HANDLER(WM_CREATE, OnCreate)
END_MSG_MAP()

Configuration requise

Header: atlwin.h

Voir aussi

Référence

MESSAGE_HANDLER

Classe de CMessageMap

Classe de CDynamicChain

Autres ressources

Macros de table des messages (ATL)

Macros ATL