Stöd för användargränssnittsautomatisering för bildkontrolltypen
Kommentar
Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. 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 presentationsstiftelsen (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 Översikt över UI Automation Tree.
| 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 | Kommentar |
|---|---|---|
| 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 | Sant | 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 diagram. 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 Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IGridItemProvider | Beror | Bildkontrollen stöder rutnätsobjektmönstret om kontrollen finns i en rutnätscontainer. |
| ITableItemProvider | Beror | 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 Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| InvokedEvent | Aldrig | Ingen |
| ElementAddedToSelectionEvent | Aldrig | Ingen |
| ElementRemovedFromSelectionEvent | Aldrig | Ingen |
| ElementSelectedEvent | Aldrig | Ingen |
| BoundingRectangleProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| NameProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |