Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den RadioButton-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.
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-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den RadioButton-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-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-Automatisierung-Struktur, die sich auf RadioButton-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 |
|---|---|
|
|
Es gibt keine untergeordneten Elemente in der Steuerelementansicht oder der Inhaltsansicht.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für den RadioButton-Steuerelementtyp besonders wichtig sind. Weitere Informationen über die 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. |
Siehe Hinweise. |
Das äußere, das gesamte Steuerelement umfassende Rechteck. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
Siehe Hinweise. |
Bei dem Namen des RadioButton-Steuerelements handelt es sich um den neben der Schaltfläche für den Auswahlzustand angezeigten Text. |
|
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. |
|
Null |
Optionsfelder sind selbstbezeichnend. |
|
RadioButton |
Dieser Wert ist für alle Benutzeroberfläche-Frameworks identisch. |
|
"Optionsfeld" |
Lokalisierte Zeichenfolge, die dem RadioButton-Steuerelementtyp entspricht. |
|
True |
Das RadioButton-Steuerelement ist stets in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten. |
|
True |
Das RadioButton-Steuerelement ist stets in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten. |
Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
In der folgenden Tabelle werden die UI-Automatisierung-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 |
|---|---|---|
Ja |
Alle RadioButton-Steuerelemente können nur ausgewählt werden, wenn sie das SelectionItem-Muster unterstützen. |
|
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. |
|
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-Automatisierung-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-Automatisierung-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Erforderlich |
Keine |
|
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 |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung