Type keuzerondje
In dit onderwerp vindt u informatie over microsoft UI Automation-ondersteuning voor het RadioButton besturingselementtype.
Een keuzerondje bestaat uit een ronde knop en toepassingsgedefinieerde tekst (een label), een pictogram of een bitmap die aangeeft welke keuze de gebruiker kan maken door de knop te selecteren. Een toepassing maakt doorgaans gebruik van keuzerondjes in een groepsvak om de gebruiker in staat te stellen uit een set gerelateerde, maar wederzijds exclusieve opties te kiezen. De toepassing kan bijvoorbeeld een groep keuzerondjes presenteren waaruit de gebruiker een indelingsvoorkeur voor tekst kan selecteren die is geselecteerd in het clientgebied. De gebruiker kan een links uitgelijnde, rechts uitgelijnde of gecentreerde indeling selecteren door het bijbehorende keuzerondje te selecteren. Normaal gesproken kan de gebruiker slechts één optie tegelijk selecteren in een set keuzerondjes.
Notitie
Een andere besturingsgenerisatie voor knoppen waar slechts één in een groep kan worden geselecteerd, is de inhoud van een wisselknop. Sommige UI-frameworks beschouwen een keuzerondje als een speciale wisselknop.
In de volgende secties worden de vereiste structuur, eigenschappen, besturingspatronen en gebeurtenissen voor de RadioButton besturingselementtype gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle knopbesturingselementen waarbij het UI-framework/-platform UI Automation-ondersteuning integreert voor besturingstypen en besturingspatronen.
Dit onderwerp bevat de volgende secties.
- typische structuurstructuur
- relevante eigenschappen
- Vereiste besturingspatronen
- vereiste gebeurtenissen
- opmerkingen
- Verwante onderwerpen
Typische boomstructuur
In de volgende tabel ziet u een typische besturings- en inhoudsweergave van de UI Automation-structuur die betrekking heeft op besturingselementen voor keuzerondjes en beschrijft wat in elke weergave kan worden opgenomen. Zie OVERZICHT van ui-automatiseringsstructuurvoor meer informatie over de UI Automation-structuur.
Besturingselementweergave | Inhoudsweergave |
---|---|
|
|
Er zijn geen onderliggende elementen in de besturingselementweergave of de inhoudsweergave.
Relevante eigenschappen
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor de besturingselementen die de RadioButton besturingselementtype implementeren (zoals knopbesturingselementen). Zie Eigenschappen ophalen uit UI Automation Elementsvoor meer informatie over eigenschappen van UI Automation Automation.
Ui Automation-eigenschap | Waarde | Notities |
---|---|---|
UIA_AutomationIdPropertyId | Zie notities. | De waarde van deze eigenschap moet uniek zijn voor alle peerelementen in de onbewerkte weergave van de UI Automation-structuur. |
UIA_BoundingRectanglePropertyId | Zie notities. | De buitenste rechthoek die het hele besturingselement bevat. |
UIA_ClickablePointPropertyId | Zie notities. | Het klikbare punt moet een punt zijn dat, wanneer erop wordt geklikt, het keuzerondje selecteert. |
UIA_ControlTypePropertyId | RadioButton- | |
UIA_IsContentElementPropertyId | WAAR | Het keuzerondje wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
UIA_IsControlElementPropertyId | WAAR | Het keuzerondje wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
UIA_IsKeyboardFocusablePropertyId | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
UIA_LabeledByPropertyId | NUL | Besturingselementen voor keuzeronden worden zelf gelabeld door hun inhoud. |
UIA_LocalizedControlTypePropertyId | Zie notities. | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype RadioButton. De standaardwaarde is 'keuzerondje' voor en-US of Engels (Verenigde Staten). |
UIA_NamePropertyId | Zie notities. | De naam van het keuzerondje is de tekst die wordt weergegeven naast de knop die de selectiestatus behoudt. |
Vereiste besturingspatronen
De volgende tabel bevat de UI Automation-besturingspatronen die moeten worden ondersteund door alle besturingselementen voor keuzerondjes. Zie Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.
Besturingselementpatroon/patrooneigenschap | Ondersteuning/waarde | Notities |
---|---|---|
ISelectionItemProvider | Vereist | Alle besturingselementen voor keuzeronden moeten het SelectionItem besturingspatroon ondersteunen om zichzelf in staat te stellen te worden geselecteerd. |
SelectionContainer- | Zie notities. | De eigenschap SelectionContainer moet altijd worden voltooid, zodat een UI Automation-client kan bepalen welke andere keuzerondjes binnen een specifieke context met elkaar te maken hebben. Voor de Microsoft Win32-versie van het keuzerondje wordt deze eigenschap niet ondersteund omdat het niet mogelijk is om deze informatie op te halen uit dat verouderde framework. |
IToggleProvider- | Nooit | Het keuzerondje kan niet door de status bladeren zodra het is ingesteld. Het wisselpatroon besturingselement mag nooit worden ondersteund op een keuzerondje. |
Vereiste gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die knopbesturingselementen moeten ondersteunen. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.
Ui Automation-gebeurtenis | Notities |
---|---|
UIA_AutomationFocusChangedEventId | |
UIA_BoundingRectanglePropertyId gebeurtenis die door eigenschappen is gewijzigd. | |
UIA_IsEnabledPropertyId gebeurtenis die door eigenschap is gewijzigd. | Als het besturingselement de eigenschap IsEnabled ondersteunt, moet het deze gebeurtenis ondersteunen. |
UIA_IsOffscreenPropertyId gebeurtenis die door eigenschap is gewijzigd. | Als het besturingselement de eigenschap IsOffscreen ondersteunt, moet het deze gebeurtenis ondersteunen. |
UIA_SelectionItem_ElementRemovedFromSelectionEventId | Als het besturingselement het patroon SelectionItem ondersteunt, moet het deze gebeurtenis ondersteunen. |
UIA_SelectionItem_ElementSelectedEventId | Als het besturingselement het patroon SelectionItem ondersteunt, moet het deze gebeurtenis ondersteunen. |
UIA_StructureChangedEventId |
Opmerkingen
Een keuzerondje vertegenwoordigt één selecteerbare optie tussen een groep peer keuzerondjes. In het ideale geval moeten keuzerondjes een groeperingselement hebben dat de grenzen van de peer-keuzerondjes verduidelijkt. Vaak wordt de grens echter geïmpliceerd door de structuur van het ui-element. Een menu kan bijvoorbeeld een reeks opeenvolgende keuzerondjes bevatten in plaats van menu-items, of een set keuzerondjes die plaatsvinden na een groepslabel, maar vóór een actie-element zoals knop.
Verwante onderwerpen
-
conceptuele
-
Overzicht van Ui Automation-besturingstypen
-
Overzicht van UI Automation-