Функция обратного вызова WINEVENTPROC (winuser.h)

Статья
08/27/2023

Определяемая приложением функция обратного вызова (или перехватчика), которую система вызывает в ответ на события, созданные доступным объектом. Функция-перехватчик обрабатывает уведомления о событиях по мере необходимости. Клиенты устанавливают функцию перехватчика и запрашивают определенные типы уведомлений о событиях, вызывая SetWinEventHook.

Тип WINEVENTPROC определяет указатель на эту функцию обратного вызова. WinEventProc — это заполнитель для имени функции, определяемой приложением.

Синтаксис

WINEVENTPROC Wineventproc;

void Wineventproc(
  HWINEVENTHOOK hWinEventHook,
  DWORD event,
  HWND hwnd,
  LONG idObject,
  LONG idChild,
  DWORD idEventThread,
  DWORD dwmsEventTime
)
{...}

Параметры

hWinEventHook

Тип: HWINEVENTHOOK

Дескриптор функции перехватчика событий. Это значение возвращается SetWinEventHook при установке функции-перехватчика и зависит от каждого экземпляра функции-перехватчика.

event

Тип: DWORD

Указывает событие, которое произошло. Это значение является одной из констант событий.

hwnd

Тип: HWND

Дескриптор окна, создающего событие, или значение NULL , если с событием не связано ни окно. Например, указатель мыши не связан с окном.

idObject

Тип: LONG

Идентифицирует объект, связанный с событием. Это один из идентификаторов объекта или пользовательский идентификатор объекта.

idChild

Тип: LONG

Определяет, было ли событие активировано объектом или дочерним элементом объекта . Если это значение CHILDID_SELF, событие было активировано объектом ; в противном случае это значение является дочерним идентификатором элемента, который активировал событие.

idEventThread

dwmsEventTime

Тип: DWORD

Указывает время создания события в миллисекундах.

Возвращаемое значение

None

Remarks

В функции-перехватчике при вызове AccessibleObjectFromEvent используются параметры hwnd, idObject и idChild.

Серверы создают события, вызывая NotifyWinEvent.

Создайте несколько функций обратного вызова для обработки различных событий. Дополнительные сведения см. в разделе Регистрация функции перехватчика.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Распространяемые компоненты	Активные специальные возможности 1.3 RDK в Windows NT 4.0 с пакетом обновления 6 (SP6) и более поздних версий и Windows 95

См. также раздел

SetWinEventHook

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