Dela via

Stöd för UI Automation för TreeItem-kontrolltypen

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 TreeItem-kontrolltypen. 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.

TreeItem-kontrolltypen representerar en nod i en trädcontainer. Varje nod kan 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 TreeItem-kontrolltypen. UI Automation-kraven gäller för alla trädobjektskontroller, 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 trädobjektkontroller 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
TreeItem

– Kryssruta (0 eller 1)
- Bild (0 eller 1)
- Knapp (0 eller 1)
- TreeItem (0 eller mer)		 TreeItem

- TreeItem (0 eller mer)

Trädobjektkontroller kan ha noll eller fler underordnade trädobjekt i innehållsvyn för UI Automation-trädet. Om trädobjektkontrollen har funktioner utöver vad som visas i kontrollmönstren som anges nedan bör kontrollen baseras på kontrolltypen Dataobjekt.

Komprimerade trädobjekt visas inte i kontrollvyn eller innehållsvyn förrän de expanderas och visas (eller kan rullas in i vyn).

Kontrollvyn kan innehålla ytterligare information för en kontroll, inklusive en associerad bild eller en knapp. Ett objekt i en dispositionsvy kan till exempel innehålla en bild samt en knapp för att expandera eller dölja dispositionen. Dessa detaljobjekt visas inte i innehållsvyn eftersom informationen redan representeras av det överordnade trädobjektet. Trädobjekt som rullas bort från skärmen visas i både kontroll- och innehållsvyerna i UI Automation-trädet och bör ha IsOffscreenProperty inställt till true.

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. Den här egenskapen måste returnera objektets plats som gör att objektet ändrar markering eller blir fokuserat.
ControlTypeProperty TreeItem Det här värdet är detsamma för alla gränssnittsramverk.
IsContentElementProperty Sann Listkontrollen ingår alltid i innehållsvyn i UI Automation-trädet.
IsControlElementProperty Sann Listkontrollen ingår alltid i kontrollvyn för UI Automation-trädet.
IsOffscreenProperty Se anteckningar. Den här egenskapen är inställd på att ange när en trädobjektskontroll rullas bort från skärmen.
IsKeyboardFocusableProperty Se anteckningar. Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen.
ItemTypeProperty Se anteckningar. Om trädobjektkontrollen använder en visuell ikon för att indikera att det är en viss typ av objekt måste den här egenskapen stödjas och ange vad objektet är.
LabeledByProperty Null Trädobjektkontroller är självetiketter.
LocalizedControlTypeProperty trädelement Lokaliserad sträng som motsvarar kontrolltypen TreeItem.
NameProperty Se anteckningar. Den här egenskapen visar texten som visas för varje trädobjektkontroll.

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
IInvokeProvider Det beror på Implementera det här kontrollmönstret om trädobjektet har ett separat, åtgärdsbart kommando.
IExpandCollapseProvider Ja Alla trädobjekt kan expanderas eller komprimeras.
ExpandCollapseState Expanderad, komprimerad eller lövnod Trädobjekt blir lövnoder när de inte expanderas eller komprimeras.
IScrollItemProvider Det beror på Implementera det här kontrollmönstret om trädcontainern stöder rullningskontrollmönstret.
ISelectionItemProvider Det beror på Implementera det här kontrollmönstret om det är möjligt att ha ett aktivt val som behålls när användaren återvänder till trädcontainern.
SelectionContainer Ja Den här egenskapen exponerar samma container för alla objekt i containern.
IToggleProvider Det beror på Implementera det här kontrollmönstret om trädobjektet har en associerad kryssruta.

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ädobjektskontroller. Mer information om händelser finns i UI Automation Events Overview.

UI Automation-händelse Stöd Noteringar
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
ItemStatusProperty egenskapsändringshändelse. Det beror på Ingen
NameProperty egenskapsändringshändelse. Krävs Ingen
StructureChangedEvent Krävs Ingen
ExpandCollapseStateProperty egenskapsändringshändelse. Krävs Ingen
InvokedEvent Det beror på Ingen
CurrentViewProperty egenskapsändringshändelse. Det beror på Ingen
ElementAddedToSelectionEvent Det beror på Ingen
ElementRemovedFromSelectionEvent Det beror på Ingen
ElementSelectedEvent Det beror på Ingen
ToggleStateProperty egenskapsändringshändelse. Det beror på Ingen
ValueProperty egenskapsändringshändelse. Det beror på Ingen

Se även

  • Last updated on