Ui Automation-ondersteuning voor het besturingselementtype RadioButton
Notitie
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 Automation voor 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 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.
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 van ui-automatiseringsstructuur
In de volgende tabel ziet u de besturingsweergave en de inhoudsweergave van de UI Automation-structuur die betrekking heeft op besturingselementen voor keuzerondjes en wordt beschreven wat in elke weergave kan worden opgenomen. Zie Overzicht van ui-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.
| Besturingselementweergave | Inhoudsweergave |
|---|---|
| Radiobutton | Radiobutton |
Er zijn geen onderliggende elementen 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 Eigenschappen van UI Automation voor clients voor meer informatie over eigenschappen van UI Automation.
| Ui Automation-eigenschap | Weergegeven als | 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 het keuzerondje is de tekst die wordt weergegeven naast de knop die de selectiestatus behoudt. |
| ClickablePointProperty | Zie notities. | Het besturingselement van het keuzerondje moet een punt zijn waarmee de selectie op het keuzerondje wordt ingesteld als er met een muiswijzer wordt geklikt. |
| LabeledByProperty | Null |
Keuzerondjes zijn besturingselementen voor zelflabeling. |
| ControlTypeProperty | Radiobutton | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "keuzerondje" | Gelokaliseerde tekenreeks die overeenkomt met het type RadioButton-besturingselement. |
| IsContentElementProperty | Waar | Het keuzerondje wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | Het keuzerondje wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de UI Automation-besturingspatronen die moeten worden ondersteund door alle besturingselementen voor keuzerondjes. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Eigenschap Control Pattern/Control Pattern | Ondersteuning/waarde | Opmerkingen |
|---|---|---|
| ISelectionItemProvider | Ja | Alle besturingselementen voor keuzerondje moeten het patroon Selectie-item ondersteunen om zichzelf in staat te stellen te worden geselecteerd. |
| SelectionContainer | Zie notities. | Het SelectionContainerProperty 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 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. Dit patroon mag nooit worden ondersteund op het keuzerondje. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor keuzerondjes. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| ElementRemovedFromSelectionEvent | Vereist | Geen |
| ElementSelectedEvent | Vereist | Geen |
| ToggleStateProperty eigenschap gewijzigd gebeurtenis. | Nooit | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |