Steuerelementmuster für Benutzeroberflächenautomatisierung für Clients
.gif "Hinweis") Hinweis |
|---|
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation. |
Diese Übersicht enthält die Steuerelementmuster für Benutzeroberflächenautomatisierungs-Clients. Es wird beschrieben, wie von einem Benutzeroberflächenautomatisierungs-Client Steuerelementmuster verwendet werden, um auf Informationen über die user interface (UI) zuzugreifen.
Mit Steuerelementmustern können Funktionen von Steuerelementen unabhängig von deren Typ oder Darstellung kategorisiert und verfügbar gemacht werden. Benutzeroberflächenautomatisierungs-Clients können ein AutomationElement überprüfen, um festzustellen, welche Steuerelementmuster unterstützt werden, und um das ordnungsgemäße Verhalten des Steuerelements sicherzustellen.
Eine vollständige Liste der verfügbaren Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.
Dieses Thema enthält folgende Abschnitte.
- Abrufen von Steuerelementmustern
- Abrufen von Eigenschaften in Steuerelementmustern
- Steuerelemente mit variablen Mustern
- Verwandte Abschnitte
Abrufen von Steuerelementmustern
Clients empfangen ein Steuerelementmuster von einem AutomationElement durch den Aufruf von AutomationElement.GetCachedPattern oder AutomationElement.GetCurrentPattern.
Von Clients kann die GetSupportedPatterns-Methode oder eine einzelne IsPatternAvailable-Eigenschaft (beispielsweise IsTextPatternAvailableProperty) verwendet werden, um festzustellen, ob vom AutomationElement ein Muster oder eine Gruppe von Mustern unterstützt wird. Es ist jedoch effizienter, zu versuchen, ein Steuerelementmuster abzurufen und auf einen null-Verweis zu testen, als die unterstützten Eigenschaften zu überprüfen und das Steuerelementmuster abzurufen, da weniger prozessübergreifende Aufrufe erforderlich sind.
Im folgenden Beispiel wird veranschaulicht, wie ein TextPattern-Steuerelementmuster von einem AutomationElement abgerufen wird.
// 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
Von Clients können die Eigenschaftswerte in Steuerelementmustern abgerufen werden, indem entweder AutomationElement.GetCachedPropertyValue oder AutomationElement.GetCurrentPropertyValue aufgerufen und das zurückgegebene Objekt in einen geeigneten Typ umgewandelt wird. Weitere Informationen über die UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
Zusätzlich zu den GetPropertyValue-Methoden können Eigenschaftswerte über die common language runtime (CLR)-Accessoren empfangen werden, um auf die UI Automation-Eigenschaften in einem Muster zuzugreifen.
Steuerelemente mit variablen Mustern
Von einigen Steuerelementtypen werden verschiedene Muster unterstützt, abhängig vom Zustand bzw. der Verwendungsart des Steuerelements. Beispiele für Steuerelemente mit variablen Mustern sind Listenansichten (Miniaturansichten, Kacheln, Symbole, Listen, Details), Microsoft Excel-Diagramme (Kreis-, Linien-, Leisten- und Zellenwertdiagramme mit einer Formel), Microsoft Word-Dokumentbereiche (Normal, Weblayout, Gliederung, Seitenlayout, und Seitenansicht) sowie Microsoft Windows Media Player-Skins.
Steuerelemente, von denen benutzerdefinierte Steuerelementtypen implementiert werden, können über beliebige Sätze von Steuerelementmustern verfügen, die zur Darstellung ihrer Funktionalität erforderlich sind.
Siehe auch
Aufgaben
Aufrufen eines Steuerelements mithilfe von Benutzeroberflächenautomatisierung
Abrufen des Umschaltstatus eines Kontrollkästchens mithilfe von Benutzeroberflächenautomatisierung
ValuePattern Insert Text Sample
TextPattern Search and Selection Sample
InvokePattern, ExpandCollapsePattern, and TogglePattern Sample
Konzepte
Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients