Kontrolltyp för skjutreglage
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen Slider.
En skjutreglagekontroll är en sammansatt kontroll med knappar som gör att en användare kan ange ett numeriskt intervall eller välja bland en uppsättning objekt.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för Skjutreglaget kontrolltyp. Kraven för användargränssnittsautomatisering gäller för alla skjutreglage 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 avser skjutreglagekontroller och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i UI Automation Tree Overview.
| Kontrollvy | Innehållsvy |
|---|---|
|
|
Relevanta egenskaper
I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för skjutreglagekontroller. 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. | De flesta skjutreglagekontroller måste returnera UIA_E_NOCLICKABLEPOINT fel eftersom hela avgränsningsrektangeln i skjutreglaget används av underordnade kontroller. |
| UIA_ControlTypePropertyId | Skjutreglage | Det här värdet är detsamma för alla ramverk. |
| UIA_IsContentElementPropertyId | SANN | Skjutreglagekontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| UIA_IsControlElementPropertyId | SANN | Skjutreglagekontrollen ingår alltid i kontrollvyn i UI Automation-trädet. |
| UIA_IsKeyboardFocusablePropertyId | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. Barn (knappar och tumme) i en skjutreglagekontroll bör aldrig fokusera. Fokus bör alltid ligga kvar på själva skjutreglaget. |
| UIA_LabeledByPropertyId | Se anteckningar. | Om det finns en statisk textetikett som är associerad med kontrollen måste den här egenskapen exponera en referens till den kontrollen. Om textkontrollen är en underkomponent för en annan kontroll kommer den inte att ha en LabeledBy egenskapsuppsättning. |
| UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar skjutreglaget kontrolltyp. Standardvärdet är "skjutreglage" för en-US eller engelska (USA). |
| UIA_NamePropertyId | Se anteckningar. | Namnet på skjutreglaget genereras vanligtvis från en statisk textetikett. Om det inte finns en statisk textetikett måste ett egenskapsvärde för Namn tilldelas av programutvecklaren. |
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 skjutreglagekontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.
| Kontrollmönster/mönsteregenskap | Support/värde | Anteckningar |
|---|---|---|
| IRangeValueProvider | Beror | Ett skjutreglage bör ha stöd för RangeValue- kontrollmönster om innehållet kan anges till ett värde inom ett numeriskt intervall. |
| ISelectionProvider | Beror | Ett skjutreglage bör ha stöd för markering kontrollmönstret om innehållet representerar ett värde bland en diskret uppsättning alternativ. När mönstret Markeringskontroll stöds måste motsvarande markering exponeras som ett eller flera underordnade listobjekt i skjutreglaget. |
| IValueProvider | Beror | Ett skjutreglage bör ha stöd för värde kontrollmönster om innehållet representerar ett värde bland en diskret uppsättning alternativ. |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som skjutreglagekontroller 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 | 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