Поделиться через


ALT_MSG_MAP

Отмечает начало другого сопоставления сообщения.

ALT_MSG_MAP( msgMapID )

Параметры

  • msgMapID
    [in] Идентификатор сопоставления сообщения.

Заметки

Библиотеки ATL определяет каждое сопоставление сообщения. Сопоставление по умолчанию, объявленное с макросом BEGIN_MSG_MAP сообщения () указан 0. Другое сопоставление сообщения задается msgMapID.

Сопоставления сообщений используются для обработки сообщения, отправляемые окно. Например, CContainedWindow позволяет указать идентификатор сопоставления сообщения в содержащем объекте. CContainedWindow::WindowProc затем использует это сопоставление сообщения для направления сообщений, которые содержат окна или к соответствующей функции обработчика или в другое сопоставление сообщения. Список макросов, которые объявляют функции обработчика см. в разделе BEGIN_MSG_MAP.

Всегда начинайте сопоставления сообщения с BEGIN_MSG_MAP. Затем можно объявить последующие другие сопоставления сообщения.

Макрос END_MSG_MAP отмечает конец сопоставления сообщения. Обратите внимание, что всегда ровно один экземпляр BEGIN_MSG_MAP и END_MSG_MAP.

Дополнительные сведения об использовании сопоставления сообщения в библиотеке ATL см. в разделе сопоставления сообщения.

Пример

В следующем примере показано сопоставление по умолчанию сообщения и одно другое сопоставление сообщения, каждую, содержащий одну функцию обработчика.

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

В следующем примере показан 2 других сопоставления сообщения. По умолчанию сопоставление сообщения пустое.

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()

Требования

Header: atlwin.h

См. также

Ссылки

MESSAGE_HANDLER

CMessageMap Class

CDynamicChain Class

Другие ресурсы

Message Map Macros (ATL)

Макросы ATL