UI Automation-ondersteuning voor het kringveldbesturingstype
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-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.
Spinnerbesturingselementen worden gebruikt om te selecteren uit een domein met items of een reeks getallen.
In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type Spinner-besturingselement gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle besturingselementen voor spinners, 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 hebben op spinnerbesturingselementen wanneer ze ondersteuning bieden voor de patronen bereikwaarde, waarde en selectie en beschrijft wat in elke weergave kan worden opgenomen. Zie Overzicht van ui-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.
Patroon bereikwaarde of waardebeheer
| Besturingselementweergave | Inhoudsweergave |
|---|---|
| Spinner - Bewerken (0 of 1) - Knop (2) |
Spinner |
Selectiebeheerpatroon
| Besturingselementweergave | 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 SmallDecrement AutomationId indien nodig toe. Voor sommige implementaties kan het bijbehorende besturingselement Bewerken een peer zijn van het kringveldbesturingselement.
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 | 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. | Het klikbare punt van het kringveld van het kringveld geeft de focus naar 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 kringveld besturingselement krijgt doorgaans de naam van een statisch tekstlabel. |
| LabeledByProperty | Zie notities. | Kringveldbesturingselementen hebben een statisch tekstlabel. |
| ControlTypeProperty | Spinner | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "spinner" | Gelokaliseerde tekenreeks die overeenkomt met het type Spinner-besturingselement. |
| IsContentElementProperty | Waar | Het spinner-besturingselement moet altijd inhoud zijn. |
| 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.
| Besturingselementpatroon/patrooneigenschap | Ondersteuning/waarde | Opmerkingen |
|---|---|---|
| ISelectionProvider | Hangt | Kringveldbesturingselementen met een lijst met items die moeten worden geselecteerd, moeten dit patroon ondersteunen. |
| CanSelectMultiple | Onwaar | Spinner-besturingselementen zijn altijd enkele selectiecontainers. |
| IRangeValueProvider | Hangt | Spinner-besturingselementen die een numeriek bereik omvatten, kunnen dit patroon ondersteunen. |
| IValueProvider | Hangt | 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 Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| InvalidatedEvent | Hangt | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| ValueProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| ValueProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |