Freigeben über


AutomationElement.IsOffscreenProperty Feld

Definition

Gibt die IsOffscreen -Eigenschaft an, die angibt, ob das Element der Benutzeroberfläche (UI) auf dem Bildschirm sichtbar ist.

public: static initonly System::Windows::Automation::AutomationProperty ^ IsOffscreenProperty;
public static readonly System.Windows.Automation.AutomationProperty IsOffscreenProperty;
 staticval mutable IsOffscreenProperty : System.Windows.Automation.AutomationProperty
Public Shared ReadOnly IsOffscreenProperty As AutomationProperty 

Feldwert

Beispiele

Im folgenden Beispiel wird der aktuelle Wert der -Eigenschaft abgerufen. Der Standardwert wird zurückgegeben, wenn das Element keines bereitstellt.

bool isControlOffscreen = (bool)
   autoElement.GetCurrentPropertyValue(AutomationElement.IsOffscreenProperty);
Dim isControlOffscreen As Boolean = _
    CBool(autoElement.GetCurrentPropertyValue(AutomationElement.IsOffscreenProperty))

Das folgende Beispiel ruft den aktuellen Wert der Eigenschaft ab, gibt aber an, dass anstelle eines Standardwerts zurückgegeben werden soll, NotSupported wenn das Element selbst keinen Wert für die Eigenschaft bereitstellt.

bool isControlOffscreen1;
object isOffscreenNoDefault =
    autoElement.GetCurrentPropertyValue(AutomationElement.IsOffscreenProperty, true);
if (isOffscreenNoDefault == AutomationElement.NotSupported)
{
    // TODO Handle the case where you do not wish to proceed using the default value.
}
else
{
    isControlOffscreen1 = (bool)isOffscreenNoDefault;
}
Dim isControlOffscreen1 As Boolean
Dim isOffscreenNoDefault As Object = autoElement.GetCurrentPropertyValue(AutomationElement.IsOffscreenProperty, True)
If isOffscreenNoDefault Is AutomationElement.NotSupported Then
    ' TODO Handle the case where you do not wish to proceed using the default value.
Else
    isControlOffscreen1 = CBool(isOffscreenNoDefault)
End If

Hinweise

Dieser Bezeichner wird von Benutzeroberflächenautomatisierungsclientanwendungen verwendet. Benutzeroberflächenautomatisierungsanbieter sollten den entsprechenden Bezeichner in AutomationElementIdentifiersverwenden.

Diese Eigenschaft kann auch aus den Current Eigenschaften oder Cached abgerufen werden.

Der Rückgabewert ist vom Typ Boolean, und der Standardwert ist false.

Weitere Informationen dazu, wann diese Eigenschaft ist true, finden Sie unter IsOffscreen.

Gilt für:

Weitere Informationen