Stöd för användargränssnittsautomatisering för kontrolltypen Spinner
Kommentar
Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.
Det här avsnittet innehåller information om stöd för UI Automation för kontrolltypen Spinner. I UI Automation är en kontrolltyp en uppsättning villkor som en kontroll måste uppfylla för att kunna använda egenskapen ControlTypeProperty . Villkoren innehåller specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och kontrollmönster.
Spinner-kontroller används för att välja från en domän med objekt eller ett intervall med tal.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen Spinner. Kraven för UI Automation gäller för alla spinner-kontroller, oavsett om det gäller Windows Presentation Foundation (WPF), Win32 eller Windows Forms.
Obligatorisk trädstruktur för användargränssnittsautomatisering
Följande tabell visar kontrollvyn och innehållsvyn för UI Automation-trädet som gäller för rotationskontroller när de stöder kontrollmönstren Range Value, Value och Selection och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i Översikt över UI Automation Tree.
Mönster för områdesvärde eller värdekontroll
| Kontrollvy | Innehållsvy |
|---|---|
| Rotationsknapp – Redigera (0 eller 1) - Knapp (2) |
Rotationsknapp |
Mönster för markeringskontroll
| Kontrollvy | Innehållsvy |
|---|---|
| Rotationsknapp – Redigera (0 eller 1) - Knapp (2) - Listobjekt (0 eller mer) |
Rotationsknapp - ListItem (0 eller mer) |
För att säkerställa att de två knapparna i kontrollvyns underträd kan särskiljas med automatiserade testverktyg, tilldelar du SmallIncrement eller SmallDecrement AutomationId efter behov. För vissa implementeringar kan den associerade redigeringskontrollen vara en peer för Spinner-kontrollen.
Nödvändiga egenskaper för UI Automation
I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för rotationskontroller. Mer information om egenskaper för UI Automation finns i UI Automation Properties for Clients (Egenskaper för gränssnittsautomatisering för klienter).
| UI Automation-egenskap | Värde | Kommentar |
|---|---|---|
| AutomationIdProperty | Se anteckningar. | Värdet för den här egenskapen måste vara unikt för alla kontroller i ett program. |
| BoundingRectangleProperty | Se anteckningar. | Den yttersta rektangeln som innehåller hela kontrollen. |
| ClickablePointProperty | Se anteckningar. | Rotationskontrollens klickbara punkt ger fokus till redigeringsdelen av kontrollen. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Rotationskontrollen hämtar vanligtvis sitt namn från en statisk textetikett. |
| LabeledByProperty | Se anteckningar. | Spinner-kontroller har en statisk textetikett. |
| ControlTypeProperty | Rotationsknapp | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "spinner" | Lokaliserad sträng som motsvarar kontrolltypen Spinner. |
| IsContentElementProperty | Sant | Rotationskontrollen måste alltid vara innehåll. |
| IsControlElementProperty | Sant | Spinner-kontrollen måste alltid vara en kontroll. |
Obligatoriska UI Automation-kontrollmönster och egenskaper
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av rotationskontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster/mönsteregenskap | Support/värde | Kommentar |
|---|---|---|
| ISelectionProvider | Beror | Spinner-kontroller som har en lista över objekt som ska väljas måste ha stöd för det här mönstret. |
| CanSelectMultiple | Falsk | Spinner-kontroller är alltid enkla markeringscontainrar. |
| IRangeValueProvider | Beror | Spinner-kontroller som sträcker sig över ett numeriskt intervall kan stödja det här mönstret. |
| IValueProvider | Beror | Spinner-kontroller som sträcker sig över en diskret uppsättning alternativ eller siffror kan stödja det här mönstret. |
Nödvändiga UI Automation-händelser
I följande tabell visas de UI Automation-händelser som krävs för att stödjas av alla rotationskontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| InvalidatedEvent | Beror | Ingen |
| BoundingRectangleProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| ValueProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| ValueProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |