Delen via

Ondersteuning voor UI Automation voor het besturingselementtype Selectievakje

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.

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 worden de vereiste structuur van de UI-automatiseringsboom, eigenschappen, bedieningspatronen en gebeurtenissen voor het type Selectievakje gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle selectievakbesturingselementen, of het nu gaat om Windows Presentation Foundation (WPF), Win32 of Windows Forms.

Vereiste structuur voor UI-automatisering

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.

Controleweergave Inhoudsweergave
Selectievakje Selectievakje

Opmerking

Selectievakjes hebben nooit onderliggende elementen in de besturingselement- of inhoudsweergave. Als het besturingselement kind-elementen moet bevatten, wijst dit erop 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. Voor meer informatie over UI Automation-eigenschappen, zie UI Automation-eigenschappen voor cliënten.

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.
ClickablePointProperty Zie notities. Ondersteund als er een begrenzingsrechthoek is. Als niet elk punt in de begrenzingsrechthoek kan worden geklikt en u gespecialiseerde hittests uitvoert, moet u dit overschrijven en een klikbaar punt bieden.
ControlTypeProperty Selectievakje Deze waarde is hetzelfde voor alle UI-frameworks.
IsContentElementProperty Klopt 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 Klopt 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 bij het besturingselementtype Selectievakje hoort.
NameProperty Zie notities. De waarde van de eigenschap van het selectievakje Name is de tekst die wordt weergegeven naast het vakje dat de schakeltoestand 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-automatiseringspatronenvoor meer informatie over besturingspatronen.

Besturingselementpatroon Ondersteuning Opmerkingen
IToggleProvider Verplicht 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-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning Opmerkingen
AutomationFocusChangedEvent Verplicht Geen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
StructureChangedEvent Verplicht Geen
ToggleStateProperty eigenschapswijziging-evenement. Verplicht 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, bieden selectievakjes de gebruiker een binaire beslissing (Ja/Nee) (Aan/Uit) of een tertiaire beslissing (Aan, Uit, Onbepaald). Als het selectievakje binair is, wordt de standaardactie de status 'aan' 'uit' of 'uit' weergegeven. In de tertiaire status doorloopt de standaardactie de statussen van het selectievakje in dezelfde volgorde alsof de gebruiker opeenvolgende muisklikken naar het besturingselement had gestuurd.

Zie ook

  • Last updated on