Функция CallMsgFilter
Функция CallMsgFilter переправляет указанное сообщение и код фильтра (hook) в процедуры фильтров событий, связанных с фильтрамиё WH_SYSMSGFILTER и WH_MSGFILTER. Фильтр-процедура (hook) WH_SYSMSGFILTER или WH_MSGFILTER - это определяемая программой функция повторного вызова, которая проверяет и, необязательно, изменяет сообщения для диалогового окна, окна сообщения, меню или линейки прокрутки.
Синтаксис
BOOL CallMsgFilter( LPMSG lpMsg, int nCode ); |
Параметры
lpMsg
[in] Указатель на структуру MSG, содержащую сообщение, которое передается в фильтр (hook).nCode
[in] Устанавливает определяемый программой код, который используется процедурой фильтра (hook), чтобы решить, как обработать сообщение. Код не может иметь такое же значение, что и определяемые системой коды фильтров (hook) (MSGF_ и HC _), связанных с фильтрами (hook) WH_SYSMSGFILTER и WH_MSGFILTER.Возвращаемое значение
Если приложение будет обрабатывать сообщение дальше, возвращаемое значение равняется нулю.
Если приложение дальше не будет обрабатывать сообщение, возвращаемое значение не нуль.
Замечания
Система вызывает функцию CallMsgFilter, чтобы дать возможность приложениям проверять и управлять потоком сообщений в ходе внутренней обработки данных диалоговых окон, окон сообщения, меню и линеек прокрутки, или когда пользователь активизирует другое окно, нажимая комбинацию клавиш ALT+TAB.
Устанавливайте этот фильтр (hook), используя функцию SetWindowsHookEx.
Windows 95/98/Me: CallMsgFilterW поддерживается программой Microsoft® Layer for Unicode (MSLU). Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для систем Windows 95/98/Me.
Пример
Пример, см. в статье с описанием процедуры фильтров (hook) WH_MSGFILTER и WH_SYSMSGFILTER.
Смотри также
Обзор Фильтр-процедуры (hooks) событий, Функции, используемые фильтр-процедурами (hook), MessageProc, MSG, SetWindowsHookEx, SysMsgProc
|
Размещение и совместимость CallMsgFilter |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |