Podpora automatizace uživatelského rozhraní pro typ obrazového ovládacího prvku

Poznámka:

Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy automatizace uživatelského rozhraní definované v oboru názvů System.Windows.Automation. Nejnovější informace o automatizaci uživatelského rozhraní najdete v tématu rozhraní API služby Windows Automation: Automatizace uživatelského rozhraní.

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní pro typ ovládacího prvku Image. V automatizaci uživatelského rozhraní je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splnit, aby bylo možné vlastnost použít ControlTypeProperty . Podmínky zahrnují specifické pokyny pro strukturu stromu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní a vzory ovládacích prvků.

Ovládací prvky obrázku používané jako ikony, informační grafika a grafy podporují 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ů, ať už windows Presentation Foundation (WPF), Win32 nebo Windows Forms.

Požadovaná struktura stromu automatizace uživatelského rozhraní

Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení 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
Obrázek	Obrázek (Závisí na tom, jestli obrázek obsahuje informace (na základě hodnoty IsContentElement vlastnosti))

Požadované vlastnosti automatizace uživatelského rozhraní

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro typ ovládacího prvku Obrázek. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Vlastnosti automatizace uživatelského rozhraní pro klienty.

Vlastnost automatizace uživatelského rozhraní	Hodnota	Poznámky
AutomationIdProperty	Viz poznámky.	Hodnota této vlastnosti musí být jedinečná pro všechny ovládací prvky v aplikaci.
BoundingRectangleProperty	Viz poznámky.	Vnější obdélník, který obsahuje celý ovládací prvek.
ClickablePointProperty	Viz poznámky.	Kliknutelný bod ovládacího prvku obrázku musí být bodem v rámci ohraničujícího obdélníku ovládacího prvku obrázku.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
NameProperty	Viz poznámky.	Vlastnost Name musí být vystavena 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. 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í.
LabeledByProperty	Viz poznámky.	Pokud je popisek statického textu, musí tato vlastnost vystavit odkaz na tento ovládací prvek.
ControlTypeProperty	Obrázek	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
LocalizedControlTypeProperty	obraz	Lokalizovaný řetězec odpovídající typu ovládacího prvku Image.
IsContentElementProperty	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.
IsControlElementProperty	Pravdivé	Ovládací prvek obrázku je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní.
HelpTextProperty	Viz poznámky.	Vlastnost HelpText zveřejňuje lokalizovaný řetězec, který popisuje skutečný vizuální vzhled ovládacího prvku (například červený čtverec s bílým znakem X) 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 složitý graf nebo diagram. Tato vlastnost se mapuje na značku LongDesc v HTML a značku Desc v SVG (Scalable Vector Graphics). 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 namapována na vlastnost VisualDescription automatizace uživatelského rozhraní.
ItemStatusProperty	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, položka musí podporovat vlastnost stavu a vyvolat příslušná oznámení, když se stav změní. Pokud je obrázek samostatný ovládací prvek a vyjadřuje stav této vlastnosti, musí být podporována.

Požadované vzory ovládacích prvků automatizace uživatelského rozhraní

Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky obrázků. Další informace o vzorech ovládacích prvků naleznete 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 pro obrázky podporuje vzor položky v mřížce, pokud je tento prvek umístěn v kontejneru mřížky.
ITableItemProvider	Závisí	Ovládací prvek obrázku podporuje vzor položky tabulky, pokud se nachází v kontejneru, který obsahuje ovládací prvky záhlaví.
IInvokeProvider	Nikdy	Pokud ovládací prvek obsahuje kliknutelný obrázek, měl by podporovat typ ovladače, který umožňuje vzor Vyvolat, například ovládací prvek typu Tlačítko.
ISelectionItemProvider	Nikdy	Ovládací prvky obrázku by neměly podporovat vzor pro výběr položek.

Požadované události automatizace uživatelského rozhraní

V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky obrázků. 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í	Podpora	Poznámky
InvokedEvent	Nikdy	Žádné
ElementAddedToSelectionEvent	Nikdy	Žádné
ElementRemovedFromSelectionEvent	Nikdy	Žádné
ElementSelectedEvent	Nikdy	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
NameProperty událost změny vlastnosti.	Povinné	Žádné
AutomationFocusChangedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné

Viz také

• Image
• Přehled typů ovládacích prvků automatizace uživatelského rozhraní
• Přehled automatizace uživatelského rozhraní