Ondersteuning voor UI Automation voor het besturingselementtype Selectievakje
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.
In dit onderwerp vindt u informatie over microsoft UI Automation-ondersteuning voor het type besturingselement Selectievakje. 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 selectievakje is een object dat wordt gebruikt om een status aan te geven waarmee gebruikers kunnen communiceren om die status te doorlopen. Selectievakjes bevatten een binaire optie (Ja/Nee), (Aan/Uit) of tertiaire optie (Aan, Uit, Onbepaald) voor de gebruiker.
In de volgende secties wordt de vereiste structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type Controlevak gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle besturingselementen voor selectievakjes, 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 selectievakjes 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 |
|---|---|
| CheckBox | CheckBox |
Notitie
Selectievakjes hebben nooit onderliggende elementen in de besturingselement- of inhoudsweergave. Als het besturingselement onderliggende elementen moet bevatten, geeft dit aan dat een ander type besturingselement moet worden gebruikt.
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor besturingselementen voor selectievakjes. 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. |
| ClickablePointProperty | Zie notities. | Ondersteund als er een begrenzingsrechthoek is. Als niet elk punt in de begrenzingsrechthoek kan worden geklikt en u gespecialiseerde hittests uitvoert, overschrijft en geeft u een klikbaar punt op. |
| ControlTypeProperty | CheckBox | Deze waarde is hetzelfde voor alle UI-frameworks. |
| IsContentElementProperty | Waar | De waarde van deze eigenschap moet altijd Waar zijn. Dit betekent dat het selectievakjebesturingselement altijd moet worden opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | De waarde van deze eigenschap moet altijd Waar zijn. Dit betekent dat het selectievakjebesturingselement altijd moet worden opgenomen in de besturingsweergave van de UI Automation-structuur. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| LabeledByProperty | Null |
Selectievakjes zijn besturingselementen voor zelflabeling. |
| LocalizedControlTypeProperty | "selectievakje" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Selectievakje. |
| NameProperty | Zie notities. | De waarde van de eigenschap van het selectievakjebesturingselement Name is de tekst die wordt weergegeven naast het vak dat de wisselknopstatus behoudt. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door alle besturingselementen voor selectievakjes. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IToggleProvider | Vereist | Hiermee staat u toe dat het selectievakje programmatisch door de interne statussen wordt gecyclusd. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor selectievakjes. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| AutomationFocusChangedEvent | Vereist | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| StructureChangedEvent | Vereist | Geen |
| ToggleStateProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
Standaardactie
De standaardactie van het selectievakje is ervoor te zorgen dat een keuzerondje gericht wordt en de huidige status ervan in- of uitschakelen. Zoals eerder vermeld, bevatten selectievakjes een binaire beslissing (Ja/Nee) (Aan/Uit) aan de gebruiker of een tertiair (Aan, Uit, Onbepaald). Als het selectievakje binair is, wordt de standaardactie de status 'aan' 'uit' of 'uit' weergegeven. In een tertiaire status schakelt de standaardactie de statussen van het selectievakje in dezelfde volgorde in alsof de gebruiker opeenvolgende muisklikken naar het besturingselement had verzonden.