Benutzeroberflächenautomatisierungs-Unterstützung für den RadioButton-Steuerelementtyp
Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.
In diesem Thema erhalten Sie Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Steuerelementtyp „RadioButton“. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwenden zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.
Ein Optionsfeld besteht aus einer runden Schaltfläche und anwendungsdefiniertem Text (eine Bezeichnung), einem Symbol oder eine Bitmap, die eine Option anzeigt, die der Benutzer durch Aktivieren der Schaltfläche auswählen kann. Eine Anwendung verwendet in der Regel Optionsfelder in einem Gruppenfeld, um es dem Benutzer zu gestatten, aus einer Gruppe von verwandten, aber sich gegenseitig ausschließenden Optionen auszuwählen. Die Anwendung kann z. B. eine Gruppe von Optionsfeldern darstellen, unter denen der Benutzer eine Formateinstellung für Text auswählen kann, der im Clientbereich markiert ist. Der Benutzer kann ein linksbündiges, rechtsbündiges oder zentriertes Format auswählen, indem er das entsprechende Optionsfeld aktiviert. In der Regel kann der Benutzer jeweils nur eine Option zur Zeit aus einer Gruppe von Optionsfeldern auswählen.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „RadioButton“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Listensteuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Optionsfeld-Steuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| RadioButton | RadioButton |
Es sind keine untergeordneten Elemente in der Steuerelementansicht oder der Inhaltsansicht enthalten.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition für den Steuerelementtyp „RadioButton“ von besonderem Interesse ist. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| AutomationIdProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein. |
| BoundingRectangleProperty | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| NameProperty | Siehe Hinweise. | Der Name des Optionsfeldsteuerelements ist der Text, der neben der Schaltfläche angezeigt wird, die den Auswahlzustand beibehält. |
| ClickablePointProperty | Siehe Hinweise. | Der durch Klicken aktivierbare Punkt des Optionsfeldsteuerelements MUSS ein Punkt sein, der die Auswahl für das Optionsfeld festlegt, wenn mit dem Mauszeiger auf ihn geklickt wird. |
| LabeledByProperty | Null |
Optionsfelder sind selbstbeschriftende Steuerelemente. |
| ControlTypeProperty | RadioButton | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| LocalizedControlTypeProperty | „Optionsfeld“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „RadioButton“. |
| IsContentElementProperty | True | Das Optionsfeld-Steuerelement ist stets in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| IsControlElementProperty | True | Das Optionsfeld-Steuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von allen Optionsfeld-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Steuerelementmustereigenschaft | Unterstützung/Wert | Hinweise |
|---|---|---|
| ISelectionItemProvider | Ja | Alle Optionsfeldsteuerelemente müssen das SelectionItem-Muster unterstützen, um ihre Aktivierung zu ermöglichen. |
| SelectionContainer | Siehe Hinweise. | Die SelectionContainerProperty muss immer abgeschlossen werden, damit ein Benutzeroberflächenautomatisierungs-Client ermitteln kann, welche anderen Optionsfelder sich in einem bestimmten Kontext aufeinander beziehen. Für die Win32-Version des Optionsfelds wird diese Eigenschaft nicht unterstützt, da es nicht möglich ist, diese Informationen über das Legacyframework abzurufen. |
| IToggleProvider | Nie | Das Optionsfeld kann seinen Zustand nicht durchlaufen, nachdem es festgelegt wurde. Dieses Muster darf von einem Optionsfeld nie unterstützt werden. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabellen sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Optionsfeld-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Notizen |
|---|---|---|
| ElementRemovedFromSelectionEvent | Erforderlich | Keine |
| ElementSelectedEvent | Erforderlich | Keine |
| Durch geänderteToggleStateProperty -Eigenschaft ausgelöstes Ereignis. | Nie | Keine |
| Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |