TreeItem-Steuerelementtyp
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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Anmerkungen
- Zugehörige Themen
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 |
|---|---|
|
|
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.
Zugehörige Themen