AutomationElement.AutomationElementInformation.IsOffscreen Eigenschaft

public:
 property bool IsOffscreen { bool get(); };

public bool IsOffscreen { get; }

member this.IsOffscreen : bool

Public ReadOnly Property IsOffscreen As Boolean

Eigenschaftswert

true wenn das Steuerelement nicht sichtbar ist; andernfalls false.

Hinweise

Ein boolescher Wert, der angibt, ob ein Element vollständig gescrollt ist (z. B. ein Element in einem Listenfeld außerhalb des Viewports des Containerobjekts) oder reduziert (z. B. ein Element in einer Strukturansicht, einem Menü oder einem minimierten Fenster) außerhalb der Ansicht.

Wenn das Element über einen klickbaren Punkt verfügt, der dazu führen kann, dass es sich um einen Fokus handelt, wird es auch dann als auf dem Bildschirm betrachtet, wenn ein Teil des Elements deaktiviert ist.

Der Wert der Eigenschaft wird von der Okklusion durch andere Fenster nicht beeinflusst oder ob das Element auf einem bestimmten Monitor sichtbar ist.

Wenn IsOffscreen ein Element ist true, , das aus der Ansicht gescrollt oder reduziert wird, aber dennoch Teil der Wahrnehmung der Benutzeroberfläche der Endbenutzer ist, kann durch einfache Manipulation, z. B. Scrollen oder Klicken auf ein Dropdown-Steuerelement, wieder in die Ansicht verschoben werden.

Wenn das Element etwas ist, das der Endbenutzer überhaupt nicht wahrnimmt oder als "programmgesteuert ausgeblendet" bezeichnet wird (z. B. ein Dialogfeld, das geschlossen wurde, aber das unterstreichende Objekt von der Anwendung zwischengespeichert wird), sollte es aus der Elementstruktur entfernt werden, anstatt den Wert von IsOffscreen auf festzulegen true.

Wenn sich der Wert für einen Container befindet true , gilt er auch true für die Nachfolger des Containerelements.

Weitere Informationen finden Sie unter IsOffscreenProperty.