AutomationElement.AutomationElementInformation.IsOffscreen プロパティ

定義

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を参照してください。

適用対象