WINEVENTPROC 콜백 함수(winuser.h)
액세스 가능한 개체에서 생성된 이벤트에 대한 응답으로 시스템이 호출하는 애플리케이션 정의 콜백(또는 후크) 함수입니다. 후크 함수는 필요에 따라 이벤트 알림을 처리합니다. 클라이언트는 SetWinEventHook를 호출하여 후크 함수를 설치하고 특정 유형의 이벤트 알림을 요청합니다.
WINEVENTPROC 형식은 이 콜백 함수에 대한 포인터를 정의합니다. WinEventProc 은 애플리케이션 정의 함수 이름의 자리 표시자입니다.
구문
WINEVENTPROC Wineventproc;
void Wineventproc(
HWINEVENTHOOK hWinEventHook,
DWORD event,
HWND hwnd,
LONG idObject,
LONG idChild,
DWORD idEventThread,
DWORD dwmsEventTime
)
{...}
매개 변수
hWinEventHook
형식: HWINEVENTHOOK
이벤트 후크 함수에 대한 핸들입니다. 이 값은 후크 함수가 설치될 때 SetWinEventHook에서 반환되며 후크 함수의 각 instance 관련이 있습니다.
event
형식: DWORD
발생한 이벤트를 지정합니다. 이 값은 이벤트 상수 중 하나입니다.
hwnd
형식: HWND
이벤트를 생성하는 창에 대한 핸들이거나, 이벤트와 연결된 창이 없는 경우 NULL 입니다. 예를 들어 마우스 포인터는 창과 연결되지 않습니다.
idObject
형식: LONG
이벤트와 연결된 개체를 식별합니다. 개체 식별자 또는 사용자 지정 개체 ID 중 하나입니다.
idChild
형식: LONG
이벤트가 개체 또는 개체의 자식 요소에 의해 트리거되었는지 여부를 식별합니다. 이 값이 CHILDID_SELF 경우 개체에 의해 이벤트가 트리거되었습니다. 그렇지 않으면 이 값은 이벤트를 트리거한 요소의 자식 ID입니다.
idEventThread
dwmsEventTime
형식: DWORD
이벤트가 생성된 시간(밀리초)을 지정합니다.
반환 값
없음
설명
후크 함수 내에서 accessibleObjectFromEvent를 호출할 때 hwnd, idObject 및 idChild 매개 변수가 사용됩니다.
서버는 NotifyWinEvent를 호출하여 이벤트를 생성합니다.
여러 콜백 함수를 만들어 다른 이벤트를 처리합니다. 자세한 내용은 후크 함수 등록을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 재배포 가능 파일 | Sp6 이상 및 Windows 95를 사용하여 Windows NT 4.0의 활성 접근성 1.3 RDK |