Stöd för automatisering av användargränssnitt för kontrolltypen Panel

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 UI Automation-stöd för kontrolltypen Panel. 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 Panel används för att representera ett objekt i en ram eller 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 panelkontrolltypen.

I följande avsnitt definieras den erforderliga strukturen i UI Automation-trädet, egenskaperna, kontrollmönstren och händelserna för kontrolltypen Panel. 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
Ruta	Ruta

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.
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	Ruta	Det här värdet är detsamma för alla gränssnittsramverk.
LocalizedControlTypeProperty	"fönster"	Lokaliserad sträng som motsvarar kontrolltypen Panel.
IsContentElementProperty	Sann	Panelkontroller ingår alltid i innehållsvyn av UI Automation-trädet.
IsControlElementProperty	Sann	Panelkontroller ingår alltid i kontrollvisningen 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 UI Automation Control Patterns Overview.

Kontrollmönster	Stöd	Noteringar
ITransformProvider	Det beror på	Implementera det här kontrollmönstret om panelkontrollen kan flyttas, ändra storlek 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	Det beror på	Implementera det här kontrollmönstret om fönsterkontrollen kan förankras.
IScrollProvider	Det beror på	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 UI Automation Events Overview.

UI Automation-händelse	Support/värde	Noteringar
WindowClosedEvent	Aldrig	Ingen
WindowOpenedEvent	Aldrig	Ingen
AsyncContentLoadedEvent	Krävs	Ingen
BoundingRectangleProperty egenskapsändringshändelse.	Krävs	Ingen
IsOffscreenProperty egenskapsändringshändelse.	Krävs	Ingen
IsEnabledProperty egenskapsändringshändelse.	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
WindowVisualStateProperty egenskapsändringshändelse.	Aldrig	Ingen
AutomationFocusChangedEvent	Krävs	Ingen
StructureChangedEvent	Krävs	Ingen

Exempel på kontrolltyp för fönster

Följande bild visar en kontroll som implementerar kontrolltypen Panel.

Träd för gränssnittsautomatisering – kontrollvy	Träd för gränssnittsautomatisering – innehållsvy
Ruta Träd (rullningsmönster) TreeItem Ruta Redigera (rullmönster)	- Fönsterruta - Träd (scrollningsmönster) - TreeItem - … Panel -Redigera - (Rullningsmönster)

Se även

• Pane
• översikt över typer av UI Automation-kontroller
• översikt över UI Automation