Delen via

Type keuzerondje

  • Artikel

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 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
  • RadioButton
  • RadioButton

 

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.

conceptuele

Overzicht van Ui Automation-besturingstypen

Overzicht van UI Automation-