Kontrolltyp för spinnare
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen Spinner.
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 Spinner kontrolltyp. Kraven för UI Automation gäller för alla spinner-kontroller där UI-ramverket/plattformen integrerar UI Automation-stöd för kontrolltyper och kontrollmönster.
Det här avsnittet innehåller följande avsnitt.
- typisk trädstruktur
- relevanta egenskaper
- nödvändiga kontrollmönster
- nödvändiga händelser
- Relaterade ämnen
Typisk trädstruktur
I följande tabell visas en typisk kontroll- och innehållsvy över UI Automation-trädet som gäller för rotationskontroller när de stöder RangeValue- och Selection kontrollmönster och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i UI Automation Tree Overview.
RangeValue-kontrollmönster
| Kontrollvy | Innehållsvy |
|---|---|
|
|
Markeringskontrollmönster
| Kontrollvy | Innehållsvy |
|---|---|
|
|
För att säkerställa att de två knapparna i kontrollvyns underträd kan särskiljas med automatiserade testverktyg, tilldelar du värdet ScrollAmount_SmallIncrement eller ScrollAmount_SmallDecrement till egenskapen AutomationId efter behov. För vissa implementeringar kan den associerade redigeringskontrollen vara en peer för rotationskontrollen.
Relevanta egenskaper
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 Hämta egenskaper från UI Automation-element.
| UI Automation-egenskap | Värde | Anteckningar |
|---|---|---|
| UIA_AutomationIdPropertyId | Se anteckningar. | Värdet för den här egenskapen måste vara unikt bland alla peer-element i den råa vyn för UI Automation-trädet. |
| UIA_BoundingRectanglePropertyId | Se anteckningar. | Den yttersta rektangeln som innehåller hela kontrollen. |
| UIA_ClickablePointPropertyId | Se anteckningar. | Rotationskontrollens klickbara punkt ger fokus till redigeringsdelen av kontrollen. |
| UIA_ControlTypePropertyId | Spinner | Det här värdet är detsamma för alla ramverk. |
| UIA_IsContentElementPropertyId | SANN | Rotationskontrollen måste alltid vara innehåll. |
| UIA_IsControlElementPropertyId | SANN | Rotationskontrollen måste alltid vara en kontroll. |
| UIA_IsKeyboardFocusablePropertyId | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. En spinnarkontroll tar sällan fokus, men när den gör det bör fokus ligga kvar på själva spinnarkontrollen, inte på de underordnade knapparna. Användaren bör kunna utföra alla rullningsåtgärder med hjälp av tangenterna UPPÅTPIL och NEDÅTPIL. |
| UIA_LabeledByPropertyId | Se anteckningar. | Spinner-kontroller har en statisk textetikett. |
| UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar Spinner kontrolltyp. Standardvärdet är "spinner" för en-US eller engelska (USA). |
| UIA_NamePropertyId | Se anteckningar. | Rotationskontrollen hämtar vanligtvis sitt namn från en statisk textetikett. |
Nödvändiga kontrollmönster
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av alla spinner-kontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.
| Kontrollmönster/mönsteregenskap | Support/värde | Anteckningar |
|---|---|---|
| IRangeValueProvider | Beror | Spinner-kontroller som sträcker sig över ett numeriskt intervall kan stödja RangeValue- kontrollmönster. |
| ISelectionProvider | Beror | Spinner-kontroller som har en lista över objekt som ska väljas måste ha stöd för markering kontrollmönstret. |
| CanSelectMultiple | FALSK | Spinner-kontroller är alltid enkla markeringscontainrar. |
| IValueProvider | Beror | Spinner-kontroller som sträcker sig över en descrete-uppsättning alternativ eller tal kan stödja Value kontrollmönster. |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som spinner-kontroller krävs för att stödja. Mer information om händelser finns i UI Automation Events Overview.
| UI Automation-händelse | Anteckningar |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId händelse som ändrats av egenskapen. | |
| UIA_IsEnabledPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder egenskapen IsEnabled måste den stödja den här händelsen. |
| UIA_IsOffscreenPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder egenskapen IsOffscreen måste den ha stöd för den här händelsen. |
| UIA_RangeValueValuePropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder RangeValue- kontrollmönster måste den stödja den här händelsen. |
| UIA_Selection_InvalidatedEventId händelse som ändrats av egenskapen. | Om kontrollen stöder kontrollmönstret Selection måste den ha stöd för den här händelsen. |
| UIA_StructureChangedEventId | |
| UIA_ValueValuePropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder kontrollmönstret Value måste den ha stöd för den här händelsen. |
Relaterade ämnen
-
konceptuell
-
översikt över UI Automation-kontrolltyper
-
översikt över UI Automation