Freigeben über

Struktursteuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für die Struktur Steuerelementtyps.

Der Struktur- Steuerelementtyp wird für Container verwendet, deren Inhalt als Hierarchie von Knoten relevant ist, wie dateien und Ordner im linken Bereich von Windows Explorer angezeigt werden. 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. Das Windows-Strukturansichtssteuerelement (wie durch WC_TREEVIEWidentifiziert) ist ein Beispiel für ein Steuerelement, das zum Struktur- Steuerelementtyp gehört.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Struktur- 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 Struktursteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Baum
    • DataItem (0 oder mehr)
    • TreeItem (0 oder mehr)
      • TreeItem (0 oder mehr)
        • ...
    • ScrollBar (0, 1, 2)
  • Baum
    • DataItem (0 oder mehr)
    • TreeItem (0 oder mehr)
      • TreeItem (0 oder mehr)
        • ...

 

Die Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur besteht aus:

  • Null von vielen Elementen innerhalb des Containers (Elemente können auf dem TreeItem- oder DataItem- Steuerelementtypen basieren).
  • Null-, ein oder zwei Bildlaufleisten-Steuerelemente

Die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur besteht aus null oder vielen Elementen im Container (Elemente können auf dem TreeItem- oder DataItem Steuerelementtypen basieren).

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für den Struktur- 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. Struktursteuerelemente weisen einen klickbaren Punkt auf, der bewirkt, dass die Struktur oder eines der Elemente im Strukturcontainer den Fokus erhält. Ein Struktursteuerelement kann nur dann auf einen klickbaren Punkt klicken, wenn es möglich ist, auf eine Position in der Struktur zu klicken, ohne dass ein Element ausgewählt oder der Fokus empfangen wird.
UIA_ControlTypePropertyId Struktur- Dieser Wert ist für alle Benutzeroberflächenframeworks identisch.
UIA_IsContentElementPropertyId STIMMT Das Struktursteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId STIMMT Das Struktursteuerelement 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_LabeledByPropertyId Siehe Hinweise. Wenn dem Struktursteuerelement eine Beschriftung zugeordnet ist, gibt diese Eigenschaft einen IUIAutomationElement- Zeiger für diese Bezeichnung zurück. Andernfalls gibt die Eigenschaft einen Nullverweis zurück.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Struktur- Steuerelementtyp entspricht. Der Standardwert ist "tree" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Wert der Namenseigenschaft eines Struktursteuerelements stammt in der Regel aus Text, der das Steuerelement beschriftt. Wenn keine Beschriftung vorhanden ist, müssen Sie einen Wert für diese Eigenschaft angeben.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Struktursteuerelementen 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
IScrollProvider- Hängt Implementieren Sie das Scroll- Steuerelementmuster, wenn Elemente im Strukturcontainer scrollen können.
ISelectionProvider- Hängt Struktursteuerelemente, die einen Satz auswählbarer Elemente enthalten, müssen das Auswahl- Steuerelementmuster implementieren. Sie muss nicht implementiert werden, wenn das Auswählen eines Elements dem Benutzer keine aussagekräftigen Informationen vermittelt.
CanSelectMultiple- Siehe Hinweise. Implementieren Sie diese Eigenschaft, wenn das Struktursteuerelement mehrere Auswahl unterstützt (die meisten Struktursteuerelemente unterstützen keine Mehrfachauswahl).
IsSelectionRequired- Siehe Hinweise. Der Wert dieser Eigenschaft wird verfügbar gemacht, wenn das Steuerelement erfordert, dass ein Element ausgewählt wird.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die von allen Struktursteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
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_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

 

Konzeptionelle

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

Übersicht über die Benutzeroberflächenautomatisierung