UI Automation-ondersteuning voor het Spinner-besturingselement

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 Spinner-controle. 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.

Spinnerbesturingselementen worden gebruikt om te selecteren uit een domein met items of een reeks getallen.

In de volgende secties worden de vereiste structuur van de UI Automation-tree, eigenschappen, besturingspatronen en gebeurtenissen voor het besturingselementtype Spinner gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle spinnerbesturingselementen, ongeacht of het nu Windows Presentation Foundation (WPF), Win32 of Windows Forms betreft.

Vereiste UI Automation-boomstructuur

In de volgende tabel ziet u de bedieningsweergave en inhoudsweergave van de UI Automation-structuur die betrekking hebben op spinnerbesturingselementen wanneer deze ondersteuning bieden voor de besturingspatronen bereikwaarde, waarde en selectie, en wordt beschreven wat in elke weergave kan worden opgenomen. Zie Overzicht van ui-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.

Bereikwaarde of waardecontrolepatroon

Controleweergave Inhoudsweergave
Spinner

- Bewerken (0 of 1)
- Knop (2)
Spinner

Selectiebeheerpatroon

Controleweergave Inhoudsweergave
Spinner

- Bewerken (0 of 1)
- Knop (2)
- Lijstitem (0 of meer)
Spinner

- ListItem (0 of meer)

Om ervoor te zorgen dat de twee knoppen in de substructuur van de besturingsweergave kunnen worden onderscheiden door geautomatiseerde testhulpprogramma's, wijst u de SmallIncrement of SmallDecrementAutomationId indien nodig toe. Voor sommige implementaties kan het bijbehorende Bewerken-besturingselement een gelijke zijn van de spinner.

Vereiste eigenschappen van UI Automation

De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor spinnerbesturingselementen. Zie Eigenschappen van UI Automation voor clients voor meer informatie over eigenschappen van UI Automation.

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. Het klikbare punt van het kringveld plaatst de focus op het bewerkingsgedeelte van het besturingselement.
IsKeyboardFocusableProperty Zie notities. Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen.
NameProperty Zie notities. Het besturingselement "spinner" krijgt meestal zijn naam van een statisch tekstlabel.
LabeledByProperty Zie notities. Draaiknopbesturingen hebben een tekstlabel.
ControlTypeProperty Spinner Deze waarde is hetzelfde voor alle UI-frameworks.
LocalizedControlTypeProperty fidget spinner Gelokaliseerde tekenreeks die overeenkomt met het type Spinner-besturingselement.
IsContentElementProperty Waar Het spinner-besturingselement moet altijd inhoud bevatten.
IsControlElementProperty Waar De Spinner-besturing moet altijd een besturingselement zijn.

Vereiste patronen en eigenschappen van ui-automatiseringsbeheer

De volgende tabel bevat de UI Automation-besturingspatronen die moeten worden ondersteund door spinnerbesturingselementen. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.

Bedieningpatroon/patrooneigenschap Ondersteuning/waarde Opmerkingen
ISelectionProvider Hangt af van Draai-elementen met een lijst van te selecteren items, moeten dit patroon ondersteunen.
CanSelectMultiple Onwaar Spinner-besturingselementen zijn altijd enkele selectiecontainers.
IRangeValueProvider Dat hangt ervan af Spinner-besturingselementen die een numeriek bereik omvatten, kunnen dit patroon ondersteunen.
IValueProvider Het hangt ervan af Spinner-besturingselementen die een discrete set opties of getallen omvatten, kunnen dit patroon ondersteunen.

Vereiste UI Automation-gebeurtenissen

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

UI-automatiseringsgebeurtenis Ondersteuning Opmerkingen
InvalidatedEvent Het hangt ervan af Geen
BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. Vereist Geen
IsOffscreenProperty eigenschap gewijzigd gebeurtenis. Vereist Geen
IsEnabledProperty eigenschap gewijzigd gebeurtenis. Vereist Geen
ValueProperty eigenschap gewijzigd gebeurtenis. Dat hangt ervan af Geen
ValueProperty eigenschap gewijzigd gebeurtenis. Hangt ervan af Geen
AutomationFocusChangedEvent Vereist Geen
StructureChangedEvent Vereist Geen

Zie ook