Freigeben über

ToolBar-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des ToolBar-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung. Symbolleistensteuerelemente ermöglichen Endbenutzern das Aktivieren von Befehlen und Tools, die in einer Anwendung enthalten sind.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ToolBar-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Symbolleistensteuerelemente, bei denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Symbolleistensteuerelemente bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

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

 

Ein Symbolleistensteuerelement kann einen beliebigen Steuerelementtyp innerhalb seiner Unterstruktur enthalten. Am häufigsten enthalten sie Schaltflächen, Kombinationsfelder und unterteilte Schaltflächen.

Relevante Eigenschaften

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

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. Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks geklickt werden kann, und das Element spezielle Treffertests durchführt, überschreiben Sie es, und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId ToolBar Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
UIA_IsContentElementPropertyId TRUE Das Symbolleistensteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE Das Symbolleistensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung 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 Bezeichnung.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem ToolBar-Steuerelementtyp entspricht. Der Standardwert ist "Symbolleiste" für en-US oder Englisch (USA).
UIA_NamePropertyId Depends (Abhängig) Das Symbolleistensteuerelement benötigt keinen Namen, es sei denn, innerhalb einer Anwendung wird mehr als ein Name verwendet. Wenn mehrere vorhanden sind, muss jeder einen unterscheidenden Namen haben (z. B. "Formatierung" oder "Gliederung").

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von Symbolleistensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster Support Hinweise
IDockProvider Depends (Abhängig) Wenn die Symbolleiste an verschiedene Teile des Bildschirms angedockt werden kann, muss sie das Dock-Steuerelementmuster unterstützen.
IExpandCollapseProvider Depends (Abhängig) Wenn die Symbolleiste erweitert und reduziert werden kann, um weitere Elemente anzuzeigen, muss sie das ExpandCollapse-Steuerelementmuster unterstützen.
ITransformProvider Depends (Abhängig) Wenn die Symbolleiste in der Größe geändert, gedreht oder verschoben werden kann, muss sie das Transformationssteuerelementmuster unterstützen.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Symbolleistensteuerelemente unterstützen 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_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 es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung