Übersicht über die Benutzeroberflächenautomatisierungs-Eigenschaften

  • Artikel

Microsoft Benutzeroberflächenautomatisierung-Anbieter machen Eigenschaften für Benutzeroberflächenautomatisierung-Elemente verfügbar. Eigenschaften ermöglichen Es Clientanwendungen, Informationen zu Steuerelementen abzurufen.

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

Steuerelementmustereigenschaften werden von einem Steuerelement verfügbar gemacht, 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 ColumnCount- und RowCount-Eigenschaften 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 Eigenschaftsbezeichner (Property Identifier, ID) bezeichnet wird. Anbieter und Clients verwenden die numerischen IDs in Methodenaufrufen wie IRawElementProviderAdviseEvents::AdviseEventAdded und IUIAutomationElement::GetCachedPropertyValue , um Eigenschaftenanforderungen zu identifizieren. Eine detaillierte Beschreibung der einzelnen Benutzeroberflächenautomatisierung Eigenschaftenbezeichners, einschließlich des Datentyps und des Standardwerts jeder Eigenschaft, finden Sie unter Eigenschaftenbezeichner.

Eigenschaftswerte

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

Informationen zum Abrufen von Eigenschaftenwerten finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.

Eigenschaften und Ereignisse

Eng mit den Eigenschaften in Benutzeroberflächenautomatisierung verknüpft ist das Konzept von Eigenschaftsänderungen. 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 Ereignisse mit Geänderten Eigenschaften für jede Eigenschaft zu lauschen.

Anbieter lösen Ereignisse aus, wenn in der Benutzeroberfläche irgendetwas geändert wurde. Wenn beispielsweise ein Kontrollkästchen aktiviert oder deaktiviert ist, wird ein Eigenschaftsänderungsereignis von der Anbieterimplementierung des Steuerelementmusters umschalten 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. Beispielsweise lösen die Standardproxyanbieter für Listenfelder kein Eigenschaftsänderungsereignis 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 Benutzeroberflächenautomatisierung Ereignissen beschrieben. Insbesondere bei Eigenschaftsänderungen 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