Freigeben über

Steuerelementmuster für Benutzeroberflächenautomatisierung für Clients

Hinweis

Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.

In dieser Übersicht werden Steuerelementmuster für Benutzeroberflächenautomatisierungs-Clients vorgestellt. Sie enthält Informationen dazu, wie ein Benutzeroberflächenautomatisierungs-Client Steuerelementmuster verwenden kann, um auf Informationen zur Benutzeroberfläche zuzugreifen.

Steuerelementmuster bieten eine Möglichkeit, die Funktionalität eines Steuerelements unabhängig vom Steuerelementtyp oder der Darstellung des Steuerelements zu kategorisieren und verfügbar zu machen. Benutzeroberflächenautomatisierungs-Clients können ein AutomationElement untersuchen, um festzustellen, welche Steuerelementmuster unterstützt werden, und um sich des Verhaltens des Steuerelements sicher zu sein.

Eine vollständige Liste der Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Abrufen von Steuerelementmustern

Clients empfangen ein Steuerelementmuster von einem AutomationElement durch den Aufruf eines AutomationElement.GetCachedPattern oder AutomationElement.GetCurrentPattern.

Clients können die GetSupportedPatterns Methode oder eine einzelne IsPatternAvailable Eigenschaft (z. B. IsTextPatternAvailableProperty) verwenden, um zu ermitteln, ob ein Muster oder eine Gruppe von Mustern für die AutomationElement unterstützt wird. Es ist jedoch effizienter, das Steuerelementmuster abzurufen und einen null Verweis zu testen, als die unterstützten Eigenschaften zu überprüfen und das Steuerelementmuster abzurufen, da es zu weniger prozessübergreifenden Aufrufen führt.

Das folgende Beispiel zeigt, wie man ein TextPattern Steuerelementmuster aus einem AutomationElement erhält.

// Specify the control type we're looking for, in this case 'Document'
PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

// target --> The root AutomationElement.
AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

targetTextPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

if (targetTextPattern == null)
{
    Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
    return;
}

Abrufen von Eigenschaften in Steuerelementmustern

Clients können die Eigenschaftswerte in Steuerelementmustern durch Aufrufen von AutomationElement.GetCachedPropertyValue oder AutomationElement.GetCurrentPropertyValue abrufen und das zurückgegebene Objekt in einen geeigneten Typ umwandeln. Weitere Informationen zu Benutzeroberflächenautomatisierungs-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungseigenschaften für Clients.

Zusätzlich zu den GetPropertyValue Methoden können Eigenschaftswerte über die ClR-Accessoren (Common Language Runtime) abgerufen werden, um auf die Benutzeroberflächenautomatisierungseigenschaften in einem Muster zuzugreifen.

Steuerelemente mit Variablenmustern

Einige Steuerelementtypen unterstützen unterschiedliche Muster je nach Zustand oder Art und Weise, in der das Steuerelement verwendet wird. Beispiele für Steuerelemente mit variablen Mustern sind Listenansichten (Miniaturansichten, Kacheln, Symbole, Liste, Details), Microsoft Excel Charts (Kreis, Linie, Balken, Zellwert mit einer Formel), Dokumentbereich von Microsoft Word (Normal, Weblayout, Gliederung, Drucklayout, Seitenansicht) und Microsoft Windows Media Player-Skins.

Steuerelemente, die benutzerdefinierte Steuerelementtypen implementieren, können über eine Reihe von Steuerelementmustern verfügen, die erforderlich sind, um ihre Funktionalität darzustellen.

Siehe auch

  • Last updated on