UI-automatiseringsondersteuning voor het bedieningselementtype radioknop

Opmerking

Deze documentatie is bedoeld voor .NET Framework-ontwikkelaars die de beheerde UI Automation-klassen willen gebruiken die zijn gedefinieerd in de System.Windows.Automation naamruimte. Zie Windows Automation-API: UI Automationvoor de meest recente informatie over UI Automation.

Dit onderwerp bevat informatie over ui Automation-ondersteuning voor het type RadioButton-besturingselement. In UI Automation is een besturingselementtype een set voorwaarden waaraan een besturingselement moet voldoen om de ControlTypeProperty eigenschap te kunnen gebruiken. De voorwaarden omvatten specifieke richtlijnen voor de structuur van de UI Automation-structuur, waarden voor UI Automation-eigenschappen en besturingspatronen.

Een radioknop 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 radioknoppen in een groepsvak zodat de gebruiker kan kiezen uit een set van gerelateerde, maar wederzijds exclusieve opties. 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 opmaak selecteren door het bijbehorende keuzerondje te selecteren. Normaal gesproken kan de gebruiker slechts één optie tegelijk selecteren in een set radioknoppen.

In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type RadioButton-besturingselement gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle lijstbesturingselementen, ongeacht of Windows Presentation Foundation (WPF), Win32 of Windows Forms.

Vereiste structuur voor UI-automatisering

De volgende tabel toont de besturingsweergave en de inhoudsweergave van de UI Automation-structuur die betrekking heeft op radioknoppen en beschrijft wat in elke weergave kan worden opgenomen. Zie Overzicht van ui-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.

Controleweergave Inhoudsweergave
RadioButton RadioButton

Er zijn geen kinderen in de besturingselementweergave of de inhoudsweergave.

Vereiste eigenschappen van UI Automation

De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor het type RadioButton-besturingselement. Zie UI Automation-eigenschappen voor cliënten voor meer informatie over UI Automation-eigenschappen.

UI Automation-eigenschap Waarde Opmerkingen
AutomationIdProperty Zie notities. De waarde van deze eigenschap moet uniek zijn voor alle besturingselementen in een toepassing.
BoundingRectangleProperty Zie notities. De buitenste rechthoek die het hele besturingselement bevat.
IsKeyboardFocusableProperty Zie notities. Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen.
NameProperty Zie notities. De naam van de radioknop is de tekst die wordt weergegeven naast de knop die de selectie behoudt.
ClickablePointProperty Zie notities. Het klikbare punt van het keuzerondje moet noodzakelijkerwijs een punt zijn waarmee de selectie wordt ingesteld als erop wordt geklikt met de muis.
LabeledByProperty Null Keuzerondjes zijn zelflabelende besturingselementen.
ControlTypeProperty RadioButton Deze waarde is hetzelfde voor alle UI-frameworks.
LocalizedControlTypeProperty "keuzerondje" Gelokaliseerde tekenreeks die overeenkomt met het type RadioButton-besturingselement.
IsContentElementProperty Klopt De keuzerondoknop wordt altijd opgenomen in de inhoudsweergave van de UI Automation-boom.
IsControlElementProperty Klopt De radioknop wordt altijd opgenomen in de bedieningselementweergave van de UI-automatiseringsboom.

Vereiste patronen voor ui-automatiseringsbeheer

De volgende tabel bevat de UI Automation-besturingspatronen die ondersteund moeten worden door alle radioknopbesturingselementen. Zie Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.

Control Pattern/Eigenschap Control Pattern Ondersteuning/waarde Opmerkingen
ISelectionItemProvider Ja Alle besturingselementen voor keuzerondjes moeten het selectie-item patroon ondersteunen om geselecteerd te kunnen worden.
SelectionContainer Zie notities. Het SelectionContainerProperty moet altijd worden voltooid, zodat een UI Automation-client kan bepalen welke andere radioknoppen binnen een specifieke context met elkaar te maken hebben. Voor de Win32-versie van de radioknop wordt deze eigenschap niet ondersteund omdat het niet mogelijk is om deze informatie te verkrijgen van dat verouderde framework.
IToggleProvider Nooit Het keuzerondje kan niet door de status bladeren zodra het is ingesteld. Dit patroon mag nooit worden ondersteund op het keuzerondvakje.

Vereiste UI Automation-gebeurtenissen

De volgende tabel bevat de UI Automation-gebeurtenissen die ondersteund moeten worden door alle keuzerondjes. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.

UI-automatiseringsgebeurtenis Ondersteuning Opmerkingen
ElementRemovedFromSelectionEvent Verplicht Geen
ElementSelectedEvent Verplicht Geen
ToggleStateProperty eigenschapswijziging-evenement. Nooit Geen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
AutomationFocusChangedEvent Verplicht Geen
StructureChangedEvent Verplicht Geen

Zie ook

  • Last updated on