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

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den SplitButton-Steuerelementtyp. Bei der UI Automation 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 Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Das SplitButton-Steuerelement bietet die Möglichkeit, eine Aktion für ein Steuerelement auszuführen und das Steuerelement zu erweitern, um eine Liste mit anderen möglichen Aktionen, die ausgeführt werden können, anzuzeigen.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den SplitButton-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle SplitButton-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
• Beispiel für ein SplitButton-Steuerelement
• Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

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

Steuerelementansicht	Inhaltsansicht
SplitButton Bild (0 oder 1) Text (0 oder 1) Button (1 oder 2) Menu (0 oder 1; erscheint als untergeordnetes Element von Button, das das ExpandCollapse-Muster unterstützt) MenuItem (1 bis viele)	SplitButton MenuItem (1 bis viele)

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

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

UI Automation-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	"Back"	Der Name des SplitButton-Steuerelements wird auf der Schaltfläche angezeigt.
LabeledByProperty	Null	SplitButton-Steuerelemente verfügen nicht über eine statische Textbezeichnung.
ControlTypeProperty	SplitButton	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
LocalizedControlTypeProperty	"split button"	Lokalisierte Zeichenfolge, die dem SplitButton-Steuerelementtyp entspricht.
HelpTextProperty	Siehe Hinweise.	Der Hilfetext kann das Ergebnis der Aktivierung der Auswahlschaltfläche angeben. Hierbei handelt es sich in der Regel um dieselbe Information, wie sie über eine QuickInfo angezeigt wird.
IsContentElementProperty	True	Das SplitButton-Steuerelement enthält Informationen für den Endbenutzer.
IsControlElementProperty	True	Das SplitButton-Steuerelement ist für den Endbenutzer sichtbar.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

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

Steuerelementmuster	Unterstützung	Hinweise
IInvokeProvider	Erforderlich	Trennschaltflächen verfügen immer über eine Standardaktion, die Invoke zugeordnet ist.
IExpandCollapseProvider	Erforderlich	Trennschaltflächen verfügen immer über die Fähigkeit, eine Liste von Optionen zu erweitern.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI Automation-Ereignis	Unterstützung	Hinweise
InvokedEvent	Erforderlich	Keine
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte ExpandCollapseStateProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Beispiel für ein SplitButton-Steuerelement

Das folgende Bild zeigt einen SplitButton-Steuerelementtyp in einem DataGrid-Steuerelement.

Die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die zum DataGrid- und zum SplitButton-Steuerelement gehören, werden unten dargestellt. Die Steuerelementmuster für jedes Automatisierungselement sind in Klammern aufgeführt.

UI Automation-Struktur - Steuerelementansicht	UI Automation-Struktur - Inhaltsansicht
SplitButton "Name" (Invoke, ExpandCollapse) Button "Weitere Optionen" (Invoke) Menü MenuItem …	SplitButton "Name" (Invoke, ExpandCollapse) Button "Weitere Optionen" (Invoke) Menü MenuItem …

Siehe auch

Referenz

SplitButton

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung