Freigeben über

RadioButton-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des RadioButton-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

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

Ein weiteres Steuerelement für Schaltflächen, bei denen nur eine 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 erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Typ des RadioButton-Steuerelements definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Schaltflächensteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur der Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur, die sich auf Optionsfeldsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. 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.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für die Steuerelemente relevant ist, die den RadioButton-Steuerelementtyp implementieren (z. B. Schaltflächensteuerelemente). Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Der klickbare Punkt muss ein Punkt sein, der beim Klicken das Optionsfeld auswählt.
UIA_ControlTypePropertyId RadioButton
UIA_IsContentElementPropertyId TRUE Das Optionsfeld-Steuerelement ist stets in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten.
UIA_IsControlElementPropertyId TRUE Das Optionsfeld-Steuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_LabeledByPropertyId NULL Optionsfeldsteuerelemente werden durch ihren Inhalt selbst bezeichnet.
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 Optionsfeldsteuerelements ist der Text, der neben der Schaltfläche angezeigt wird, die den Auswahlstatus beibehält.

 

Erforderliche 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/Mustereigenschaft Unterstützung/Wert Hinweise
ISelectionItemProvider Erforderlich Alle Optionsfeldsteuerelemente müssen das SelectionItem-Steuerelementmuster unterstützen, damit sie sich selbst auswählen können.
Selectioncontainer Siehe Hinweise. Die SelectionContainer-Eigenschaft muss immer abgeschlossen werden, damit ein Benutzeroberflächenautomatisierung Client bestimmen kann, welche anderen Optionsfelder in einem bestimmten Kontext 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 aus diesem Legacyframework abzurufen.
IToggleProvider Nie Das Optionsfeld kann seinen Zustand nicht durchlaufen, nachdem es festgelegt wurde. Das Steuerelementmuster "Umschalten" darf niemals für ein Optionsfeld unterstützt werden.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Von Schaltflächensteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Hinweise
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaftsänderungsereignis. 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 enthalten, oder eine Reihe von Optionsfeldern, die nach einer Gruppenbezeichnung, aber vor einem umsetzbaren Element wie schaltfläche auftreten.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung