Stöd för användargränssnittsautomatisering för fönsterkontrolltypen

Anmärkning

Den här dokumentationen är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i System.Windows.Automation namnrymd. 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 Noteringar
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 Sann Fönsterkontrollen måste alltid vara nöjd.
IsControlElementProperty Sann Fönsterkontrollen måste alltid fungera som 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 UI Automation Control Patterns Overview.

Kontrollmönster Stöd Noteringar
IDockProvider Villkorlig Måste stödjas om fönstret har möjligheten att dockas.
ITransformProvider Krävs Gör att fönstret kan flyttas, ändra storlek eller roteras på skärmen.
IWindowProvider Krävs 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 UI Automation Events Overview.

UI Automation-händelse Stöd Noteringar
AsyncContentLoadedEvent Krävs Ingen
AutomationFocusChangedEvent Krävs Ingen
BoundingRectangleProperty egenskapsändringshändelse. Krävs Ingen
IsEnabledProperty egenskapsändringshändelse. Krävs Ingen
IsOffscreenProperty egenskapsändringshändelse. Krävs Ingen
LayoutInvalidatedEvent Krävs Ingen
NameProperty egenskapsändringshändelse. Krävs Ingen
StructureChangedEvent Krävs Ingen
HorizontallyScrollableProperty egenskapsändringshändelse. Det beror på Ingen
HorizontalScrollPercentProperty egenskapsändringshändelse. Det beror på Ingen
HorizontalViewSizeProperty egenskapsändringshändelse. Det beror på Ingen
VerticalScrollPercentProperty egenskapsändringshändelse. Det beror på Ingen
VerticallyScrollableProperty egenskapsändringshändelse. Det beror på Ingen
VerticalViewSizeProperty egenskapsändringshändelse. Det beror på Ingen
WindowClosedEvent Krävs Ingen
WindowOpenedEvent Krävs Ingen
WindowVisualStateProperty egenskapsändringshändelse. Det beror på Ingen

Se även