Stöd för UI Automation för trädkontrolltypen

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 trädkontrolltypen. 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.

Kontrolltypen Träd används för containrar vars innehåll har relevans som en hierarki med noder, som med hur filer och mappar visas i den vänstra rutan i Microsoft Windows Explorer. Varje nod har potential att innehålla andra noder, så kallade underordnade noder. Överordnade noder, eller noder som innehåller underordnade noder, kan visas som expanderade eller komprimerade.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för trädkontrolltypen. UI Automation-kraven gäller för alla trädstrukturer, 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 trädkontroller 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
Träd DataItem (0 eller mer) TreeItem (0 eller mer) TreeItem (0 eller mer)• ... Rullningslist (0, 1, 2)	Träd DataItem (0 eller mer) TreeItem (0 eller mer) TreeItem (0 eller mer)• ...

Kontrollvyn för UI Automation-trädet består av:

• Noll till många objekt i containern (objekt kan baseras på trädobjekt, dataobjekt eller annan kontrolltyp).

• Noll, en eller två rullningslister.

Innehållsvyn i UI Automation-trädet består av noll eller många objekt i containern (objekt kan baseras på trädobjekt, dataobjekt eller annan kontrolltyp).

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 listkontroller. 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.	Trädkontroller har en klickbar punkt som gör att trädet eller ett objekt i trädcontainern har fokus inställt på dem. Du får bara en klickbar punkt för ett träd om du kan klicka någonstans som inte gör att något av objekten väljs/får fokus.
ControlTypeProperty	Träd	Det här värdet är detsamma för alla gränssnittsramverk.
IsContentElementProperty	Sann	Trädkontrollen ingår alltid i innehållsvyn i UI Automation-trädet.
IsControlElementProperty	Sann	Trädkontrollen ingår alltid i kontrollvyn för UI Automation-trädet.
IsKeyboardFocusableProperty	Se anteckningar.	Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen.
LabeledByProperty	Se anteckningar.	Om trädkontrollen har en etikett associerad med den returnerar den här egenskapen en AutomationElement för den etiketten. Annars returnerar egenskapen en null-referens (Nothing i Microsoft Visual Basic .NET).
LocalizedControlTypeProperty	"träd"	Lokaliserad sträng som motsvarar kontrolltypen Lista.
NameProperty	Se anteckningar.	Värdet för en trädkontrolls namnegenskap kommer vanligtvis från text som etiketterar kontrollen. Om det inte finns någon textetikett måste programutvecklaren ange ett värde för 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 listkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.

Kontrollmönster/mönsteregenskap	Support/värde	Noteringar
ISelectionProvider	Det beror på	Trädkontroller som innehåller en uppsättning valbara objekt måste implementera det här kontrollmönstret. Det här kontrollmönstret behöver inte implementeras om valet av ett objekt inte förmedlar meningsfull information till användaren.
CanSelectMultiple	Se anteckningar.	Implementera den här egenskapen om trädkontrollen stöder flera val (de flesta trädkontroller stöder inte flera val).
IsSelectionRequired	Se anteckningar.	Värdet för den här egenskapen visas om kontrollen kräver att ett objekt väljs.
IScrollProvider	Det beror på	Implementera det här kontrollmönstret om innehållet i trädcontainern 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 trädkontroller. Mer information om händelser finns i UI Automation Events Overview.

UI Automation-händelse	Stöd	Noteringar
InvalidatedEvent	Det beror på	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
AutomationFocusChangedEvent	Krävs	Ingen
StructureChangedEvent	Krävs	Ingen

Se även

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