AutomationElement.IsOffscreenProperty Feld

Referenz

Definition

Namespace:: System.Windows.Automation

Assembly:: UIAutomationClient.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

AutomationProperty

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:

Produkt	Versionen
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Weitere Informationen

Übersicht über die Benutzeroberflächenautomatisierungs-Eigenschaften

Teilen über