Stöd för användargränssnittsautomatisering för kontrolltypen ProgressBar
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 ProgressBar. 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, kontrollmönster och UI Automation-händelser.
Förloppsindikatorkontroller är ett exempel på kontroller som implementerar kontrolltypen ProgressBar. Förloppsindikatorkontroller används för att ange förloppet för en lång åtgärd. Kontrollen består av en rektangel som gradvis fylls med systemets markeringsfärg när en åtgärd fortskrider.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen ProgressBar. Kraven för användargränssnittsautomatisering gäller för alla listkontroller, oavsett om det gäller 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 för förloppsindikatorkontroller 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 |
|---|---|
| Progressbar | Progressbar |
Förloppsindikatorkontrollerna har inga underordnade objekt i kontroll- eller innehållsvyn för UI Automation-trädet.
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 förloppsindikatorkontroller. 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. | Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och du utför specialiserad träfftestning åsidosätter du och anger en klickbar punkt. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Kontrollen för förloppsindikatorn hämtar vanligtvis sitt namn från en statisk textetikett. Om det inte finns en statisk textetikett måste programutvecklaren exponera ett värde för Name egenskapen. |
| LabeledByProperty | Se anteckningar. | Om det finns en statisk textetikett måste den här egenskapen exponera en referens till den kontrollen. |
| ControlTypeProperty | Progressbar | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "förloppsindikator" | Lokaliserad sträng som motsvarar kontrolltypen ProgressBar. |
| IsContentElementProperty | Sant | Förloppsindikatorkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Kontrollen för förloppsindikatorn ingår alltid i kontrollvyn för UI Automation-trädet. |
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 förloppsindikatorkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster/mönsteregenskap | Support/värde | Kommentar |
|---|---|---|
| IValueProvider | Beror | Förloppsindikatorkontroller som ger en textinformation om förloppet måste implementera IValueProvider. |
| IsReadOnly | Sant | Värdet för den här egenskapen är alltid Sant. |
| Value | Se anteckningar. | Den här egenskapen visar text förlopp för en förloppsindikatorkontroll. |
| IRangeValueProvider | Beror | Förloppsindikatorkontroller som tar ett numeriskt intervall måste implementeras IRangeValueProvider |
| Minimum | 0,0 | Värdet för den här egenskapen är det minsta värde som kontrollen kan anges till. |
| Maximum | 100,0 | Värdet för den här egenskapen är det största värdet som kontrollen kan anges till. |
| SmallChange | NaN | Den här egenskapen krävs inte eftersom förloppsindikatorkontroller är skrivskyddade. |
| LargeChange | NaN | Den här egenskapen krävs inte eftersom förloppsindikatorkontroller är skrivskyddade. |
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 förloppsindikatorkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| 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 |
| NameProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| ValueProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |