イベント定数 (Winuser.h)
このトピックでは、オペレーティング システムとサーバー アプリケーションによって生成されるイベントについて説明します。 定数はアルファベット順に一覧表示されます。
これらのイベントを使用する前に、クライアント アプリケーションは Accessible Event Watcher を使用して、これらのイベントが UI 要素によって使用されていることを確認する必要があります。
イベント全般の詳細については、「 WinEvents とは」 および 「システム レベルおよびオブジェクト レベルのイベント」を参照してください。 システムによって送信されるイベントの詳細については、「 付録 A: サポートされているユーザー インターフェイス要素リファレンス」を参照してください。
定数/値 | Description |
---|---|
|
業界全体で使用するアクセシビリティ相互運用性アライアンス (AIA) で指定された WinEvent 定数値の範囲。 詳細については、「 WinEvent ID の割り当て」を参照してください。 |
|
可能な最小および最高のイベント値。 |
|
オブジェクトの KeyboardShortcut プロパティ が変更されました。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 |
|
ウィンドウがクロークされたときに送信されます。 クロークされたウィンドウは引き続き存在しますが、ユーザーには見えません。 |
|
ウィンドウ オブジェクトのスクロールが終了しました。
EVENT_SYSTEM_SCROLLENDとは異なり、このイベントはスクロール ウィンドウに関連付けられています。 スクロールが水平スクロールか垂直スクロールかにかかわらず、スクロール アクションが完了するたびにこのイベントが送信されます。 WinEventProc コールバック関数の hwnd パラメーターは、スクロール ウィンドウを記述します。idObject パラメーターがOBJID_CLIENTされ、idChild パラメーターがCHILDID_SELF。 |
|
オブジェクトが作成されました。 このイベントは、キャレット、ヘッダー コントロール、リスト ビュー コントロール、タブ コントロール、ツール バー コントロール、ツリー ビューコントロール、ウィンドウ オブジェクトのユーザー インターフェイス要素に対して送信されます。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 親オブジェクトのイベントを送信する前に、サーバーはオブジェクトのすべての子オブジェクトに対してイベントを送信する必要があります。 サーバーは、親オブジェクトがこのイベントを送信する前に、すべての子オブジェクトが完全に作成され、クライアントからの IAccessible 呼び出しを受け入れる準備ができていることを確認する必要があります。 親オブジェクトは子オブジェクトの後に作成されるため、クライアントは IAccessible::get_accParent を呼び出す前に、特にコンテキスト内フック関数が使用される場合に、オブジェクトの親が作成されていることを確認する必要があります。 |
|
オブジェクトの DefaultAction プロパティ が変更されました。 システムは、ダイアログ ボックスにこのイベントを送信します。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 |
|
オブジェクトの Description プロパティ が変更されました。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 |
|
オブジェクトが破棄されました。 このイベントは、キャレット、ヘッダー コントロール、リスト ビュー コントロール、タブ コントロール、ツール バー コントロール、ツリー ビュー コントロール、ウィンドウ オブジェクトのユーザー インターフェイス要素に対して送信されます。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 クライアントは、親オブジェクトがこのイベントを送信すると、オブジェクトのすべての子が破棄されると想定します。 このイベントを受信した後、クライアントはオブジェクトの IAccessible プロパティまたはメソッドを呼び出しません。 ただし、インターフェイス ポインターは、(COM ルールが原因で) 参照カウントがある限り有効なままである必要がありますが、UI 要素が存在しなくなる可能性があります。 インターフェイス ポインターのそれ以上の呼び出しは、エラー エラーを返す可能性があります。これを防ぐために、サーバーは プロキシ オブジェクトを作成 し、その有効期間を監視します。 |
|
ユーザーが要素のドラッグを開始しました。
WinEventProc コールバック関数の hwnd、idObject、idChild パラメーターは、ドラッグされるオブジェクトを識別します。 |
|
ユーザーは、ドロップ ターゲットにドラッグされた要素をドロップする前に、ドラッグ操作を終了しました。
WinEventProc コールバック関数の hwnd、idObject、idChild パラメーターは、ドラッグされるオブジェクトを識別します。 |
|
ユーザーがドロップ ターゲット上の要素を削除しました。
WinEventProc コールバック関数の hwnd、idObject、idChild パラメーターは、ドラッグされるオブジェクトを識別します。 |
|
ユーザーがドロップ ターゲットの境界に要素をドラッグしました。
WinEventProc コールバック関数の hwnd、idObject、idChild パラメーターは、ドロップ ターゲットを識別します。 |
|
ユーザーがドロップ ターゲットの境界から要素をドラッグしました。
WinEventProc コールバック関数の hwnd、idObject、idChild パラメーターは、ドロップ ターゲットを識別します。 |
|
ユーザーがドロップ ターゲット上の要素を削除しました。
WinEventProc コールバック関数の hwnd、idObject、idChild パラメーターは、ドロップ ターゲットを識別します。 |
|
オブジェクト のイベント値の最大値。 |
|
オブジェクトがキーボード フォーカスを受け取りました。 システムは、リスト ビュー コントロール、メニュー バー、ポップアップ メニュー、スイッチ ウィンドウ、タブ コントロール、ツリー ビュー コントロール、およびウィンドウ オブジェクトのユーザー インターフェイス要素に対してこのイベントを送信します。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 WinEventProc コールバック関数の hwnd パラメーターは、キーボード フォーカスを受け取るウィンドウを識別します。 |
|
オブジェクトの Help プロパティ が変更されました。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 |
|
オブジェクトが非表示になりました。 このイベントは、キャレットとカーソルのユーザー インターフェイス要素に対して送信されます。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 親オブジェクトに対してこのイベントが生成されると、すべての子オブジェクトは既に非表示になっています。 サーバー アプリケーションは、子オブジェクトに対してこのイベントを送信しません。 非表示のオブジェクトには 、STATE_SYSTEM_INVISIBLE フラグが含まれます。表示されるオブジェクトには、このフラグは含まれません。 EVENT_OBJECT_HIDE イベントは、STATE_SYSTEM_INVISIBLE フラグが設定されていることも示します。 そのため、この場合、サーバーは EVENT_OBJECT_STATECHANGE イベントを送信しません。 |
|
他のアクセス可能なオブジェクトをホストするウィンドウによって、ホストされているオブジェクトが変更されました。 クライアントがホスト ウィンドウからイベントを監視している場合は特に、新しいホストされたオブジェクトを検出するために、クライアントがホスト ウィンドウに対してクエリを実行する必要がある場合があります。 ホステッド オブジェクトは、ホストとは異なるアクセシビリティ フレームワーク (MSAA または UI オートメーション) のオブジェクトです。 ホストと同じフレームワークからのホステッド オブジェクトの変更は、MSAA の EVENT_OBJECT_CREATE などの構造変更イベントと共に渡す必要があります。 詳細については、winuser.h 内のコメントを参照してください。 |
|
IME ウィンドウが非表示になりました。 |
|
IME ウィンドウが表示されます。 |
|
IME ウィンドウのサイズまたは位置が変更されました。 |
|
オブジェクトが呼び出されました。たとえば、ユーザーがボタンをクリックしたとします。 このイベントは一般的なコントロールでサポートされており、UI オートメーションで使用されます。 このイベントの場合、WinEventProc コールバック関数の hwnd、ID、idChild パラメーターは、呼び出される項目を識別します。 |
|
ライブ領域の一部であるオブジェクトが変更されました。 ライブ リージョンは、アプリケーションの領域であり、頻繁に変更または非同期的に変更されます。 |
|
オブジェクトの位置、形、またはサイズが変更されました。 システムは、次のユーザー インターフェイス要素に対してこのイベントを送信します: キャレット オブジェクトとウィンドウ オブジェクト。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 このイベントは、オブジェクト階層内の最上位オブジェクトの変更に応じて生成されます。オブジェクトに含まれる可能性のある子に対しては生成されません。 たとえば、ユーザーがウィンドウのサイズを変更した場合、システムはウィンドウに対してこの通知を送信しますが、メニュー バー、タイトル バー、スクロール バー、その他の変更されたオブジェクトについては送信しません。 システムは、親ウィンドウが移動したときに、その子である非フローティング ウィンドウのそれぞれにイベントを送信することはありません。 ただし、親ウィンドウのサイズを変更した結果、アプリケーションが子ウィンドウのサイズを明示的に変更した場合、システムはサイズ変更された子に対して複数のイベントを送信します。 オブジェクトの State プロパティ が STATE_SYSTEM_FLOATING に設定されている場合、サーバーはオブジェクトが場所を変更するたびに EVENT_OBJECT_LOCATIONCHANGE を送信します。 オブジェクトにこの状態がない場合、サーバーはこのイベントをトリガーするのは、オブジェクトがその親に関連して移動した場合のみです。 このイベント通知では、WinEventProc コールバック関数の idChild パラメーターによって、変更された子オブジェクトが識別されます。 |
|
オブジェクトの Name プロパティ が変更されました。 システムは、チェック ボックス、カーソル、リスト ビュー コントロール、プッシュ ボタン、ラジオ ボタン、ステータス バー コントロール、ツリー ビュー コントロール、ウィンドウ オブジェクトのユーザー インターフェイス要素に対してこのイベントを送信します。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 |
|
オブジェクトに新しい親オブジェクトが設定されました。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 |
|
コンテナー オブジェクトで子オブジェクトが追加、削除、または並べ替えされました。 このイベントは、ヘッダー コントロール、リスト ビュー コントロール、ツール バー コントロール、ウィンドウ オブジェクトのユーザー インターフェイス要素に対して送信されます。 サーバー アプリケーションは、所有するユーザー補助オブジェクトに適宜にこのイベントを送信します。 たとえば、このイベントは、子要素の数または要素の順序が変更されたときに、リスト ビュー オブジェクトによって生成されます。 このイベントは、子ウィンドウの Z オーダーが変更されたときにも親ウィンドウによって送信されます。 |
|
コンテナー オブジェクト内の選択が変更されました。 システムは、リスト ビュー コントロール、タブ コントロール、ツリー ビュー コントロール、およびウィンドウ オブジェクトのユーザー インターフェイス要素に対してこのイベントを送信します。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 このイベントは、1 つの選択を通知します。以前は選択した子が含まれていないコンテナーで子が選択されているか、選択内容が 1 つの子から別の子に変更されています。 WinEventProc コールバック関数の hwnd パラメーターと idObject パラメーターは、コンテナーを記述します。idChild パラメーターは、選択されているオブジェクトを識別します。 選択した子がオブジェクトも含むウィンドウである場合、 idChild パラメーターは OBJID_WINDOW。 |
|
コンテナー オブジェクト内の子が既存の選択範囲に追加されました。 システムは、リスト ボックス、リスト ビュー コントロール、ツリー ビュー コントロールのユーザー インターフェイス要素に対してこのイベントを送信します。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 WinEventProc コールバック関数の hwnd パラメーターと idObject パラメーターは、コンテナーを記述します。 idChild パラメーターは、選択範囲に追加される子です。 |
|
コンテナー オブジェクト内の項目が選択範囲から削除されました。 システムは、リスト ボックス、リスト ビュー コントロール、ツリー ビュー コントロールのユーザー インターフェイス要素に対してこのイベントを送信します。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 このイベントは、子が既存の選択範囲から削除されたことを通知します。 WinEventProc コールバック関数の hwnd パラメーターと idObject パラメーターは、コンテナーを記述します。idChild パラメーターは、選択範囲から削除された子を識別します。 |
|
コンテナー オブジェクト内で多数の選択変更が行われました。 システムは、リスト ボックスに対してこのイベントを送信します。サーバー アプリケーションは、アクセス可能なオブジェクトに対して送信します。 このイベントは、コントロール内で選択された項目が大幅に変更されたときに送信されます。 イベントは、多数の選択変更が発生したことをクライアントに通知し、複数の EVENT_OBJECT_SELECTIONADD または EVENT_OBJECT_SELECTIONREMOVE イベントの代わりに送信されます。 クライアントは、コンテナー オブジェクトの IAccessible::get_accSelection メソッドを呼び出し、選択した項目を列挙することで、選択した項目に対してクエリを実行します。 このイベント通知では、WinEventProc コールバック関数の hwnd パラメーターと idObject パラメーターによって、変更が発生したコンテナーが記述されます。 |
|
非表示のオブジェクトが表示されます。 システムは、カレット、カーソル、ウィンドウ オブジェクトの各ユーザー インターフェイス要素にこのイベントを送信します。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 クライアントは、このイベントが親オブジェクトによって送信されると、すべての子オブジェクトが既に表示されていることを前提としています。 そのため、サーバー アプリケーションは子オブジェクトに対してこのイベントを送信しません。 非表示のオブジェクトには 、STATE_SYSTEM_INVISIBLE フラグが含まれます。表示されるオブジェクトには、このフラグは含まれません。 EVENT_OBJECT_SHOW イベントは、STATE_SYSTEM_INVISIBLE フラグがクリアされていることを示します。 そのため、この場合、サーバーは EVENT_OBJECT_STATECHANGE イベントを送信しません。 |
|
オブジェクトの状態が変更されました。 システムは、チェック ボックス、コンボ ボックス、ヘッダー コントロール、プッシュ ボタン、ラジオ ボタン、スクロール バー、ツール バー コントロール、ツリー ビュー コントロール、アップダウン コントロール、ウィンドウ オブジェクトのユーザー インターフェイス要素に対してこのイベントを送信します。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 たとえば、ボタン オブジェクトがクリックまたは解放されたとき、またはオブジェクトが有効または無効になっている場合に、状態の変更が発生します。 このイベント通知では、WinEventProc コールバック関数の idChild パラメーターによって、状態が変更された子オブジェクトが識別されます。 |
|
IME コンポジション内の変換ターゲットが変更されました。 変換ターゲットは、ユーザーが開始する変換のターゲットとしてアクティブに選択される IME コンポジションのサブセットです。 |
|
オブジェクトのテキスト選択が変更されました。 このイベントは一般的なコントロールでサポートされており、UI オートメーションで使用されます。 WinEventProc コールバック関数の hwnd、ID、idChild パラメーターは、更新されたテキスト選択に含まれる項目を記述します。 |
|
ウィンドウが開かれたときに送信されます。 クロークされたウィンドウは引き続き存在しますが、ユーザーには見えません。 |
|
オブジェクトの Value プロパティ が変更されました。 システムは、スクロール バーと次のコントロールを含むユーザー インターフェイス要素に対してこのイベントを送信します。編集、ヘッダー、ホット キー、進行状況バー、スライダー、アップダウン。 サーバー アプリケーションは、所有するユーザー補助オブジェクトにこのイベントを送信します。 |
|
OEM 用に予約されているイベント定数値の範囲。 詳細については、「 WinEvent ID の割り当て」を参照してください。 |
|
アラートが生成されました。 サーバー アプリケーションでは、このイベントを送信しないでください。 |
|
プレビューの四角形が表示されています。 |
|
ウィンドウがマウスのキャプチャを失いました。 このイベントはシステムによって送信され、サーバーによって送信されることはありません。 |
|
ウィンドウがマウス キャプチャを受け取った。 このイベントはシステムによって送信され、サーバーによって送信されることはありません。 |
|
ウィンドウが状況依存のヘルプ モードを終了しました。 このイベントは、システムによって一貫して送信されません。 |
|
ウィンドウが状況依存のヘルプ モードに入った。 このイベントは、システムによって一貫して送信されません。 |
|
アクティブなデスクトップが切り替わりました。 |
|
ダイアログ ボックスが閉じられました。 システムは、標準のダイアログ ボックスに対してこのイベントを送信します。サーバーからカスタム ダイアログ ボックス用に送信されます。 このイベントは、システムによって一貫して送信されません。 |
|
ダイアログ ボックスが表示されました。 このイベントは、リソース テンプレートまたは Win32 ダイアログ ボックス関数を使用して作成される標準のダイアログ ボックスに対して送信されます。 サーバーはカスタム ダイアログ ボックスに対してこのイベントを送信します。これは、ダイアログ ボックスとして機能するウィンドウですが、標準の方法では作成されません。 このイベントは、システムによって一貫して送信されません。 |
|
アプリケーションが、ドラッグ アンド ドロップ モードを終了しようとしています。 ドラッグ アンド ドロップ操作をサポートするアプリケーションでは、このイベントを送信する必要があります。システムはこのイベントを送信しません。 |
|
アプリケーションが、ドラッグ アンド ドロップ モードに入ろうとしています。 ドラッグ アンド ドロップ操作をサポートするアプリケーションは、システムから送信されないため、このイベントを送信する必要があります。 |
|
システム イベントの最大値。 |
|
フォアグラウンド ウィンドウが変更されました。 フォアグラウンド ウィンドウが同じスレッド内の別のウィンドウに変更された場合でも、システムはこのイベントを送信します。 サーバー アプリケーションがこのイベントを送信することはありません。 このイベントの場合、 WinEventProc コールバック関数の hwnd パラメーターは、フォアグラウンドにあるウィンドウへのハンドル、 idObject パラメーターが OBJID_WINDOW、 idChild パラメーターが CHILDID_SELF。 |
|
ポップアップ メニューが閉じられました。 システムは標準メニューに対してこのイベントを送信します。サーバーからカスタム メニュー用に送信されます。 ポップアップ メニューが閉じられると、クライアントはこのメッセージを受け取り、 EVENT_SYSTEM_MENUEND イベントを受け取ります。 このイベントは、システムによって一貫して送信されません。 |
|
ポップアップ メニューが表示されています。 システムは、 HMENU によって識別される標準メニューに対してこのイベントを送信し、メニュー テンプレート リソースまたは Win32 メニュー関数を使用して作成されます。 サーバーはカスタム メニューに対してこのイベントを送信します。これは、メニューとして機能するユーザー インターフェイス要素ですが、標準の方法では作成されません。 このイベントは、システムによって一貫して送信されません。 |
|
メニュー バーのメニューが閉じられました。 システムは標準メニューに対してこのイベントを送信します。サーバーからカスタム メニュー用に送信されます。 このイベントの場合、 WinEventProc コールバック関数の hwnd、 idObject、 idChild パラメーターは、メニュー バーを含むコントロール、またはコンテキスト メニューをアクティブにするコントロールを参照します。 hwnd パラメーターは、イベントに関連するウィンドウへのハンドルです。 idObject パラメーターは、メニューのOBJID_MENUまたはOBJID_SYSMENU、またはポップアップ メニューのOBJID_WINDOWです。 idChild パラメーターがCHILDID_SELF。 |
|
メニュー バーのメニュー項目が選択されています。 システムは、メニュー テンプレート リソースまたは Win32 メニュー API 要素を使用して作成された 、HMENU によって識別される標準メニューに対してこのイベントを送信します。 サーバーはカスタム メニューに対してこのイベントを送信します。これは、メニューとして機能するユーザー インターフェイス要素ですが、標準の方法では作成されません。 このイベントの場合、 WinEventProc コールバック関数の hwnd、 idObject、および idChild パラメーターは、メニュー バーを含むコントロール、またはコンテキスト メニューをアクティブにするコントロールを参照します。 hwnd パラメーターは、イベントに関連するウィンドウへのハンドルです。 idObject パラメーターは、メニューのOBJID_MENUまたはOBJID_SYSMENU、またはポップアップ メニューのOBJID_WINDOWです。 idChild パラメーターがCHILDID_SELF。 システムは、 EVENT_SYSTEM_MENUEND イベントに 常に対応するとは限らない複数の EVENT_SYSTEM_MENUSTART イベントをトリガーします。 |
|
ウィンドウ オブジェクトが復元されようとしています。 このイベントはシステムによって送信され、サーバーによって送信されることはありません。 |
|
ウィンドウ オブジェクトが最小化されようとしています。 このイベントはシステムによって送信され、サーバーによって送信されることはありません。 |
|
ウィンドウの移動またはサイズ変更が完了しました。 このイベントはシステムによって送信され、サーバーによって送信されることはありません。 |
|
ウィンドウが移動またはサイズ変更されます。 このイベントはシステムによって送信され、サーバーによって送信されることはありません。 |
|
スクロール バーでスクロールが終了しました。 このイベントは、標準のスクロール バー コントロールと、ウィンドウに接続されているスクロール バーに対して、システムによって送信されます。 サーバーはカスタム スクロール バーに対してこのイベントを送信します。これは、スクロール バーとして機能するユーザー インターフェイス要素ですが、標準の方法では作成されません。 WinEventProc コールバック関数に送信される idObject パラメーターは、水平スクロール バーの場合はOBJID_HSCROLL、垂直スクロール バーの場合はOBJID_VSCROLLです。 |
|
スクロール バーでスクロールが開始しました。 システムは、標準のスクロール バー コントロールとウィンドウにアタッチされているスクロール バーに対して、このイベントを送信します。 サーバーはカスタム スクロール バーに対してこのイベントを送信します。これは、スクロール バーとして機能するユーザー インターフェイス要素ですが、標準の方法では作成されません。 WinEventProc コールバック関数に送信される idObject パラメーターは、水平スクロール バーの場合はOBJID_HSCROLL、垂直スクロール バーの場合はOBJID_VSCROLLです。 |
|
サウンドが再生されました。 このイベントは、(たとえば、サウンド ファイルやサウンド カードがないため) 音が聞こえない場合でも、メニュー用のサウンドなどのシステム サウンドが再生されたときに送信されます。 サーバーは、カスタム UI 要素によってサウンドが生成されるたびに、このイベントを送信します。 このイベントの場合、WinEventProc コールバック関数は idObject パラメーターとしてOBJID_SOUND値を受け取ります。 |
|
ユーザーが Alt + TAB キーを押した。 このイベントはシステムによって送信され、サーバーによって送信されることはありません。
WinEventProc コールバック関数の hwnd パラメーターは、ユーザーが切り替えたウィンドウを識別します。 ユーザーが Alt キーを押しながら Tab キーを押したときに 1 つのアプリケーションのみが実行されている場合、システムは対応する EVENT_SYSTEM_SWITCHSTART イベントなしでこのイベントを送信します。 |
|
ユーザーが Alt キーを押しながら Tab キーを押すと、スイッチ ウィンドウがアクティブになります。 このイベントはシステムによって送信され、サーバーによって送信されることはありません。
WinEventProc コールバック関数の hwnd パラメーターは、ユーザーが切り替えるウィンドウを識別します。 ユーザーが Alt キーを押しながら Tab キーを押したときに 1 つのアプリケーションのみが実行されている場合、システムは対応する EVENT_SYSTEM_SWITCHSTART イベントなしで EVENT_SYSTEM_SWITCHEND イベントを送信します。 |
|
UI オートメーション イベント識別子用に予約されているイベント定数値の範囲。 詳細については、「 WinEvent ID の割り当て」を参照してください。 |
|
UI オートメーション のプロパティ変更イベント識別子用に予約されているイベント定数値の範囲。 詳細については、「 WinEvent ID の割り当て」を参照してください。 |
要件
要件 | 値 |
---|---|
ヘッダー |
|