Stöd för UI Automation för skjutreglagets kontrolltyp
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 skjutreglagets kontrolltyp. 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 kontrolltyper.
Skjutreglaget är en sammansatt kontroll med knappar som gör att en användare med en mus 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 skjutreglagets kontrolltyp. UI Automation-kraven gäller för alla skjutreglagekontroller, oavsett om Windows Presentation Foundation (WPF), Win32 eller Windows Forms.
Obligatorisk trädstruktur för användargränssnittsautomatisering
I följande tabell visas kontrollvyn och innehållsvyn för UI Automation-trädet som gäller skjutreglage och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i Översikt över UI Automation Tree.
| Kontrollvy | Innehållsvy |
|---|---|
| Skjutreglage - Knapp (2 eller 4) - Tumme (endast 1) - Listobjekt (0 eller mer) |
Skjutreglage - Listobjekt (0 eller mer) |
Nödvändiga egenskaper för UI Automation
I följande tabell visas de UI Automation-egenskaper vars värde eller definition är särskilt relevant för skjutreglagets kontrolltyp. 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 | De flesta skjutreglagekontroller måste höja NoClickablePointException eftersom hela avgränsningsrektangeln i skjutreglaget är upptagen av underordnade kontroller. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Namnet på redigeringskontrollen genereras vanligtvis från en statisk textetikett. Om det inte finns en statisk textetikett måste ett egenskapsvärde för Name tilldelas av programutvecklaren. Egenskapen Name får aldrig innehålla textinnehållet i redigeringskontrollen. |
| LabeledByProperty | 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 har LabeledBy den ingen egenskapsuppsättning. |
| ControlTypeProperty | Skjutreglage | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "skjutreglage" | Lokaliserad sträng som motsvarar redigeringskontrolltypen. |
| IsContentElementProperty | Sant | Redigeringskontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Redigeringskontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
Nödvändiga UI Automation-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 Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| ISelectionProvider | Beror | Ett skjutreglage bör ha stöd för markeringskontrollmö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. |
| IRangeValueProvider | Beror | Ett skjutreglage bör stödja RangeValue-kontrollmönstret om innehållet kan anges till ett värde inom ett numeriskt intervall. |
| IValueProvider | Beror | Ett skjutreglage bör ha stöd för värdekontrollmönstret om innehållet representerar ett värde bland en diskret uppsättning alternativ. |
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 skjutreglagekontroller.
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 |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |