ALT_MSG_MAP
Contrassegna l'inizio di una mappa messaggi alternativa.
ALT_MSG_MAP( msgMapID )
Parametri
- msgMapID
[in] identificatore della mappa messaggi.
Note
ATL identifica ogni mappa messaggi per un numero.La mappa messaggi predefinita (dichiarata con la macro BEGIN_MSG_MAP ) è identificata da 0.Una mappa messaggi alternativa è identificata da msgMapID.
Le mappe messaggi vengono utilizzate per elaborare i messaggi inviati a una finestra.Ad esempio, CContainedWindow consente di specificare l'identificatore di una mappa messaggi nell'oggetto contenitore.CContainedWindow::WindowProc quindi utilizza questa mappa messaggi per indirizzare i messaggi della finestra contenuta la funzione del gestore appropriato o a un'altra mappa messaggi.Per un elenco di macro che dichiarano le funzioni di gestione, vedere BEGIN_MSG_MAP.
Inizia sempre una mappa messaggi con BEGIN_MSG_MAP.È quindi possibile dichiarare le mappe messaggi alternate successive.
La macro END_MSG_MAP contrassegna la fine della mappa messaggi.Si noti che è sempre esattamente un'istanza BEGIN_MSG_MAP e END_MSG_MAP.
Per ulteriori informazioni sull'utilizzo delle mappe dei messaggi in ATL, vedere Mappe messaggi.
Esempio
Nell'esempio seguente viene illustrata la mappa messaggi predefinita e una mappa messaggi alternativa, ogni una funzione di gestione contenitore:
BEGIN_MSG_MAP(CMyOneAltClass)
MESSAGE_HANDLER(WM_PAINT, OnPaint)
ALT_MSG_MAP(1)
MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
END_MSG_MAP()
Nell'esempio riportato di seguito due mappe messaggi alternate.La mappa messaggi predefinita è vuota.
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()
Requisiti
Header: atlwin.h