Struktursteuertyp
Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung Unterstützung für den Struktur-Steuerelementtyp.
Der Struktur-Steuerelementtyp wird für Container verwendet, deren Inhalt als Hierarchie von Knoten relevant ist. Dies gilt auch für die Anzeige von Dateien und Ordnern im linken Bereich des Windows Explorers. 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. Das Windows-Steuerelement (wie durch WC _ TREEVIEWidentifiziert) ist ein Beispiel für ein Steuerelement, das zum Tree-Steuerelementtyp gehört.
In den folgenden Abschnitten werden die Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Tree-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung gelten für alle Strukturelementsteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Strukturstruktur
Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Struktursteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur Benutzeroberflächenautomatisierung Struktur finden Sie unter Benutzeroberflächenautomatisierung Strukturübersicht.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Die Steuerelementansicht der Benutzeroberflächenautomatisierung besteht aus:
- Null von vielen Elementen im Container (Elemente können auf den Steuerelementtypen TreeItem oder DataItem basieren).
- Kein, ein oder zwei ScrollBar-Steuerelemente
Die Inhaltsansicht der Benutzeroberflächenautomatisierung besteht aus null oder vielen Elementen innerhalb des Containers (Elemente können auf den Steuerelementtypen TreeItem oder DataItem basieren).
Relevante Eigenschaften
In der folgenden Tabelle sind Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den Struktur-Steuerelementtyp besonders relevant ist. Weitere Informationen zu Eigenschaften Benutzeroberflächenautomatisierung 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 rohen Ansicht der Benutzeroberflächenautomatisierung sein. |
| UIA _ BoundingRectanglePropertyId | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| UIA _ ClickablePointPropertyId | Siehe Hinweise. | Struktursteuerelemente verfügen über einen klickbaren Punkt, der bewirkt, dass die Struktur oder eines der Elemente im Strukturcontainer den Fokus erhält. Ein Struktursteuerelement kann nur dann einen klickbaren Punkt haben, wenn es möglich ist, auf eine Position in der Struktur zu klicken, ohne ein Element zu aktivieren oder den Fokus zu erhalten. |
| UIA _ ControlTypePropertyId | Struktur | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| UIA _ IsContentElementPropertyId | TRUE | Das Struktursteuer steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Struktursteuer steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung enthalten. |
| UIA _ IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA _ LabeledByPropertyId | Siehe Hinweise. | Wenn dem Struktursteuerelement eine Bezeichnung zugeordnet ist, gibt diese Eigenschaft einen IUIAutomationElement-Zeiger für diese Bezeichnung zurück. Andernfalls gibt die -Eigenschaft einen NULL-Verweis zurück. |
| UIA _ LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Tree-Steuerelementtyp entspricht. Der Standardwert ist "tree" für en-US oder English (USA). |
| UIA _ NamePropertyId | Siehe Hinweise. | Der Wert der Eigenschaft „Name“ eines Struktursteuerelements entspricht normalerweise dem Text, durch den das Steuerelement bezeichnet wird. Wenn keine Textbezeichnung enthalten ist, müssen Sie einen Wert für diese Eigenschaft bereitstellen. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die von allen Struktursteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Mustereigenschaft | Unterstützung/Wert | Notizen |
|---|---|---|
| IScrollProvider | Depends (Abhängig) | Implementieren Sie das Bildlauf-Steuerelementmuster, wenn elemente im Strukturcontainer gescrollt werden können. |
| ISelectionProvider | Depends (Abhängig) | Struktursteuerelemente, die einen Satz auswählbarer Elemente enthalten, müssen das Selection-Steuerelementmuster implementieren. Sie muss nicht implementiert werden, wenn die Auswahl eines Elements dem Benutzer keine aussagekräftigen Informationen vermittelt. |
| CanSelectMultiple | Siehe Hinweise. | Implementieren Sie diese Eigenschaft, wenn das Struktursteuerelement eine Mehrfachauswahl unterstützt (meistens ist dies nicht der Fall). |
| IsSelectionRequired | Siehe Hinweise. | Der Wert dieser Eigenschaft ist verfügbar, wenn für das Steuerelement die Auswahl eines Elements erforderlich ist. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, die alle Struktursteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.