ダイアログ ボックス (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 を呼び出す必要があります。