Freigeben über

Struktursteuerelementtyp

  • Artikel

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

Der Struktursteuerelementtyp wird für Container verwendet, deren Inhalt als Hierarchie von Knoten relevant ist, wie bei der Anzeige von Dateien und Ordnern im linken Bereich von Windows Explorer. 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-Strukturansichtssteuerelement (wie durch WC_TREEVIEW identifiziert) ist ein Beispiel für ein Steuerelement, das zum Struktursteuerelementtyp gehört.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Struktursteuerelementtyp 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 eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Struktursteuerelemente 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
  • Struktur
    • DataItem (beliebige Anzahl)
    • TreeItem (beliebige Anzahl)
      • TreeItem (beliebige Anzahl)
        • ...
    • ScrollBar (0, 1, 2)
  • Struktur
    • DataItem (beliebige Anzahl)
    • TreeItem (beliebige Anzahl)
      • TreeItem (beliebige Anzahl)
        • ...

 

Die Steuerelementansicht der Struktur „Benutzeroberflächenautomatisierung“ besteht aus:

Die Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur besteht aus 0 oder mehreren Elementen innerhalb des Containers (Elemente können auf den TreeItem- oder DataItem-Steuerelementtypen basieren).

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
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. 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 über einen klickbaren Punkt verfügen, wenn es möglich ist, auf eine Position in der Struktur zu klicken, ohne dass ein Element ausgewählt wird oder der Fokus empfangen wird.
UIA_ControlTypePropertyId Struktur Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
UIA_IsContentElementPropertyId TRUE Das Struktursteuerelement ist stets in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten.
UIA_IsControlElementPropertyId TRUE Das Struktursteuerelement ist stets in der Steuerelementansicht der Struktur 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 Struktursteuerelementtyp 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 Textbeschriftung vorhanden ist, müssen Sie einen Wert für diese Eigenschaft angeben.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, 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 Hinweise
IScrollProvider Depends (Abhängig) Implementieren Sie das Scroll-Steuerelementmuster, wenn Elemente im Strukturcontainer gescrollt werden können.
ISelectionProvider Depends (Abhängig) Struktursteuerelemente, die einen Satz auswählbarer Elemente enthalten, müssen das Auswahl-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 Ereignisse aufgeführt, die von allen Struktursteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Hinweise
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontallyScrollablePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalViewSizePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalScrollPercentPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticallyScrollablePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalViewSizePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_Selection_InvalidatedEventId Wenn das Steuerelement das Selection-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung