Implementace vzoru ovládacích prvků okno pro automatizaci uživatelského rozhraní
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 představuje pokyny a konvence pro implementaci IWindowProvider, včetně informací o WindowPattern vlastnostech, metodách a událostech. Odkazy na další odkazy jsou uvedeny na konci tématu.
Vzor WindowPattern ovládacích prvků se používá k podpoře ovládacích prvků, které poskytují základní funkce založené na okně v rámci tradičního grafického uživatelského rozhraní (GUI). Mezi příklady ovládacích prvků, které musí implementovat tento vzor ovládacího prvku, patří okna aplikací nejvyšší úrovně, podřízená okna MDI (multiple-document interface), změna velikosti ovládacích prvků rozděleného podokna, modální dialogy a okna nápovědy bubliny.
Pokyny a konvence implementace
Při implementaci vzoru ovládacích prvků Okna si všimněte následujících pokynů a konvencí:
Chcete-li podporovat možnost změnit velikost okna i umístění obrazovky pomocí model UI Automation, musí ovládací prvek implementovat ITransformProvider kromě IWindowProvider.
Ovládací prvky, které obsahují záhlaví a prvky záhlaví, které umožňují přesunout ovládací prvek, změnit jeho velikost, maximalizovat, minimalizovat nebo zavřít, jsou obvykle nutné k implementaci IWindowProvider.
Ovládací prvky, jako jsou automaticky otevíraná okna s popisem a pole se seznamem nebo rozevírací nabídky, obvykle neimplementují IWindowProvider.
Okna nápovědy bublin se liší od základních automaticky otevíraných oken popisů zřízením tlačítka Zavřít podobné okno.
Režim zobrazení na celé obrazovce není podporován IWindowProvider, protože je specifický pro aplikaci a není typické chování okna.
Požadované členy pro IWindowProvider
Pro rozhraní IWindowProvider jsou vyžadovány následující vlastnosti, metody a události.
Požadovaný člen | Typ členu | Notes |
---|---|---|
InteractionState | Vlastnost | Nic |
IsModal | Vlastnost | Nic |
IsTopmost | Vlastnost | Nic |
Maximizable | Vlastnost | Nic |
Minimizable | Vlastnost | Nic |
VisualState | Vlastnost | Nic |
Close | metoda | Nic |
SetVisualState | metoda | Nic |
WaitForInputIdle | metoda | Nic |
WindowClosedEvent | Událost | Nic |
WindowOpenedEvent | Událost | Nic |
WindowInteractionState | Událost | Není zaručeno, že je ReadyForUserInteraction |
Výjimky
Poskytovatelé musí vyvolat následující výjimky.
Typ výjimky | Podmínka |
---|---|
InvalidOperationException | SetVisualState – Pokud ovládací prvek nepodporuje požadované chování. |
ArgumentOutOfRangeException | WaitForInputIdle - Pokud parametr není platné číslo. |
Viz také
- Přehled vzorů ovládacích prvků pro automatizaci uživatelského rozhraní
- Podpora vzorů ovládacích prvků u zprostředkovatele automatizace uživatelského rozhraní
- Vzory ovládacích prvků automatizace uživatelského rozhraní pro klienty
- Přehled stromu automatizace uživatelského rozhraní
- Použití mezipaměti při automatizaci uživatelského rozhraní