Dela via

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

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 gruppkontrolltypen. 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 UI Automation-kontrollmönster.

Gruppkontrollen representerar en nod i en hierarki. Gruppkontrolltypen skapar en separation i UI Automation-trädet så att objekt som grupperas tillsammans har en logisk division i UI Automation-trädet.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för gruppkontrolltypen. Kraven för användargränssnittsautomatisering gäller för alla gruppkontroller, 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 gruppkontroller 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
Grupp

– 0 eller många kontroller		 Grupp

– 0 eller många kontroller

Vanligtvis har gruppkontroller UI Automation-stöd för ListItem-kontrolltypen, UI Automation-stöd för TreeItem-kontrolltypen eller UI Automation-stöd för kontrolltyperna DataItem-kontrolltyp som finns under dem i underträdet. Eftersom "Grupp" är en generisk container är det möjligt att alla typer av kontroller finns under gruppkontrollen i trädet.

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 gruppkontroller. 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. Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och du utför specialiserad träfftestning, bör du åsidosätta och ange en klickbar punkt.
IsKeyboardFocusableProperty Se anteckningar. Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen.
NameProperty Se anteckningar. Gruppkontrollen hämtar vanligtvis sitt namn från texten som etiketterar kontrollen.
LabeledByProperty Se anteckningar. Gruppkontroller är vanligtvis självetiketter. I dessa fall returnerar du null här. Om det finns en statisk textetikett för gruppen måste den returneras som värdet för egenskapen LabeledBy.
ControlTypeProperty Grupp Det här värdet är detsamma för alla gränssnittsramverk.
LocalizedControlTypeProperty "grupp" Lokaliserad sträng som motsvarar kontrolltypen Grupp.
IsContentElementProperty Sann Gruppkontrollen ingår alltid i innehållsvyn i UI Automation-trädet.
IsControlElementProperty Sann Kalendergruppen ingår alltid i kontrollvyn för UI Automation-trädet.

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 för gruppkontrolltypen. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.

Kontrollmönster Stöd Noteringar
IExpandCollapseProvider Det beror på Gruppkontroller som kan användas för att visa eller dölja information måste stödja Expandera/Dölj-mö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 gruppkontroller. Mer information om händelser finns i UI Automation Events Overview.

UI Automation-händelse Stöd Noteringar
BoundingRectangleProperty egenskapsändringshändelse. Krävs Ingen
IsOffscreenProperty egenskapsändringshändelse. Krävs Ingen
IsEnabledProperty egenskapsändringshändelse. Krävs Ingen
ExpandCollapseStateProperty egenskapsändringshändelse. Det beror på Ingen
ToggleStateProperty egenskapsändringshändelse. Det beror på Ingen
AutomationFocusChangedEvent Krävs Ingen
StructureChangedEvent Krävs Ingen

Se även

  • Last updated on