Sdílet prostřednictvím


Implementace vzoru ovládacích prvků okna automatizace 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 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 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 pozici obrazovky pomocí automatizace uživatelského rozhraní, 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 odlišují od základních vyskakovacích oken s tooltipem tím, že mají tlačítko Zavřít podobné oknu.

  • 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 Poznámky
InteractionState Vlastnictví Žádné
IsModal Vlastnictví Žádné
IsTopmost Vlastnictví Žádné
Maximizable Vlastnictví Žádné
Minimizable Vlastnictví Žádné
VisualState Vlastnictví Žádné
Close Metoda Žádné
SetVisualState Metoda Žádné
WaitForInputIdle Metoda Žádné
WindowClosedEvent Událost Žádné
WindowOpenedEvent Událost Žádné
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é