Freigeben über

ToolBar-Steuerelementtyp

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den ToolBar- Steuerelementtyp. Symbolleistensteuerelemente ermöglichen Endbenutzern die Aktivierung von Befehlen und Tools in einer Anwendung.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ToolBar- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Symbolleistensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung 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 Symbolleistensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Symbolleiste
    • Verschiedene Steuerelemente (0 oder mehr)
  • Symbolleiste
    • Verschiedene Steuerelemente (0 oder mehr)

 

Ein Symbolleistensteuerelement kann einen beliebigen Steuerelementtyp innerhalb seiner Unterstruktur enthalten. Sie enthalten am häufigsten Schaltflächen, Kombinationsfelder und geteilte Schaltflächen.

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für den ToolBar- 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. Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreiben Und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId Symbolleisten- Dieser Wert ist für alle Benutzeroberflächenframeworks identisch.
UIA_IsContentElementPropertyId STIMMT Das Symbolleistensteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId STIMMT Das Symbolleistensteuerelement 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 NULL Ein Symbolleistensteuerelement hat nie eine Beschriftung.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem ToolBar- Steuerelementtyp entspricht. Der Standardwert ist "Toolleiste" für en-US oder Englisch (USA).
UIA_NamePropertyId Hängt Das Symbolleistensteuerelement benötigt keinen Namen, es sei denn, mehrere werden in einer Anwendung verwendet. Wenn mehrere vorhanden sind, muss jeder einen Unterscheidungsnamen haben (z. B. "Formatierung" oder "Klammern").

 

Erforderliche Steuerelementmuster

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

Steuerelementmuster Unterstützen Notizen
IDockProvider- Hängt Wenn die Symbolleiste an verschiedene Teile des Bildschirms angedockt werden kann, muss sie das steuerelementmuster Dock unterstützen.
IExpandCollapseProvider Hängt Wenn die Symbolleiste erweitert und reduziert werden kann, um weitere Elemente anzuzeigen, muss sie das ExpandCollapse Steuerelementmuster unterstützen.
ITransformProvider- Hängt Wenn die Größe der Symbolleiste geändert, gedreht oder verschoben werden kann, muss sie das Transform Steuerelementmuster unterstützen.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Symbolleistensteuerelemente 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. Wenn das Steuerelement das ExpandCollapse 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_StructureChangedEventId

 

Konzeptionelle

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

Übersicht über die Benutzeroberflächenautomatisierung