Benutzeroberflächenautomatisierungs-Unterstützung für den ToolBar-Steuerelementtyp

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den ToolBar-Steuerelementtyp. In UI-Automatisierung umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte und Steuerelementmuster ein. Mithilfe der ToolBar-Steuerelemente können Endbenutzer die Befehle und Tools aktivieren, die in einer Anwendung enthalten sind.

In den folgenden Abschnitten sind die erforderliche UI-Automatisierung-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ToolBar-Steuerelementtyp definiert. Die UI-Automatisierung-Anforderungen gelten für alle ToolBar-Steuerelemente aus Windows Presentation Foundation (WPF), Win32 oder Windows Forms.

Dieses Thema enthält folgende Abschnitte.

  • Erforderliche Benutzeroberflächenautomatisierungs-Struktur
  • Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
  • Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur, die sich auf ToolBar-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

  • ToolBar

  • Verschiedene Steuerelemente (beliebige Anzahl)

  • ToolBar

  • Verschiedene Steuerelemente (beliebige Anzahl)

ToolBar-Steuerelemente können jeden beliebigen Steuerelementtyp in ihrer Teilstruktur enthalten. Am häufigsten enthalten sie Schaltflächen, Kombinationsfelder und Trennschaltflächen.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Wert oder Definition für ToolBar-Steuerelemente besonders relevant ist. Weitere Informationen über UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI-Automatisierung-Eigenschaft

Wert

Hinweise

AutomationIdProperty()

Siehe Hinweise.

Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere Rechteck, welches das gesamte Steuerelement umfasst.

ClickablePointProperty

Siehe Hinweise.

Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an.

IsKeyboardFocusableProperty

Siehe Hinweise.

Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.

NameProperty

Variabel

Ein ToolBar-Steuerelement muss nur dann einen Namen haben, wenn innerhalb einer Anwendung mehrere dieser Steuerelemente verwendet werden. Wenn mehrere vorhanden sind, sollte für jedes Steuerelement ein gut zu unterscheidender Name (z. B. Formatierung oder Gliederung) angegeben werden.

LabeledByProperty

Null

ToolBar-Steuerelemente haben niemals eine Bezeichnung.

ControlTypeProperty

ToolBar

Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.

LocalizedControlTypeProperty

"Symbolleiste"

Lokalisierte Zeichenfolge, die dem ToolBar-Steuerelementtyp entspricht.

IsContentElementProperty

True

Das ToolBar-Steuerelement ist immer ein Inhalt.

IsControlElementProperty

True

Das ToolBar-Steuerelement muss stets ein Steuerelement sein.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI-Automatisierung-Steuerelementmuster aufgelistet, die von den ToolBar-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster/Mustereigenschaft

Unterstützung/Wert

Hinweise

ExpandCollapsePattern

Variabel

Wenn die Symbolleiste zur Anzeige weiterer Elemente erweitert oder reduziert werden kann, muss sie dieses Muster unterstützen.

DockPattern

Variabel

Wenn die Symbolleiste an verschiedene Teile des Bildschirms angedockt werden kann, muss sie dieses Muster unterstützen.

TransformPattern

Variabel

Wenn die Symbolleiste vergrößert, verkleinert, gedreht oder verschoben werden kann, muss sie dieses Muster unterstützen.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI-Automatisierung-Ereignisse aufgelistet, die von allen ToolBar-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI-Automatisierung-Ereignis

Unterstützung

Hinweise

Durch geänderte Eigenschaft ausgelöstes BoundingRectangleProperty-Ereignis.

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes IsOffscreenProperty-Ereignis.

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis.

Erforderlich

Keine

Durch geänderte ExpandCollapseStateProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

ToolBar