Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku obrázek
Poznámka:
Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.
Toto téma obsahuje informace o podpoře model UI Automation pro typ ovládacího prvku Obrázek. V model UI Automation je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splňovat, aby bylo možné vlastnost použítControlTypeProperty. Podmínky zahrnují specifické pokyny pro strukturu stromové struktury model UI Automation, model UI Automation hodnoty vlastností 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 model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Image. Požadavky na model UI Automation platí pro všechny ovládací prvky obrázků, ať už windows Presentation Foundation (WPF), Win32 nebo model Windows Forms.
Požadovaná struktura stromu model UI Automation
Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu model UI Automation, které se týká ovládacích prvků obrázku, a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu model UI Automation najdete v tématu model UI Automation Stromový přehled.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Image | Obrázek (Závisí na tom, jestli obrázek obsahuje informace (na základě hodnoty IsContentElement vlastnosti)) |
Požadované vlastnosti model UI Automation
Následující tabulka uvádí model UI Automation vlastnosti, jejichž hodnota nebo definice jsou zvláště relevantní pro typ ovládacího prvku Obrázek. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| 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 bod v ohraničující obdélník 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 model UI Automation strom 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 model UI Automation Name. |
| LabeledByProperty | Viz poznámky. | Pokud je popisek statického textu, musí tato vlastnost vystavit odkaz na tento ovládací prvek. |
| ControlTypeProperty | Image | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| LocalizedControlTypeProperty | "image" | 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 model UI Automation stromu, pokud obsahuje smysluplné informace, které ještě nejsou vystaveny koncovému uživateli. |
| IsControlElementProperty | True | Ovládací prvek obrázku je vždy součástí zobrazení ovládacího prvku stromu model UI Automation. |
| 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 HTML LongDesc a značku 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 mapována na vlastnost model UI Automation VisualDescription. |
| 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ů model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků model UI Automation, které musí podporovat všechny ovládací prvky obrázku. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| IGridItemProvider | Závisí | Ovládací prvek obrázek podporuje vzor Položky mřížky, pokud je ovládací prvek v kontejneru mřížky. |
| ITableItemProvider | Závisí | Ovládací prvek obrázek podporuje vzor Položky tabulky, pokud je ovládací prvek v kontejneru, který obsahuje ovládací prvky záhlaví. |
| IInvokeProvider | Nikdy | Pokud ovládací prvek obrázku obsahuje kliknutelný obrázek, měl by ovládací prvek podporovat typ ovládacího prvku, který podporuje vzor Vyvolat, například typ ovládacího prvku Tlačítko. |
| ISelectionItemProvider | Nikdy | Ovládací prvky obrázku by neměly podporovat vzor Položky výběru. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí podporovat všechny ovládací prvky obrázků. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| InvokedEvent | Nikdy | Nic |
| ElementAddedToSelectionEvent | Nikdy | Nic |
| ElementRemovedFromSelectionEvent | Nikdy | Nic |
| ElementSelectedEvent | Nikdy | Nic |
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| NameProperty událost změněná vlastností. | Požaduje se | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |