Dela via

Stöd för användargränssnittsautomatisering för verktygsfältets kontrolltyp

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 ToolBar. 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. Med kontroller i verktygsfältet kan slutanvändarna aktivera kommandon och verktyg som finns i ett program.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen ToolBar. Kraven för användargränssnittsautomatisering gäller för alla kontroller i verktygsfältet, 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 verktygslistkontroller 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
Verktygsfält

– Olika kontroller (0 eller fler)		 Verktygsfält

– Olika kontroller (0 eller fler)

En knapplistkontroll kan innehålla vilken typ av kontroll som helst i dess underträd. De innehåller oftast knappar, kombinationsrutor och delade knappar.

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 verktygslistkontroller. 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 Det beror på Kontrollen för verktygsfältet behöver inte ett namn om inte mer än ett används i ett program. Om det finns fler än ett måste var och en ha ett särskiljande namn (till exempel Formatering eller Disposition).
LabeledByProperty Null Verktygslistkontroller har aldrig någon etikett.
ControlTypeProperty Verktygsfält Det här värdet är detsamma för alla gränssnittsramverk.
LocalizedControlTypeProperty "verktygsfältet" Lokaliserad sträng som motsvarar kontrolltypen ToolBar.
IsContentElementProperty Sann Kontrollen för verktygsfältet är alltid innehåll.
IsControlElementProperty Sann Verktygslistkontrollen måste alltid vara en kontroll.

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

Kontrollmönster Stöd Noteringar
ExpandCollapsePattern Det beror på Om verktygsfältet kan expanderas och komprimeras för att visa fler objekt måste det ha stöd för det här mönstret.
DockPattern Det beror på Om verktygsfältet kan dockas till olika delar av skärmen måste det ha stöd för det här mönstret.
TransformPattern Det beror på Om verktygsfältet kan ändras, roteras eller flyttas måste det ha stöd för det här 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 kontroller i verktygsfältet. 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
AutomationFocusChangedEvent Krävs Ingen
StructureChangedEvent Krävs Ingen

Se även

  • Last updated on