次の方法で共有

ダイアログ ボックス (MSAA UI 要素リファレンス)

  • [アーティクル]

注意

このトピックでは、MSAA UI 要素リファレンスの目的で Dialog Box オブジェクトについて説明します。 さまざまな UI フレームワークで Dialog Box オブジェクトを作成する方法については、ここでは説明しません。 使用している UI フレームワークの API リファレンス ドキュメントを参照してください。

ダイアログ ボックスは、アプリケーションがユーザー入力を取得するために作成する一時的なウィンドウです。 アプリケーションでは、ダイアログ ボックスを使用して、ユーザーがメニューから選択したコマンドに関する追加情報をユーザーに求めます。 ダイアログ ボックスには、ユーザーがテキストを入力したり、オプションを選択したり、コマンドのアクションを指示したりする 1 つ以上のコントロール (子ウィンドウ) が含まれています。

ダイアログ ボックスのウィンドウ クラス名は "#32770" です。

IAccessible メソッド

ダイアログ ボックスでは、次の IAccessible メソッドがサポートされています。

メソッド 説明
accDoDefaultAction ダイアログ ボックスに既定のプッシュ ボタンが含まれている場合、 accDoDefaultAction メソッドは PostMessage を呼び出し、 BM_CLICK ボタン メッセージを使用して既定のプッシュ ボタンをクリックします。
accHitTest
accLocation
accNavigate
accSelect

IAccessible プロパティ

ダイアログ ボックスでは、次の IAccessible プロパティが サポートされています。

プロパティ 説明
get_accChildCount ChildCount プロパティは、ダイアログ ボックスの子ウィンドウ コントロールの数と同じです。
get_accDefaultAction ダイアログ ボックスに既定のプッシュ ボタンが含まれている場合、 DefaultAction プロパティは "Press" です。
get_accFocus
get_accKeyboardShortcut 通常、ダイアログ ボックスにはキーボード ショートカットがありません。 ダイアログ ボックスのウィンドウ テキストにアンパサンド (&) 文字が含まれている場合、Microsoft Active Accessibility は KeyboardShortcut プロパティとして Null 以外の文字列を返します。
get_accName Name プロパティは、ダイアログ ボックスのタイトル バーに表示されるウィンドウ テキスト (キャプション) です。
get_accParent Parent プロパティは、ダイアログ ボックスを囲み、ダイアログ ボックスと同じ Name プロパティとウィンドウ クラス名を持つウィンドウ ( ROLE_SYSTEM_WINDOW ) です。
get_accRole Role プロパティがROLE_SYSTEM_DIALOGまたはROLE_SYSTEM_PROPERTYPAGE。
get_accState State プロパティは、次の値の 1 つ以上の組み合わせです:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE

解説

ダイアログ オブジェクトは 、get_accChild メソッドをサポートしていません。 ダイアログ ボックス上のコントロールへの IAccessible インターフェイス ポインターを取得するには、クライアントがコントロールのウィンドウ ハンドルを取得し、 AccessibleObjectFromWindow を呼び出す必要があります。

IAccessible インターフェイス