Übersicht über die Benutzeroberflächenautomatisierungs-Eigenschaften

Microsoft Benutzeroberflächenautomatisierung-Anbieter machen Eigenschaften für Benutzeroberflächenautomatisierung verfügbar. Eigenschaften ermöglichen Clientanwendungen das Abrufen von Informationen zu Steuerelementen.

Benutzeroberflächenautomatisierung macht zwei verschiedene Arten von Eigenschaften verfügbar: Automatisierungselementeigenschaften und Das Steuerelementmuster gibt an. Die Automation-Elementeigenschaften bestehen aus einem allgemeinen Satz von Eigenschaften, z. B. Name, AcceleratorKey und ClassName, die von allen Benutzeroberflächenautomatisierung-Elementen verfügbar gemacht werden, unabhängig vom Steuerelementtyp. Die meisten Automatisierungselementeigenschaften sind statische Werte.

Steuerelementmustereigenschaften sind Eigenschaften, die von einem Steuerelement verfügbar gemacht werden, das ein bestimmtes Steuerelementmuster unterstützt. Jedes Steuerelementmuster verfügt über einen entsprechenden Satz von Steuerelementmustereigenschaften, die das Steuerelement verfügbar machen muss. Beispielsweise macht ein Steuerelement, das das Grid-Steuerelementmuster unterstützt, die Eigenschaften ColumnCount und RowCount verfügbar. Die meisten Steuerelementmustereigenschaften sind dynamische Werte.

Dieses Thema enthält folgende Abschnitte:

Eigenschaftsbezeichner

Jede Eigenschaft wird durch einen numerischen PROPERTYID-Wert identifiziert, der als Eigenschaftenbezeichner (ID) bezeichnet wird. Anbieter und Clients verwenden die numerischen IDs in Methodenaufrufen wie IRawElementProviderAdviseEvents::AdviseEventAdded und IUIAutomationElement::GetCachedPropertyValue, um Eigenschaftenanforderungen zu identifizieren. Eine ausführliche Beschreibung der einzelnen Eigenschaftenbezeichner Benutzeroberflächenautomatisierung, einschließlich des Datentyps und Standardwerts der einzelnen Eigenschaften, finden Sie unter Eigenschaftenbezeichner.

Eigenschaftswerte

Alle Eigenschaften sind schreibgeschützt, obwohl einige mithilfe von Methoden geändert werden können, die auf das Steuerelement angewendet werden, z. B. IDockProvider::SetDockPosition (Anbieter) oder IUIAutomationDockPattern::SetDockPosition (Client).

Informationen zum Abrufen von Eigenschaftswerten finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Eigenschaften und Ereignisse

Eng mit den Eigenschaften in Benutzeroberflächenautomatisierung ist das Konzept von Durch Eigenschaften geänderten Ereignissen verknüpft. Für dynamische Eigenschaften benötigt eine Clientanwendung eine Möglichkeit zu wissen, dass sich ein Eigenschaftswert geändert hat, damit sie ihren Informationscache aktualisieren oder auf andere Weise auf die neuen Informationen reagieren kann. Clients können sich registrieren, um auf Durch Eigenschaften geänderte Ereignisse für jede Eigenschaft zu lauschen.

Anbieter geben Ereignisse aus, wenn sich etwas in der Benutzeroberfläche ändert. Wenn beispielsweise ein Kontrollkästchen aktiviert oder aktiviert ist, wird von der Anbieterimplementierung des Steuerelementmusters Umschalten ein durch eine Eigenschaft geändertes Ereignis ausgelöst. Anbieter können abhängig davon, ob Clients Ereignissen oder bestimmten Ereignissen lauschen, selektiv Ereignisse auslösen.

Es werden nicht für alle Eigenschaftenänderung Ereignisse ausgelöst. Dies ist vollständig von der Implementierung des Benutzeroberflächenautomatisierungs-Anbieters für das Element abhängig. Die Standardproxyanbieter für Listenfelder geben z. B. kein Durch eine Eigenschaft geändertes Ereignis aus, wenn sich die Selection-Eigenschaft ändert. In diesem Fall muss die Anwendung auf das Ereignis lauschen, das ausgelöst wird, wenn sich die Auswahl ändert (UIA _ SelectionItem _ ElementSelectedEventId).

Clients lauschen auf Ereignisse, indem sie sie abonnieren, wie unter Abonnieren von Ereignissen Benutzeroberflächenautomatisierung beschrieben. Insbesondere bei Ereignissen mit Geänderter Eigenschaft müssen Clients IUIAutomationPropertyChangedEventHandler implementieren und die Schnittstelle an IUIAutomation::AddPropertyChangedEventHandler oder IUIAutomation::AddPropertyChangedEventHandlerNativeArrayübergeben.

Referenz

Getcurrentpropertyvalue

GetCurrentPropertyValueEx

Getcachedpropertyvalue

GetCachedPropertyValueEx

Konzept

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse