Sdílet prostřednictvím


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é