Dela via

Automatiseringsstöd för användargränssnittet för verktygstipskontrolltypen

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

Verktygstips är popup-fönster som innehåller text.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen ToolTip. Kraven för automatisering av användargränssnittet gäller för alla knappbeskrivningskontroller, 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 verktygstipskontroller 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
Verktygstips

- Text (0 eller mer)
- Bild (0 eller mer)		 Verktygstips

Verktygstipskontroller visas bara i innehållsvyn i UI Automation-trädet om de kan få tangentbordsfokus. Annars är all information om verktygstipset tillgänglig från HelpTextProperty UI Automation-elementet som verktygstipset refererar till.

Verktygstips bör visas under kontrollen som deras information refererar till. Klienter måste lyssna efter ToolTipOpenedEvent för att säkerställa att de alltid får information som finns i verktygstips.

Nödvändiga egenskaper för UI Automation

I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för verktygstipskontroller. 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 klickbara punkten ska vara den del av verktygsspetsen som stänger kontrollen. Vissa verktygstips har inte den här möjligheten och kommer inte att ha 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. Namnet på verktygsfältskontrollen är den text som visas i verktygstipset.
LabeledByProperty Null Verktygstipskontroller är alltid märkta av sitt innehåll.
ControlTypeProperty Verktygstips Det här värdet är detsamma för alla gränssnittsramverk.
LocalizedControlTypeProperty "verktygsspets" Lokaliserad sträng som motsvarar kontrolltypen Knappbeskrivning.
IsContentElementProperty Det beror på Om verktygstipskontrollen kan få tangentbordsfokus måste den finnas i innehållsvy av trädet. Om det bara är text är det tillgängligt som HelpTextProperty från kontrollen som aktiverade den.
IsControlElementProperty Sann Verktygsspetskontrollen måste alltid vara en kontroll.

Nödvändiga UI Automation-kontrollmönster

I följande tabell visas de UI Automation-kontrollmönster som verktygstipskontroller måste stödja. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.

Kontrollmönster Stöd Noteringar
IWindowProvider Det beror på Verktygstips som kan stängas genom att klicka på ett användargränssnittsobjekt måste ha stöd för WindowPattern så att de kan stängas automatiskt.
ITextProvider Det beror på För bättre tillgänglighet kan en verktygslistkontroll stödja textkontrollmönstret, även om det inte är nödvändigt. Textkontrollmönstret är användbart när texten har rtF-format och attribut (till exempel färg, fetstil och kursiv stil).

Nödvändiga UI Automation-händelser

Verktygstipskontroller måste utlösa ToolTipOpenedEvent när de visas på skärmen. Händelsen kommer att inkludera en referens till UI Automation-elementet i verktygstipset självt.

I följande tabell visas de UI Automation-händelser som krävs för att stödjas av alla tipsrutekontroller. Mer information om händelser finns i UI Automation Events Overview.

UI Automation-händelse Stöd Noteringar
TextSelectionChangedEvent Det beror på Ingen
TextChangedEvent Det beror på Ingen
WindowClosedEvent Det beror på Ingen
WindowOpenedEvent Det beror på Ingen
ToolTipOpenedEvent Krävs Ingen
ToolTipClosedEvent Krävs Ingen
BoundingRectangleProperty egenskapsändringshändelse. Krävs Ingen
IsOffscreenProperty egenskapsändringshändelse. Krävs Ingen
IsEnabledProperty egenskapsändringshändelse. Krävs Ingen
NameProperty egenskapsändringshändelse. Krävs Ingen
WindowVisualStateProperty egenskapsändringshändelse. Det beror på Ingen
AutomationFocusChangedEvent Krävs Ingen
StructureChangedEvent Krävs Ingen

Se även

  • Last updated on