Freigeben über

TreeItem-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den TreeItem- Steuerelementtyp.

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, die untergeordnete Knoten enthalten, können als erweitert oder reduziert angezeigt werden.

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

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Strukturelementsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • TreeItem
    • CheckBox (0 oder 1)
    • Bild (0 oder 1)
    • Schaltfläche (0 oder 1)
    • TreeItem (0 oder mehr)
  • TreeItem
    • TreeItem (0 oder mehr)

 

Strukturelementsteuerelemente können in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur null oder mehr untergeordnete Strukturelemente aufweisen. Wenn das Strukturelementsteuerelement über die Funktionalität hinaus verfügt, die in den unten aufgeführten Steuerelementmustern verfügbar gemacht wird, sollte das Steuerelement auf dem DataItem- Steuerelementtyp basieren.

Reduzierte Strukturelemente werden erst in der Steuerelementansicht oder inhaltsansicht angezeigt, wenn sie erweitert und sichtbar werden (oder in die Ansicht gescrollt werden können).

Die Steuerelementansicht kann zusätzliche Details für ein Steuerelement enthalten, einschließlich eines zugeordneten Bilds oder einer Schaltfläche. Beispielsweise kann ein Element in einer Gliederungsansicht ein Bild sowie eine Schaltfläche enthalten, um die Gliederung zu erweitern oder zu reduzieren. Diese Detailobjekte werden in der Inhaltsansicht nicht angezeigt, da die Informationen bereits durch das übergeordnete Strukturelement dargestellt werden.

Strukturelemente, die vom Bildschirm gescrollt werden, werden sowohl in der Steuerelement- als auch in der Inhaltsansicht der Benutzeroberflächenautomatisierungsstruktur angezeigt und sollten die IUIAutomationElement::CurrentIsOffscreen (oder CachedIsOffscreen-) -Eigenschaft auf TRUEfestgelegt sein.

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste 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 fokussiert wird.
UIA_ControlTypePropertyId TreeItem- Dieser Wert ist für alle Benutzeroberflächenframeworks identisch.
UIA_IsContentElementPropertyId TRUE- Das Strukturelement-Steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE- Das Strukturelement-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-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 Strukturelement-Steuerelement vom Bildschirm gescrollt wird.
UIA_ItemStatusPropertyId Siehe Hinweise. Wenn das Steuerelement den Status enthält, der dynamisch aktualisiert wird, muss diese Eigenschaft unterstützt werden, damit eine Hilfstechnologie Aktualisierungen empfangen kann, wenn sich der Status des Elements ändert.
UIA_ItemTypePropertyId Siehe Hinweise. Wenn das Strukturelementsteuerelement ein visuelles Symbol verwendet, um anzugeben, dass es sich um einen bestimmten Elementtyp handelt, muss diese Eigenschaft unterstützt werden und den Elementtyp angeben.
UIA_LabeledByPropertyId NULL- Strukturelementsteuerelemente sind self-labeling.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem TreeItem-Steuerelementtyp entspricht. Der Standardwert ist "Strukturelement" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Diese Eigenschaft macht den Text verfügbar, der für jedes Strukturelementsteuerelement angezeigt wird.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Strukturelementsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Control Pattern/Pattern-Eigenschaft Support/Wert Notizen
IExpandCollapseProvider Erforderlich Alle Strukturelemente müssen das ExpandCollapse Steuerelementmuster unterstützen, da alle Elemente erweitert oder reduziert werden können.
ExpandCollapseState- Erweiterter, reduzierter oder Blattknoten Strukturelemente sind Blattknoten, wenn sie nicht erweitert oder reduziert werden.
IInvokeProvider- Hängt Implementieren Sie das Aufrufen Steuerelementmusters, wenn das Strukturelement einen Befehl ausführen kann.
IScrollItemProvider- Hängt Implementieren Sie das ScrollItem- Steuerelementmuster, wenn der Strukturcontainer das Scroll- Steuerelementmuster unterstützt.
ISelectionItemProvider- Hängt 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ächenautomatisierungsereignisse aufgeführt, die Strukturelementsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_ExpandCollapseExpandCollapseStatePropertyId Eigenschaftsänderungsereignis.
UIA_Invoke_InvokedEventId Wenn das Steuerelement das Invoke Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_ItemStatusPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die ItemStatus--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_MultipleViewCurrentViewPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das MultipleView Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_NamePropertyId Eigenschaftsänderungsereignis.
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 Eigenschaftsänderungsereignis. Wenn das Steuerelement das Umschalten Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen.
UIA_ValueValuePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Wert- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Bemerkungen

Wenn ein Strukturelement andere Unterelemente als untergeordnete Gliederungsknoten aufweist, muss der Anbieter die untergeordneten Objektinformationen sorgfältig und deutlich behandeln. In der Benutzeroberflächenautomatisierung wird die Struktur von der Strukturhierarchie selbst behandelt. Durch das Vorhandensein eines oder mehrerer untergeordneter untergeordneter Knoten werden die Unterschiede zwischen ihnen und tatsächlich untergeordneten Gliederungsknoten ernsthaft mehrdeutig.

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung