Benutzeroberflächenautomatisierungs-Unterstützung für den RadioButton-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 RadioButton-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 schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Ein Optionsfeld besteht aus einer runden Schaltfläche mit einem durch die Anwendung festgelegten Text (einer Bezeichnung), einem Symbol oder einer Bitmap, von der eine Auswahl angezeigt wird, die über die Schaltfläche vom Benutzer vorgenommen werden kann. Optionsfelder werden von Anwendungen normalerweise in einem Gruppenfeld verwendet, sodass der Benutzer aus einer Reihe von verwandten, sich jedoch gegenseitig ausschließenden Optionen auswählen kann. Von einer Anwendung kann beispielsweise eine Gruppe von Optionsfeldern angezeigt werden, aus der ein Benutzer ein Format für den im Clientbereich markierten Text auswählen kann. Der Benutzer kann ein linksbündiges, rechtsbündiges oder zentriertes Format auswählen, indem er das entsprechende Optionsfeld aktiviert. Normalerweise kann aus einem Satz von Optionsfeldern lediglich eine Option ausgewählt werden.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den RadioButton-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Listensteuerelemente, 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, die sich auf RadioButton-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
RadioButton	RadioButton

Es gibt keine untergeordneten Elemente in der Steuerelementansicht oder der Inhaltsansicht.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für den RadioButton-Steuerelementtyp besonders wichtig sind. Weitere Informationen zu UI Automationseigenschaften 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.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
NameProperty	Siehe Hinweise.	Bei dem Namen des RadioButton-Steuerelements handelt es sich um den neben der Schaltfläche für den Auswahlzustand angezeigten Text.
ClickablePointProperty	Siehe Hinweise.	Der durch Klicken aktivierbare Punkt des RadioButton-Steuerelements MUSS der Punkt sein, von dem die Auswahl des Optionsfelds festgelegt wird, wenn mit dem Mauszeiger auf ihn geklickt wird.
LabeledByProperty	Null	Optionsfelder sind selbstbezeichnend.
ControlTypeProperty	RadioButton	Dieser Wert ist für alle UI-Frameworks identisch.
LocalizedControlTypeProperty	"Optionsfeld"	Lokalisierte Zeichenfolge, die dem RadioButton-Steuerelementtyp entspricht.
IsContentElementProperty	True	Das RadioButton-Steuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten.
IsControlElementProperty	True	Das RadioButton-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

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

Steuerelementmuster/Steuerelementmuster-Eigenschaft	Unterstützung/Wert	Hinweise
ISelectionItemProvider	Ja	Alle RadioButton-Steuerelemente können nur ausgewählt werden, wenn sie das SelectionItem-Muster unterstützen.
SelectionContainer	Siehe Hinweise.	Die SelectionContainerProperty muss immer abgeschlossen werden, sodass vom Benutzeroberflächenautomatisierungs-Client ermittelt werden kann, welche weiteren Optionsfelder sich in einem bestimmten Kontext aufeinander beziehen. Für die Win32-Version des Optionsfelds wird diese Eigenschaft nicht unterstützt, da diese Information in diesem Legacyframework nicht abgerufen werden kann.
IToggleProvider	Nie	Nachdem das Optionsfeld festgelegt wurde, kann es seinen Zustand nicht mehr durchlaufen. Dieses Muster darf für Optionsfelder nie unterstützt werden.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI Automation-Ereignis	Unterstützung	Hinweise
ElementRemovedFromSelectionEvent	Erforderlich	Keine
ElementSelectedEvent	Erforderlich	Keine
Durch geänderte ToggleStateProperty-Eigenschaft ausgelöstes Ereignis	Nie	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
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Siehe auch

Referenz

RadioButton

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung