Benutzeroberflächenautomatisierungs-Unterstützung für den Schaltflächen-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 Button-Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen enthalten bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte, Steuerelementmuster und UI Automation-Ereignisse.

Eine Schaltfläche ist ein Objekt, mit dem ein Benutzer interagiert, um eine Aktion auszuführen, z. B. die Schaltflächen OK und Abbrechen in einem Dialogfeld. Das Schaltflächen-Steuerelement wird auf einfache Weise verfügbar gemacht, da es einem bestimmten Befehl zugeordnet ist, den der Benutzer ausführen möchte.

In den folgenden Abschnitten werden die UI Automation-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den Schaltflächen-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Schaltflächen-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.

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 Automation-Struktur für Button-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
Button Bild (beliebige Anzahl) Text (beliebige Anzahl)	Button

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition für die Steuerelemente besonders relevant ist, die den Schaltflächen-Steuerelementtyp implementieren (wie z. B. Schaltflächen-Steuerelemente). Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft	Wert	Hinweise
AcceleratorKeyProperty	Siehe Hinweise.	Das Schaltflächen-Steuerelement muss in der Regel eine Tastenkombination unterstützen, damit Endbenutzer die durch das Steuerelement dargestellte Aktion schnell über die Tastatur ausführen können.
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.
ControlTypeProperty	Button	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
HelpTextProperty	Siehe Hinweise.	Der Hilfetext kann angeben, welches Ergebnis durch Aktivieren der Schaltfläche erreicht wird. Hierbei handelt es sich in der Regel um dieselbe Information, wie sie über eine QuickInfo angezeigt wird.
IsContentElementProperty	True	Das Schaltflächen-Steuerelement muss stets ein Inhaltselement sein.
IsControlElementProperty	True	Das Schaltflächen-Steuerelement muss stets ein Steuerelement sein.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
LabeledByProperty	Null	Schaltflächen-Steuerelemente haben aufgrund ihres Inhalts eine Eigenbezeichnung.
LocalizedControlTypeProperty	"Schaltfläche"	Lokalisierte Zeichenfolge, die dem Schaltflächen-Steuerelementtyp entspricht.
NameProperty	Siehe Hinweise.	Der Name des Schaltflächen-Steuerelements ist der Text, mit dem es beschriftet wird. Wenn ein Bild zum Bezeichnen einer Schaltfläche verwendet wird, muss für die Name-Eigenschaft der Schaltfläche ein Alternativtext angegeben werden.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von allen Schaltflächen-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	Siehe Hinweise.	Alle Schaltflächen müssen das Invoke-Steuerelementmuster oder das Toggle-Steuerelementmuster unterstützen. Invoke wird unterstützt, wenn die Schaltfläche auf Anforderung des Benutzers einen Befehl ausführt. Dieser Befehl wird einem einzelnen Vorgang zugeordnet, z. B. Ausschneiden, Kopieren, Einfügen oder Löschen.
IToggleProvider	Siehe Hinweise.	Alle Schaltflächen müssen das Invoke-Steuerelementmuster oder das Toggle-Steuerelementmuster unterstützen. Toggle wird unterstützt, wenn die Schaltfläche maximal drei Zustände durchlaufen kann. In der Regel ist dies als Ein-/Ausschalter für bestimmte Features realisiert.
IExpandCollapseProvider	Siehe Hinweise.	Wenn eine Schaltfläche als untergeordnetes Element einer Auswahlschaltfläche gehostet wird, kann die untergeordnete Schaltfläche anstelle des Aufrufs oder Umschaltmusters das ExpandCollapse-Muster unterstützen. Das ExpandCollapse-Muster kann zum Öffnen oder Schließen eines Menüs oder einer anderen, dem Schaltflächenelement zugeordneten Unterstruktur verwendet werden.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI Automation-Ereignis	Unterstützung	Hinweise
AutomationFocusChangedEvent	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 NameProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine
InvokedEvent	Variabel	Wenn das Steuerelement das Invoke-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
Durch geänderte Eigenschaft ausgelöstes ToggleStateProperty-Ereignis.	Variabel	Wenn das Steuerelement das Toggle-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

Siehe auch

Referenz

Button

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung