Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz