AutomationElement.AutomationElementInformation.IsOffscreen Eigenschaft

Definition

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Ruft einen Wert ab, der angibt, ob das Ui Automation-Element auf dem Bildschirm sichtbar ist.

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

public bool IsOffscreen { get; }

member this.IsOffscreen : bool

Public ReadOnly Property IsOffscreen As Boolean

Eigenschaftswert

Boolean

true, wenn das Steuerelement nicht sichtbar ist, andernfalls false.

Hinweise

Ein boolescher Wert, der angibt, ob ein Element vollständig scrollt (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) nicht angezeigt wird.

Wenn das Element über einen klickbaren Punkt verfügt, der dazu führen kann, dass es fokussiert wird, wird es als auf dem Bildschirm betrachtet, auch wenn sich ein Teil des Elements außerhalb des Bildschirms befindet.

Der Wert der -Eigenschaft wird nicht durch die Verdeckung durch andere Fenster beeinflusst oder davon, ob das Element auf einem bestimmten Monitor sichtbar ist.

Wenn IsOffscreen ein Element ist true, , das in der Ansicht gescrollt oder reduziert wird, aber dennoch Teil der Wahrnehmung der Benutzeroberfläche durch die Endbenutzer ist, kann durch einfache Bearbeitung wie Scrollen oder Klicken auf ein Dropdownsteuerelement wieder in die Ansicht gebracht werden.

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

Wenn der Wert für einen Container gilt true , ist er auch true für die abhängigen Elemente des Containerelements.

Weitere Informationen finden Sie unter IsOffscreenProperty.