Freigeben über

Übersicht über die Benutzeroberflächenautomatisierungs-Eigenschaften

  • Artikel

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

Benutzeroberflächenautomatisierung macht zwei verschiedene Arten von Eigenschaften verfügbar: Automatisierungselementeigenschaften und Steuerelementmustereigenschaften. Die Eigenschaften des Automatisierungselements bestehen aus einer gemeinsamen Gruppe 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 sind diejenigen, 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. Ein Steuerelement, das das Raster-Steuerelementmuster unterstützt, macht beispielsweise 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 Eigenschaftsbezeichner (ID) bezeichnet wird. Anbieter und Clients verwenden die numerischen IDs in Methodenaufrufen wie IRawElementProviderAdviseEvents::AdviseEventAdded und IUIAutomationElement::GetCachedPropertyValue, um Eigenschaftsanforderungen zu identifizieren. Eine detaillierte Beschreibung der einzelnen Benutzeroberflächenautomatisierung Eigenschaftenbezeichner, einschließlich des Datentyps und des Standardwerts jeder Eigenschaft, finden Sie unter Eigenschaftenbezeichner.

Eigenschaftswerte

Alle Eigenschaften sind schreibgeschützt, obwohl einige mithilfe von Methoden geändert werden können, die auf das Steuerelement reagieren, 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 verknüpft ist das Konzept von Eigenschaftsänderungsereignissen. Für dynamische Eigenschaften benötigt eine Clientanwendung eine Möglichkeit, um zu wissen, dass sich ein Eigenschaftswert geändert hat, damit er seinen Informationscache aktualisieren oder auf andere Weise auf die neuen Informationen reagieren kann. Clients können registrieren, um auf Eigenschaftsänderungsereignisse 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 durch die Anbieterimplementierung des Umschalten-Steuerelementmusters 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. Für Eigenschaftsänderungsereignisse müssen Clients insbesondere 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