RadioButton-Steuerelementtyp
Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung Unterstützung für den RadioButton-Steuerelementtyp.
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.
Hinweis
Eine weitere Steuerelement generalisierung für Schaltflächen, bei denen nur eines in einer Gruppe ausgewählt werden kann, ist der Inhalt einer Umschaltfläche. Einige Benutzeroberflächenframeworks betrachten ein Optionsfeld als spezielle Umschaltfläche.
In den folgenden Abschnitten werden die Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den RadioButton-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung gelten für alle Schaltflächensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Anmerkungen
- Zugehörige Themen
Typische Strukturstruktur
Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung struktur, die sich auf Optionsfeldsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur Benutzeroberflächenautomatisierung Struktur finden Sie unter Benutzeroberflächenautomatisierung Strukturübersicht.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Es sind keine untergeordneten Elemente in der Steuerelementansicht oder der Inhaltsansicht enthalten.
Relevante Eigenschaften
In der folgenden Tabelle sind die eigenschaften Benutzeroberflächenautomatisierung, deren Wert oder Definition für die Steuerelemente, die den RadioButton-Steuerelementtyp implementieren (z. B. Schaltflächensteuerelemente), besonders relevant ist. Weitere Informationen zu Eigenschaften Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA _ AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung sein. |
| UIA _ BoundingRectanglePropertyId | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| UIA _ ClickablePointPropertyId | Siehe Hinweise. | Der anklickbare Punkt muss ein Punkt sein, der das Optionsfeld auswählt, wenn darauf geklickt wird. |
| UIA _ ControlTypePropertyId | RadioButton | |
| UIA _ IsContentElementPropertyId | TRUE | Das Optionsfeld-Steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Optionsfeld-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung enthalten. |
| UIA _ IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA _ LabeledByPropertyId | NULL | Optionsfeld-Steuerelemente sind durch ihren Inhalt selbstbeschriftet. |
| UIA _ LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem RadioButton-Steuerelementtyp entspricht. Der Standardwert ist "Optionsfeld" für en-US oder Englisch (USA). |
| UIA _ NamePropertyId | Siehe Hinweise. | Der Name des Optionsfeld-Steuerelements ist der Text, der neben der Schaltfläche angezeigt wird, die den Auswahlzustand bei behält. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die von allen Optionsfeldsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Mustereigenschaft | Unterstützung/Wert | Notizen |
|---|---|---|
| ISelectionItemProvider | Erforderlich | Alle Optionsfeld-Steuerelemente müssen das SelectionItem-Steuerelementmuster unterstützen, damit sie selbst ausgewählt werden können. |
| Selectioncontainer | Siehe Hinweise. | Die SelectionContainer-Eigenschaft muss immer abgeschlossen werden, damit Benutzeroberflächenautomatisierung Client bestimmen kann, welche anderen Optionsfelder innerhalb eines bestimmten Kontexts miteinander in Beziehung stehen. Für die Microsoft Win32-Version des Optionsfelds wird diese Eigenschaft nicht unterstützt, da es nicht möglich ist, diese Informationen von diesem Legacyframework zu erhalten. |
| IToggleProvider | Nie | Das Optionsfeld kann seinen Zustand nicht durchlaufen, nachdem es festgelegt wurde. Das Umschalten-Steuerelementmuster darf auf einem Optionsfeld nie unterstützt werden. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die Schaltflächensteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ AutomationFocusChangedEventId | |
| UIA _ Das BoundingRectanglePropertyId-Eigenschaftswechselereignis. | |
| UIA _ Das IsEnabledPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ IsOffscreenPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ _ SelectionItem-ElementRemovedFromSelectionEventId | Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ _ SelectionItem-ElementSelectedEventId | Wenn das Steuerelement das SelectionItem-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ StructureChangedEventId |
Bemerkungen
Ein Optionsfeld stellt eine einzelne auswählbare Option unter einer Gruppe von Peer-Optionsfeldern dar. Im Idealfall sollten Optionsfelder über ein Gruppierungselement verfügen, das die Grenzen der Peer-Optionsfelder verdeutlicht. Häufig wird die Grenze jedoch durch die Ui-Elementstruktur impliziert. Beispielsweise kann ein Menü eine Reihe von aufeinander folgenden Optionsfeldern anstelle von Menüelementen oder eine Reihe von Optionsfeldern enthalten, die nach einer Gruppenbezeichnung, aber vor einem aktionsfähigen Element wie button auftreten.