Stöd för användargränssnittsautomatisering för tumkontrolltypen
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 UI Automation-stöd för tumkontrolltypen. 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 omfattar specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och kontrollmönster.
Tumkontroller ger funktioner som gör att en kontroll kan flyttas (eller dras), till exempel en rullningslistknapp eller ändra storlek, till exempel en fönsterändringswidget. Tumkontroller kan också implementeras som flyttbara kantlinjer för fönsterrutor. Observera att den inte tillhandahåller dra och släpp-funktioner. Tumkontroller kan få musfokus men vanligtvis inte tangentbordsfokus. Kontrollutvecklaren måste implementera kontrollen så att den fungerar korrekt (kan dras eller ändras).
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för tumkontrolltypen. Kraven för användargränssnittsautomatisering gäller för alla tumkontroller, 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 avser tumkontroller 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 |
|---|---|
| Tummen | – Ej tillämpligt |
Tumkontroller visas aldrig i innehållsvyn eftersom de bara finns för att manipuleras med en mus. Deras funktioner exponeras genom ett annat kontrollmönster, till exempel rullningsmönster, transformeringsmönster eller RangeValue-mönster, som stöds i Thumb-containern.
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 tumkontroller. 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. | Alla punkter i det synliga klientområdet för tumkontrollen. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Null |
Tumkontrollen är inte tillgänglig i innehållsvyn i UI Automation-trädet, så det kräver inget namn. |
| LabeledByProperty | Null |
Tumkontroller har aldrig en etikett. |
| ControlTypeProperty | Tummen | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "tumme" | Lokaliserad sträng som motsvarar tumkontrolltypen. |
| IsContentElementProperty | Falsk | Tumkontrollen är aldrig nöjd. |
| IsControlElementProperty | Sant | Tumkontrollen måste alltid vara en kontroll. |
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 tumkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster/mönsteregenskap | Support/värde | Kommentar |
|---|---|---|
| ITransformProvider | Obligatoriskt | Gör att tumkontrollen kan flyttas på skärmen. |
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 tumkontroller. 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 |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |