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

関連項目

SetWinEventHook