AutomationElement.AutomationElementInformation.IsOffscreen AutomationElement.AutomationElementInformation.IsOffscreen AutomationElement.AutomationElementInformation.IsOffscreen AutomationElement.AutomationElementInformation.IsOffscreen Property

Definition

Ruft einen Wert ab, der angibt, ob das BenutzeroberflächenautomatisierungUI Automation-Element auf dem Bildschirm sichtbar ist.Gets a value that indicates whether the BenutzeroberflächenautomatisierungUI Automation element is visible on the screen.

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.true if the control is not visible; otherwise 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 Container Objekts) oder reduziert (z. b. ein Element in einer Strukturansicht, einem Menü oder einem minimierten Fenster) außerhalb der Ansicht ist.A Boolean value that indicates if an element is completely scrolled (for example, an item in a list box is outside the viewport of the container object) or collapsed (for example, an item in a tree view, menu, or a minimized window) out of view.

Wenn das Element über einen durch Klicken aktivierbaren Punkt verfügt, der einen Fokus verursachen kann, wird es als Bildschirm betrachtet, auch wenn ein Teil des Elements außerhalb des Bildschirms ist.If the element has a clickable point that can cause it to be focused, it is considered to be onscreen even when a portion of the element is off screen.

Der Wert der-Eigenschaft ist nicht von der Okklusion durch andere Fenster oder davon abhängig, ob das Element auf einem bestimmten Monitor sichtbar ist.The value of the property is not affected by occlusion by other windows, or by whether the element is visible on a specific monitor.

Wenn IsOffscreen ein true, Element ist, das ein-oder ausgeblendet ist, aber immer noch Teil der Darstellung der Benutzeroberfläche ist, kann durch einfache Bearbeitung (z. b. durch Scrollen oder anklicken eines Dropdown-Steuer Elements) wieder in die Ansicht eingefügt werden.When IsOffscreen is true, an element that is scrolled or collapsed out of view, but is still part of the end-users perception of the UI, can be brought back into view by simple manipulation, such as scrolling or clicking on a drop-down control.

Wenn es sich bei dem Element um ein Element handelt, das der Endbenutzer überhaupt nicht wahrnimmt oder als "Programm gesteuert ausgeblendet" bezeichnet wird (z. b. ein Dialogfeld, das verworfen wurde, in dem jedoch das unter werdende Objekt von der Anwendung zwischengespeichert wird), sollte es aus entfernt werden. die Elementstruktur, anstatt den Wert von IsOffscreen auf truefestzulegen.If the element is something that the end-user does not perceive at all or is referred to as being "programmatically hidden" (for example, a dialog box that has been dismissed but where the underlining object is cached by the application) then it should be removed from the element tree rather than setting the value of IsOffscreen to true.

Wenn der Wert für true einen Container ist, gilt er auch true für die Nachfolger Elemente des Container Elements.When the value is true for a container, it is also true for the container element's descendants.

Weitere Informationen finden Sie unter IsOffscreenProperty.For more information, see IsOffscreenProperty.

Gilt für: