Stöd för användargränssnittsautomatisering för kontrolltypen Fönster
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 kontrolltypen Fönster. 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 kontrollmönster.
Kontrolltypen Fönster används för att representera ett objekt i en ram eller ett dokumentfönster. Användare kan navigera mellan fönsterkontroller och i innehållet i det aktuella fönstret, men kan inte navigera mellan objekt i olika fönster. Därför representerar fönsterkontroller en grupperingsnivå som är lägre än fönster eller dokument, men ovanför enskilda kontroller. Användaren navigerar mellan fönster genom att trycka på TABB, F6 eller CTRL+TABB, beroende på kontexten. Ingen specifik tangentbordsnavigering krävs av kontrolltypen Fönster.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen Fönster. 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önsterkontroller 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 |
|---|---|
| Fönster | Fönster |
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 fönsterkontroller. 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. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Värdet för den här egenskapen måste alltid vara en tydlig, koncis och meningsfull rubrik. |
| ClickablePointProperty | Se anteckningar. | Den här egenskapen exponerar en klickbar punkt i fönsterkontrollen som gör att fönstret blir fokuserat när det klickas. |
| LabeledByProperty | Se anteckningar. | Fönsterkontroller har vanligtvis ingen statisk etikett. Om det finns en statisk textetikett bör den exponeras via den här egenskapen. |
| ControlTypeProperty | Fönster | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "fönster" | Lokaliserad sträng som motsvarar kontrolltypen Fönster. |
| IsContentElementProperty | Sant | Fönsterkontroller ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Fönsterkontroller ingår alltid i kontrollvyn för UI Automation-trädet. |
| HelpTextProperty | "" | Hjälptexten för fönsterkontroller bör förklara varför syftet med ramen och hur den relaterar till andra bildrutor. En beskrivning är nödvändig om syftet och relationen mellan bildrutorna inte framgår av värdet för NameProperty. " |
| AccessKeyProperty | Se anteckningar. | Om en specifik nyckelkombination fokuserar på fönstret bör den informationen exponeras via den här egenskapen. |
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 fönsterkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| ITransformProvider | Beror | Implementera det här kontrollmönstret om fönsterkontrollen kan flyttas, ändras eller roteras på skärmen. |
| IWindowProvider | Aldrig | Om du behöver implementera det här kontrollmönstret bör kontrollen baseras på Window kontrolltypen. |
| IDockProvider | Beror | Implementera det här kontrollmönstret om fönsterkontrollen kan dockas. |
| IScrollProvider | Beror | Implementera det här kontrollmönstret om fönsterkontrollen kan rullas. |
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önsterkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support/värde | Kommentar |
|---|---|---|
| WindowClosedEvent | Aldrig | Ingen |
| WindowOpenedEvent | Aldrig | Ingen |
| AsyncContentLoadedEvent | Obligatoriskt | 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 |
| HorizontallyScrollableProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| HorizontalScrollPercentProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| HorizontalViewSizeProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| VerticalScrollPercentProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| VerticallyScrollableProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| VerticalViewSizeProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| WindowVisualStateProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Ingen |
Exempel på kontrolltyp för fönster
Följande bild visar en kontroll som implementerar kontrolltypen Fönster.
| Träd för gränssnittsautomatisering – kontrollvy | Träd för gränssnittsautomatisering – innehållsvy |
|---|---|
|
-Fönstret - Träd (rullningsmönster) - TreeItem - ... Fönstret -Redigera - (Rullningsmönster) |