Dela via

Bildkontrolltyp

  • Artikel

Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen Image.

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

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaper, kontrollmönster och händelser för Bild kontrolltyp. Kraven för UI Automation gäller för alla avbildningskontroller där UI-ramverket/plattformen integrerar UI Automation-stöd för kontrolltyper och kontrollmönster.

Det här avsnittet innehåller följande avsnitt.

Typisk trädstruktur

I följande tabell visas en typisk kontroll- och innehållsvy över UI Automation-trädet som gäller 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 Egenskapsidentifierare för Automation-element egenskap)

Relevanta egenskaper

I följande tabell visas de UI Automation-egenskaper vars värde eller definition är särskilt relevant för bildkontrollerna. Mer information om egenskaper för UI Automation finns i Hämta egenskaper från UI Automation-element.

UI Automation-egenskap Värde Anteckningar
UIA_AutomationIdPropertyId Se anteckningar. Värdet för den här egenskapen måste vara unikt bland alla peer-element i den råa vyn för UI Automation-trädet.
UIA_BoundingRectanglePropertyId Se anteckningar. Den yttersta rektangeln som innehåller hela kontrollen.
UIA_ClickablePointPropertyId Se anteckningar. Bildkontrollens klickbara punkt måste vara en punkt inom avgränsningsrektangeln i bildkontrollen.
UIA_ControlTypePropertyId Bild
UIA_HelpTextPropertyId Se anteckningar. Egenskapen HelpText exponerar en lokaliserad sträng som beskriver kontrollens faktiska visuella utseende 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 om bilden är ett komplicerat diagram eller diagram). Den här egenskapen mappar till taggen HTML LongDesc 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.
UIA_IsContentElementPropertyId 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.
UIA_IsControlElementPropertyId SANN Bildkontrollen ingår alltid i kontrollvyn för UI Automation-trädet.
UIA_IsKeyboardFocusablePropertyId Se anteckningar. Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen.
UIA_ItemStatusPropertyId 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.
UIA_LabeledByPropertyId Se anteckningar. Om det finns en statisk textetikett måste den här egenskapen exponera en referens till den kontrollen.
UIA_LocalizedControlTypePropertyId Se anteckningar. Lokaliserad sträng som motsvarar kontrolltypen Image. Standardvärdet är "image" för en-US eller engelska (USA).
UIA_NamePropertyId Se anteckningar. Egenskapen Name måste exponeras 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 i UI Automation-trädet och behöver inte ha ett namn (se Anmärkningar). 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.

Nödvändiga kontrollmönster

I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas för bildkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.

Kontrollmönster Stöd Anteckningar
IGridItemProvider Beror Bildkontrollen stöder GridItem kontrollmönstret om kontrollen finns i en rutnätscontainer.
IInvokeProvider Aldrig Om bildkontrollen är ett klickbart objekt bör kontrollen ha stöd för en kontrolltyp som stöder kontrollmönstret Invoke, till exempel Button kontrolltyp. För ett bildobjekt som innehåller flera klickbara objekt kan elementet (bildkontrolltyp) vara värd för underordnade länkar (hyperlänk kontrolltyp) i UI Automation-trädet.
ISelectionItemProvider Aldrig Bildkontroller bör inte ha stöd för SelectionItem kontrollmönster. Om avbildningar är en del av en container som kan väljas, till exempel en knapp som har en bildikon som innehåll, stöder containern mönstret, inte avbildningen i.
ITableItemProvider Beror Bildkontrollen stöder TableItem- kontrollmönster om kontrollen finns i en container som har rubrikkontroller.

Nödvändiga händelser

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

UI Automation-händelse Anteckningar
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId händelse som ändrats av egenskapen.
UIA_IsEnabledPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen IsEnabled måste den stödja den här händelsen.
UIA_IsOffscreenPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen IsOffscreen måste den ha stöd för den här händelsen.
UIA_ItemStatusPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen ItemStatus måste den stödja den här händelsen.
UIA_NamePropertyId händelse som ändrats av egenskapen.
UIA_StructureChangedEventId

Anmärkningar

World Wide Web Consortium (W3C) definierar en dekorativ bild som en bild som inte lägger till information i innehållet på en sida. Mer information finns i W3C-avsnittet om dekorativa bilder.

När det gäller UI Automation:

  • Om en bild är helt dekorativ, inte är interaktiv och inte förmedlar någon information, bilden:
    • Kanske eller kanske inte finns i UIA-trädet
    • Kanske eller kanske inte finns i UIA-råvyn
    • Får inte finnas i UIA-kontrollvyn
    • Får inte finnas i innehållsvyn
    • Kanske eller kanske inte har ett namn
  • Om en bild förmedlar information, men det finns tydligt associerad text som ger samma information (till exempel en uppspelningsknapp som innehåller en vänsterriktad triangelgrafik tillsammans med texten "play"), anses bilden vara dekorativ och bilden:
    • Måste finnas i raw-vyn
    • Måste finnas i kontrollvyn
    • Får inte finnas i innehållsvyn
    • Kanske eller kanske inte har ett värde i egenskapen Namn
    • Texten som också förmedlar bildens innebörd måste finnas i innehållsvyn
  • Om en bild är informativ och förmedlar information som inte tillhandahålls av någon associerad text, bilden:
    • Måste finnas i raw-vyn
    • Måste finnas i kontrollvyn
    • Måste finnas i innehållsvyn
    • Måste ha ett namnvärde som beskriver bilden och dess innebörd

Begreppsmässig