Dela via

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

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 bildkontrolltypen. 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.

Bildkontroller som används som ikoner, informationsgrafik och diagram stöder bildkontrolltypen. Kontroller som används som bakgrunds- eller vattenstämpelbilder stöder inte bildkontrolltypen.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för bildkontrolltypen. UI Automation-kraven gäller för alla bildkontroller, 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 bildkontroller och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i UI Automation Tree Overview.

Kontrollvy Innehållsvy
Bild Bild (Beror på om bilden innehåller information (baserat på värdet för IsContentElement egenskapen))

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 bildkontrolltypen. 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. Bildkontrollens klickbara punkt måste vara en punkt inom avgränsningsrektangeln i bildkontrollen.
IsKeyboardFocusableProperty Se anteckningar. Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen.
NameProperty Se anteckningar. Egenskapen Namn måste vara tillgänglig för alla bildkontroller som innehåller information. Programmässig åtkomst till den här informationen kräver att en text som motsvarar grafiken tillhandahålls. Om bildkontrollen är helt dekorativ får den bara visas i kontrollvyn för UI Automation-trädet och behöver inte ha ett namn. Gränssnittsramverk måste ha stöd för en ALT- eller alternativ textegenskap för bilder som kan anges inifrån ramverket. Den här egenskapen mappas sedan till egenskapen UI Automation Name.
LabeledByProperty Se anteckningar. Om det finns en statisk textetikett måste den här egenskapen exponera en referens till den kontrollen.
ControlTypeProperty Bild Det här värdet är detsamma för alla gränssnittsramverk.
LocalizedControlTypeProperty "bild" Lokaliserad sträng som motsvarar kontrolltypen Bild.
IsContentElementProperty Se anteckningar. Bildkontrollen måste ingå i innehållsvyn i UI Automation-trädet när den innehåller meningsfull information som inte redan exponeras för slutanvändaren.
IsControlElementProperty Sann Bildkontrollen ingår alltid i kontrollvyn för UI Automation-trädet.
HelpTextProperty Se anteckningar. Egenskapen HelpText exponerar en lokaliserad sträng som beskriver kontrollens faktiska visuella utseende (till exempel en röd fyrkant med ett vitt X) eller annan knappbeskrivningsinformation som är associerad med bilden.

Den här egenskapen måste stödjas när en lång beskrivning behövs för att förmedla mer information om bildkontrollen. Till exempel ett komplicerat diagram eller tabell. Den här egenskapen mappar till HTML LongDesc-taggen och taggen Scalable Vector Graphics (SVG) Desc. Utvecklare som arbetar med bildkontroller måste ha stöd för en egenskap så att den visuella beskrivningen kan anges på kontrollen. Den här egenskapen måste mappas till egenskapen UI Automation VisualDescription.
ItemStatusProperty Se anteckningar. Om bildkontrollen representerar tillståndsinformation om ett visst objekt på skärmen ska kontrollen finnas i objektet. När bilden finns i ett objekt måste objektet ha stöd för statusegenskapen och generera lämpliga meddelanden när statusen ändras.

Om en bild är en fristående kontroll och förmedlar status måste den här egenskapen stödjas.

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

Kontrollmönster Stöd Noteringar
IGridItemProvider Det beror på Bildkontrollen stöder rutnätsobjektmönstret om kontrollen finns i en rutnätscontainer.
ITableItemProvider Det beror på Bildkontrollen stöder mönstret Tabellobjekt om kontrollen finns i en container som har rubrikkontroller.
IInvokeProvider Aldrig Om bildkontrollen innehåller en klickbar bild bör kontrollen ha stöd för en kontrolltyp som stöder mönstret Anropa, till exempel knappkontrolltypen.
ISelectionItemProvider Aldrig Bildkontroller bör inte ha stöd för markeringsobjektmö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 bildkontroller. Mer information om händelser finns i UI Automation Events Overview.

UI Automation-händelse Stöd Noteringar
InvokedEvent Aldrig Ingen
ElementAddedToSelectionEvent Aldrig Ingen
ElementRemovedFromSelectionEvent Aldrig Ingen
ElementSelectedEvent Aldrig Ingen
BoundingRectangleProperty egenskap-ändrad händelse. Krävs Ingen
IsOffscreenProperty egenskap-ändrad händelse. Krävs Ingen
IsEnabledProperty egenskap-ändrad händelse. Krävs Ingen
NameProperty egenskap-ändrad händelse. Krävs Ingen
AutomationFocusChangedEvent Krävs Ingen
StructureChangedEvent Krävs Ingen

Se även

  • Last updated on