AutomationElement.AutomationElementInformation.IsOffscreen プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
UI オートメーション要素が画面上に表示されるかどうかを示す値を取得します。
public:
property bool IsOffscreen { bool get(); };
public bool IsOffscreen { get; }
member this.IsOffscreen : bool
Public ReadOnly Property IsOffscreen As Boolean
プロパティ値
true コントロールが表示されない場合。それ以外の場合は false。
注釈
要素が完全にスクロールされるか (リスト ボックス内の項目がコンテナー オブジェクトのビューポートの外にあるなど)、または折りたたまれている (ツリー ビュー、メニュー、最小化されたウィンドウの項目など) かどうかを示すブール値。
要素にクリック可能なポイントがあり、それがフォーカスされる可能性がある場合、要素の一部が画面外にある場合でも、その要素は画面上にあると見なされます。
プロパティの値は、他のウィンドウによるオクルージョンや、要素が特定のモニターに表示されているかどうかの影響を受けません。
IsOffscreen が true, 、スクロールまたは折りたたまれている要素で、まだ UI に対するエンド ユーザーの認識の一部である場合は、スクロールやドロップダウン コントロールのクリックなどの簡単な操作で表示に戻すことができます。
要素が、エンドユーザーがまったく認識しない場合、または "プログラムによって非表示" と呼ばれる場合 (たとえば、閉じられているが、下線付きオブジェクトがアプリケーションによってキャッシュされているダイアログ ボックス) は、IsOffscreen の値を trueに設定するのではなく、要素ツリーから削除する必要があります。
値がコンテナーに対して true されると、コンテナー要素の子孫にも true されます。
詳細については、IsOffscreenPropertyを参照してください。