Stöd för användargränssnittsautomatisering för fönsterkontrolltypen
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 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 omfattar specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och kontrollmönster.
Fönsterkontrollen består av fönsterramen, som innehåller underordnade objekt som namnlist, klient och andra objekt.
Kraven för UI Automation i följande avsnitt gäller för alla kontroller som implementerar kontrolltypen Fönster, 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 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. |
| ClickablePointProperty | Se anteckningar. | Fönsterkontrollen måste ha en klickbar punkt som gör att fönstret blir markerat eller avmarkerat. |
| ControlTypeProperty | Fönster | Det här värdet är detsamma för alla gränssnittsramverk. |
| IsContentElementProperty | Sant | Fönsterkontrollen måste alltid vara innehåll. |
| IsControlElementProperty | Sant | Fönsterkontrollen måste alltid vara en kontroll. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| LabeledByProperty | null |
Fönsterkontroller har ingen statisk fönsteretikett. |
| LocalizedControlTypeProperty | "fönster" | Lokaliserad sträng som motsvarar kontrolltypen Fönster. |
| NameProperty | Se anteckningar. | Fönsterkontrollen innehåller alltid ett primärt Window-element som relaterar till vad användaren skulle associera som den mest semantiska identifieraren för objektet. |
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 fönsterkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IDockProvider | Villkorsstyrd | Måste stödjas om fönstret har möjlighet att dockas. |
| ITransformProvider | Obligatoriskt | Gör att fönstret kan flyttas, ändras eller roteras på skärmen. |
| IWindowProvider | Obligatoriskt | Aktiverar specifika åtgärder för fönstret. |
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 | Kommentar |
|---|---|---|
| AsyncContentLoadedEvent | Obligatoriskt | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| BoundingRectangleProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| LayoutInvalidatedEvent | Obligatoriskt | Ingen |
| NameProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| StructureChangedEvent | 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 |
| WindowClosedEvent | Obligatoriskt | Ingen |
| WindowOpenedEvent | Obligatoriskt | Ingen |
| WindowVisualStateProperty händelse som ändrats av egenskapen. | Beror | Inga |