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 によって返され、フック関数の各インスタンスに固有です。
event
型: DWORD
発生したイベントを指定します。 この値は 、イベント定数の 1 つです。
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 を含む) |
再頒布可能パッケージ | WINDOWS NT 4.0 SP6 以降および Windows 95 でのアクティブなアクセシビリティ 1.3 RDK |