Share via

TreeItem-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des TreeItem-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

Der TreeItem-Steuerelementtyp stellt einen Knoten in einem Strukturcontainer dar. Jeder Knoten kann andere Knoten enthalten, die als untergeordnete Knoten bezeichnet werden. Übergeordnete Knoten oder Knoten mit untergeordneten Knoten können in erweiterter oder reduzierter Form angezeigt werden.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den TreeItem-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Strukturelementsteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur der Struktur

Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Strukturelementsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
  • TreeItem
    • CheckBox (0 oder 1)
    • Bild (0 oder 1)
    • Button (0 oder 1)
    • TreeItem (beliebige Anzahl)
  • TreeItem
    • TreeItem (beliebige Anzahl)

 

Strukturelement-Steuerelemente können in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur keine oder mehrere untergeordnete Elemente aufweisen. Wenn das Strukturelementsteuerelement über funktionen verfügt, die über die funktionen hinausgeht, die in den unten aufgeführten Steuerelementmustern verfügbar gemacht werden, sollte das Steuerelement auf dem DataItem-Steuerelementtyp basieren.

Reduzierte Strukturelemente werden erst in der Steuerelement- oder Inhaltsansicht angezeigt, wenn sie erweitert und sichtbar werden (oder in die Ansicht scrollen können).

Die Steuerelementansicht kann weitere Details für ein Steuerelement enthalten, wie etwa für ein zugeordnetes Bild oder eine Schaltfläche. Ein Element in einer Gliederungsansicht kann beispielsweise ein Bild sowie eine Schaltfläche zum Erweitern oder Reduzieren der Gliederung enthalten. Diese Detailobjekte werden in der Inhaltsansicht nicht angezeigt, da die Informationen bereits vom übergeordneten Strukturelement dargestellt werden.

Strukturelemente, für die ein Bildlauf vom Bildschirm ausgeführt wird, werden sowohl in der Steuerelement- als auch in der Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur angezeigt und sollten die Eigenschaft IUIAutomationElement::CurrentIsOffscreen (oder CachedIsOffscreen) auf TRUE festgelegt haben.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den TreeItem-Steuerelementtyp besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Diese Eigenschaft muss einen Speicherort zurückgeben, der bewirkt, dass das Strukturelement den Auswahlstatus ändert oder den Fokus hat.
UIA_ControlTypePropertyId TreeItem Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
UIA_IsContentElementPropertyId TRUE Das Strukturelementsteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE Das Strukturelementsteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_IsOffscreenPropertyId Siehe Hinweise. Diese Eigenschaft gibt an, ob ein Strukturelementsteuerelement einen Bildlauf vom Bildschirm entfernt wird.
UIA_ItemStatusPropertyId Siehe Hinweise. Wenn das Steuerelement status enthält, die dynamisch aktualisiert wird, muss diese Eigenschaft unterstützt werden, damit eine Hilfstechnologie Updates empfangen kann, wenn sich die status des Elements ändert.
UIA_ItemTypePropertyId Siehe Hinweise. Wenn das Strukturelementsteuerelement ein visuelles Symbol verwendet, um anzugeben, dass ein bestimmter Elementtyp ist, muss diese Eigenschaft unterstützt werden und den Elementtyp angeben.
UIA_LabeledByPropertyId NULL Strukturelement-Steuerelemente sind selbstbezeichnend.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge für den Steuerelementtyp „TreeItem“. Der Standardwert ist "tree item" für en-US oder English (USA).
UIA_NamePropertyId Siehe Hinweise. Diese Eigenschaft macht den für jedes Strukturelement-Steuerelement angezeigten Text verfügbar.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Strukturelementsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster/Mustereigenschaft Unterstützung/Wert Notizen
IExpandCollapseProvider Erforderlich Alle Strukturelemente müssen das ExpandCollapse-Steuerelementmuster unterstützen, da alle Elemente erweitert oder reduziert werden können.
Expandcollapsestate Erweitert, reduziert oder Blattknoten Strukturelemente sind Blattknoten, wenn sie nicht erweitert oder reduziert werden.
IInvokeProvider Depends (Abhängig) Implementieren Sie das Invoke-Steuerelementmuster, wenn das Strukturelement einen Befehl ausführen kann.
IScrollItemProvider Depends (Abhängig) Implementieren Sie das ScrollItem-Steuerelementmuster , wenn der Strukturcontainer das Scroll-Steuerelementmuster unterstützt.
ISelectionItemProvider Depends (Abhängig) Implementieren Sie das SelectionItem-Steuerelementmuster , wenn eine aktive Auswahl möglich ist, die beibehalten wird, wenn der Benutzer zum Strukturcontainer zurückkehrt.
Selectioncontainer Erforderlich Diese Eigenschaft macht denselben Container für alle Elemente innerhalb des Containers verfügbar.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Strukturelementsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
UIA_ExpandCollapseExpandCollapseStatePropertyId Eigenschaft geändertes Ereignis.
UIA_Invoke_InvokedEventId Wenn das Steuerelement das Invoke-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_ItemStatusPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die ItemStatus-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_MultipleViewCurrentViewPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das MultipleView-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_NamePropertyId Eigenschaft geändertes Ereignis.
UIA_SelectionItem_ElementAddedToSelectionEventId Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_SelectionItem_ElementRemovedFromSelectionEventId Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_SelectionItem_ElementSelectedEventId Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Umschalter-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ValueValuePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Value-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Bemerkungen

Wenn ein Strukturelement andere Unterelemente als untergeordnete Gliederungsknoten aufweist, muss der Anbieter die informationen des untergeordneten Objekts sorgfältig und klar behandeln. In Benutzeroberflächenautomatisierung wird die Struktur von der Strukturhierarchie selbst behandelt. Durch die Verwendung eines oder mehrerer untergeordneter Knoten ohne Gliederung werden die Unterschiede zwischen ihnen und den tatsächlichen untergeordneten Gliederungsknoten stark mehrdeutig.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung