よく使う要素のプロパティ
この記事の内容
要素の具体的な分類は、要素の編集部分で確認してください。以下に示すように、要素の最後のノードにuiaと表示されている場合、その要素はUIA要素です。他の要素も同様です。
以下は、UIA要素、ACC要素、JAVA要素を含む、よく使う要素のプロパティです。
UIA要素
- Name: オブジェクトまたはコントロールの名前です。通常は、ユーザーに表示されるラベルやタイトルです。
- ControlType: UI要素の種類を示します。例えば、ボタン、スクロールバー、チェックボックスなどは、それぞれ異なるコントロールの種類です。
- LocalizedControlType: ControlTypeをローカライズしたものです。例えば、英語のシステムではボタンのControlTypeが"button"であるのに対し、フランス語のシステムでは同じボタンのLocalizedControlTypeが"bouton"になる場合があります。
- BoundingRectangle: UI要素の位置とサイズを表します。左上と右下の座標を含む矩形で、これらの座標によって画面上のUI要素の位置が指定されます。
- IsEnabled: UI要素をユーザーが操作できるかどうかを示すブール値です。ボタンが無効になっている場合(例えば、ユーザーが必要な操作をまだ完了していない場合)、IsEnabledはFalseになります。
- IsOffscreen: これもブール値で、UI要素が画面外にあるかどうかを示します。スクロールするウィンドウや非表示の要素を処理する際に特に役立ちます。
- IsKeyboardFocusable: ユーザーがキーボードを使用してこのUI要素にフォーカスを移動できるかどうかを示すブール値です。
- HasKeyboardFocus: このUI要素が現在キーボードフォーカスを持っているかどうかを示すブール値です。
- ProcessId: このUI要素に関連付けられているプロセスのIDを示します。実行中の各アプリケーションには、それぞれに関連付けられたプロセスIDがあります。
- FrameworkId: UI要素を生成したフレームワークを識別するための識別子です。例えば、"WinForms"、"WPF"、"Win32"などです。
- ClassName: Windowsオペレーティングシステムで使用される識別子で、ウィンドウのクラスや種類を識別し、表すために使用されます。例えば、標準のWindowsボタンでは、ClassNameが"Button"になる場合があります。
注:ここに挙げたものは、よく使うUIA要素のプロパティです。他のプロパティについては、Automation要素のプロパティ識別子に関するドキュメントを参照してください。検索する際は、UIA_プレフィックスとPropertyIdサフィックスを付けないでください。例えば、UIA_AcceleratorKeyPropertyIdを検索する場合は、AcceleratorKeyを使用してください。
ACC要素
- Normal: 通常の状態で、特別なプロパティは設定されていません。
- Unavailable: 使用できない状態で、要素またはコントロールを操作できません。
- Selected: 選択済みの状態で、要素またはコントロールがユーザーによって選択されています。
- Focused: フォーカスがある状態で、要素またはコントロールが現在入力を受け付けているか、アクティブになっています。
- Pressed: 押下された状態で、要素またはコントロール(例えばボタン)が押されています。
- Checked: チェックが入っている状態で、要素またはコントロール(チェックボックスなど)にチェックが入っています。
- Mixed: 混在した状態で、通常はチェックボックスに使用され、チェックボックスの一部の子項目が選択されていることを示します。
- ReadOnly: 読み取り専用の状態で、要素またはコントロールは変更できず、読み取りのみ可能です。
- HotTracked: ホットトラッキングの状態で、要素またはコントロールの上にマウスポインターが置かれています。
- Default: デフォルトの状態で、要素またはコントロールが、その環境におけるデフォルトの選択肢になっています。
- Expanded: 展開された状態で、要素またはコントロール(ツリービューのノードなど)が展開されています。
- Collapsed: 折りたたまれた状態で、要素またはコントロール(ツリービューのノードなど)が折りたたまれています。
- Busy: ビジー状態で、要素またはコントロールがタスクを処理しており、ユーザーの入力に応答できない場合があります。
- Floating: フローティング状態で、要素またはコントロールが自由に移動して配置できるフローティングウィンドウです。
- Marqueed: マーキー状態で、要素またはコントロールにマーキー(文字のスクロール)効果が適用されています。
- Animated: アニメーション状態で、要素またはコントロールにアニメーション効果が適用されています。
- Invisible: 表示されない状態で、要素またはコントロールが現在表示されていません。
- Offscreen: 画面外の状態で、要素またはコントロールが画面の表示領域の外にあります。
- Sizeable: サイズを変更できる状態で、要素またはコントロールのサイズを変更できます。
- Moveable: 移動できる状態で、要素またはコントロールを移動できます。
- SelfVoicing: 自己音声出力の状態で、要素またはコントロールが音声を出力できます。
- Focusable: フォーカスを設定できる状態で、要素またはコントロールが入力フォーカスを取得できます。
- Selectable: 選択できる状態で、要素またはコントロールを選択できます。
- Linked: リンクの状態で、要素またはコントロールがクリック可能なリンクです。
- Traversed: 走査済みの状態で、要素またはコントロールがすでに走査されています。
- Multiselectable: 複数選択が可能な状態で、要素またはコントロールが複数の項目の選択に対応しています。
- ExtSelectable: 拡張選択の状態で、要素またはコントロールが何らかの形式の拡張選択に対応しています。連続した項目の選択、または連続していない項目の複数選択などがあります。
- AlertLow: 低レベルの警告状態で、要素またはコントロールが優先度の低い警告や通知を表示しています。
- AlertMedium: 中レベルの警告状態で、要素またはコントロールが優先度が中程度の警告や通知を表示しています。
- AlertHigh: 高レベルの警告状態で、要素またはコントロールが優先度の高い警告や通知を表示しています。
- Protected: 保護された状態で、要素またはコントロールが保護されています。アクセスや変更には、特別な権限や操作が必要になる場合があります。
Java要素
- name: オブジェクトまたはコンポーネントの名称です。
- description: オブジェクトに関する、より詳細な説明です。
- role: オブジェクトに割り当てられたロールです。
- role_en_US: オブジェクトに割り当てられたロールの英語(米国)版です。
- states: オブジェクトの状態または条件です。
- states_en_US: オブジェクトの状態の英語(米国)版です。
- indexInParent: 親内でのオブジェクトのインデックス位置で、文字列として返されます。
- childrenCount: オブジェクトの子項目の数で、文字列として返されます。
- x: オブジェクトのx座標で、文字列として返されます。
- y: オブジェクトのy座標で、文字列として返されます。
- width: オブジェクトの幅で、文字列として返されます。
- height: オブジェクトの高さで、文字列として返されます。
- accessibleComponent: オブジェクトがアクセシブルなコンポーネントである場合は"True"を返し、そうでない場合は"False"を返します。
- accessibleAction: オブジェクトにアクセシブルな操作がある場合は"True"を返し、そうでない場合は"False"を返します。
- accessibleSelection: オブジェクトにアクセシブルな選択機能がある場合は"True"を返し、そうでない場合は"False"を返します。
- accessibleText: オブジェクトにアクセシブルなテキストがある場合は"True"を返し、そうでない場合は"False"を返します。
