Implementace vzoru ovládacích prvků MultipleView pro automatizaci uživatelského rozhraní

  • Článek

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 IMultipleViewProvider, včetně informací o událostech a vlastnostech. Odkazy na další odkazy jsou uvedeny na konci tématu.

Vzor MultipleViewPattern ovládacích prvků slouží k podpoře ovládacích prvků, které poskytují, a umožňují přepínat mezi různými reprezentacemi stejné sady informací nebo podřízených ovládacích prvků.

Mezi příklady ovládacích prvků, které můžou prezentovat více zobrazení, patří zobrazení seznamu (které může zobrazit jeho obsah jako miniatury, dlaždice, ikony nebo podrobnosti), grafy Microsoft Excelu (výsečový, spojnicový, pruhový, hodnota buňky se vzorcem), dokumenty Microsoft Wordu (normální, webové rozložení, rozložení při tisku, rozložení pro čtení, osnova), kalendář Aplikace Microsoft Outlook (rok, měsíc, týden, den) a microsoft Přehrávač médií Windows vzhledy. Podporovaná zobrazení určují vývojář ovládacích prvků a jsou specifická pro každý ovládací prvek.

Pokyny a konvence implementace

Při implementaci vzoru ovládacího prvku Multiple View si všimněte následujících pokynů a konvencí:

  • IMultipleViewProvider by také mělo být implementováno v kontejneru, který spravuje aktuální zobrazení, pokud se liší od ovládacího prvku, který poskytuje aktuální zobrazení. Průzkumník Windows například obsahuje ovládací prvek Seznam pro aktuální obsah složky, zatímco zobrazení ovládacího prvku je spravováno z aplikace Průzkumník Windows.

  • Ovládací prvek, který dokáže řadit jeho obsah, se nepovažuje za podporu více zobrazení.

  • Kolekce zobrazení musí být identická napříč instancemi.

  • Názvy zobrazení musí být vhodné pro použití v textu na řeč, Braillově písmu a dalších aplikacích čitelných pro člověka.

Požadované členy pro IMultipleViewProvider

Pro implementaci IMultipleViewProvider jsou vyžadovány následující vlastnosti a metody.

Požadované členy Typ členu Notes
CurrentView Vlastnost Nic
GetSupportedViews metoda Nic
GetViewName metoda Nic
SetCurrentView metoda Nic

K tomuto vzoru ovládacího prvku nejsou přidruženy žádné události.

Výjimky

Zprostředkovatel musí vyvolat následující výjimky.

Typ výjimky Podmínka
ArgumentException SetCurrentView Pokud je volána nebo GetViewName je volána s parametrem, který není členem podporované kolekce zobrazení.

Viz také