Typ ovládacího prvku obrázek
Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní microsoftu pro typ ovládacího prvku Image.
Ovládací prvky obrázku používané jako ikony, informační grafika a grafy budou podporovat typ ovládacího prvku Obrázek. Ovládací prvky použité jako pozadí nebo obrázky vodoznaku nepodporují typ ovládacího prvku Obrázek.
Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Image. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky obrázků, ve kterých architektura uživatelského rozhraní nebo platforma integrují podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.
Toto téma obsahuje následující části.
- typické stromové struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- související témata
Typická stromová struktura
Následující tabulka znázorňuje typické zobrazení ovládacího prvku a obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků obrázků a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Obraz | Obrázek (Závisí na tom, zda obrázek obsahuje informace na základě hodnoty identifikátorů vlastností elementu Automation vlastnost) |
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky obrázku. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
| Vlastnost automatizace uživatelského rozhraní | Hodnota | Poznámky |
|---|---|---|
| UIA_AutomationIdPropertyId | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| UIA_ClickablePointPropertyId | Viz poznámky. | Kliknutelný bod ovládacího prvku obrázku musí být bod v ohraničující obdélník ovládacího prvku obrázku. |
| UIA_ControlTypePropertyId | obrázku | |
| UIA_HelpTextPropertyId | Viz poznámky. | Vlastnost HelpText zveřejňuje lokalizovaný řetězec, který popisuje skutečný vizuální vzhled ovládacího prvku nebo jiné informace popisky přidružené k obrázku. Tato vlastnost musí být podporována, pokud je potřeba dlouhý popis, aby bylo možné sdělit více informací o ovládacím prvku obrázku (například pokud je obrázek složitým grafem nebo diagramem). Tato vlastnost se mapuje na značku Html LongDesc a SvG (Scalable Vector Graphics) značky. Vývojáři pracující s ovládacími prvky obrázků musí podporovat vlastnost, která umožňuje nastavení vizuálního popisu na ovládacím prvku. Tato vlastnost musí být mapována na automatizaci uživatelského rozhraní VisualDescription vlastnost. |
| UIA_IsContentElementPropertyId | Viz poznámky. | Ovládací prvek obrázku musí být součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní, pokud obsahuje smysluplné informace, které ještě nejsou vystaveny koncovému uživateli. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Ovládací prvek obrázku je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| UIA_ItemStatusPropertyId | Viz poznámky. | Pokud ovládací prvek obrázku představuje informace o stavu konkrétní položky na obrazovce, ovládací prvek by měl být obsažen v položce. Pokud je obrázek obsažen v položce, musí položka podporovat vlastnost stavu a vyvolat příslušná oznámení při změně stavu. Pokud je obrázek samostatný ovládací prvek a vyjadřuje stav této vlastnosti, musí být podporována. |
| UIA_LabeledByPropertyId | Viz poznámky. | Pokud je popisek statického textu, musí tato vlastnost vystavit odkaz na tento ovládací prvek. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku Image. Výchozí hodnota je "image" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Vlastnost Název musí být zpřístupněna pro všechny ovládací prvky obrázku, které obsahují informace. Programový přístup k tomuto informacím vyžaduje, aby byl poskytnut textový ekvivalent obrázku. Pokud je ovládací prvek obrázku čistě dekorativní, musí se zobrazit pouze v zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní a nemusí mít název (viz Poznámky). Rozhraní uživatelského rozhraní musí podporovat alternativní textovou vlastnost u obrázků, které je možné nastavit v rámci jejich rozhraní. Tato vlastnost se pak namapuje na vlastnost Název automatizace uživatelského rozhraní. |
Požadované vzory ovládacích prvků
Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které je potřeba pro ovládací prvky obrázků podporovat. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vzor ovládacího prvku | Podpora | Poznámky |
|---|---|---|
| IGridItemProvider | Závisí | Ovládací prvek image podporuje GridItem vzor ovládacího prvku, pokud je ovládací prvek v kontejneru mřížky. |
| IInvokeProvider | Nikdy | Pokud je ovládací prvek obrázku kliknutelným objektem, měl by ovládací prvek podporovat typ ovládacího prvku, který podporuje typ ovládacího prvku Vyvolat, například typ ovládacího prvku Tlačítko. U objektu obrázku, který obsahuje více kliknutelných objektů, může prvek (typ ovládacího prvku Obrázek) hostovat podřízené odkazy (Hypertextový odkaz typ ovládacího prvku) ve stromu automatizace uživatelského rozhraní. |
| ISelectionItemProvider | Nikdy | Ovládací prvky obrázku by neměly podporovat vzor ovládacích prvků SelectionItem. Pokud jsou obrázky součástí kontejneru, který je možné vybrat, například tlačítko s ikonou obrázku jako obsah, podporuje tento kontejner vzor, nikoli obrázek uvnitř. |
| ITableItemProvider | Závisí | Ovládací prvek image podporuje TableItem vzor ovládacího prvku, pokud je ovládací prvek v kontejneru s ovládacími prvky záhlaví. |
Požadované události
Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky obrázků vyžadují pro podporu. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.
| Událost automatizace uživatelského rozhraní | Poznámky |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId událost změněnou vlastností. | |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_ItemStatusPropertyId událost změny vlastnosti. | Pokud ovládací prvek podporuje vlastnost ItemStatus, musí tuto událost podporovat. |
| UIA_NamePropertyId událost změněnou vlastností. | |
| UIA_StructureChangedEventId |
Poznámky
Konsorcium W3C (World Wide Web Consortium) definuje dekorativní obrázek, který nepřidá informace do obsahu stránky. Další podrobnosti najdete v tématu W3C o dekorativní obrázky.
S ohledem na automatizaci uživatelského rozhraní:
- Pokud je obrázek čistě dekorativní, není interaktivní a neobsahuje žádné informace, obrázek:
- Může nebo nemusí být ve stromu UIA.
- Může nebo nemusí být v nezpracovaném zobrazení UIA.
- Nesmí být v zobrazení ovládacího prvku UIA.
- Nesmí být v zobrazení obsahu.
- Může nebo nemusí mít název
- Pokud obrázek sděluje informace, ale je jasně přidružený text, který poskytuje stejné informace (například tlačítko přehrávání, které obsahuje obrázek trojúhelníku směřujícího vlevo spolu s textem "přehrát"), obrázek se považuje za dekorativní a obrázek:
- Musí být v nezpracovaném zobrazení.
- Musí být v ovládacím zobrazení.
- Nesmí být v zobrazení obsahu.
- Může nebo nemusí mít hodnotu ve vlastnosti Name
- Text, který také vyjadřuje význam obrázku, musí být v zobrazení obsahu.
- Pokud je obrázek informativní a vyjadřuje podrobnosti, které nejsou k dispozici žádným přidruženým textem, obrázek:
- Musí být v nezpracovaném zobrazení.
- Musí být v ovládacím zobrazení.
- Musí být v zobrazení obsahu.
- Musí mít hodnotu názvu, která popisuje obrázek a jeho význam.