Implementace vzoru ovládacích prvků MultipleView pro automatizaci uživatelského rozhraníImplementing the UI Automation MultipleView Control Pattern

Poznámka

Tato dokumentace je určena pro .NET Framework vývojářů, kteří chtějí používat spravované automatizace uživatelského rozhraníUI Automation třídy definované v System.Windows.Automation oboru názvů.This documentation is intended for .NET Framework developers who want to use the managed automatizace uživatelského rozhraníUI Automation classes defined in the System.Windows.Automation namespace. Nejnovější informace o najdete automatizace uživatelského rozhraníUI Automation v tématu rozhraní API služby Windows Automation: automatizace uživatelského rozhraní.For the latest information about automatizace uživatelského rozhraníUI Automation, see Windows Automation API: UI Automation.

Toto téma obsahuje pokyny a konvence pro implementaci IMultipleViewProvider , včetně informací o událostech a vlastnostech.This topic introduces guidelines and conventions for implementing IMultipleViewProvider, including information about events and properties. Odkazy na další odkazy jsou uvedeny na konci tématu.Links to additional references are listed at the end of the topic.

MultipleViewPatternVzor ovládacího prvku slouží k podpoře ovládacích prvků, které poskytují a jsou schopny přepínat mezi různými reprezentacemi stejné sady informací nebo podřízených ovládacích prvků.The MultipleViewPattern control pattern is used to support controls that provide, and are able to switch between, multiple representations of the same set of information or child controls.

Příklady ovládacích prvků, které mohou prezentovat více zobrazení, zahrnují zobrazení seznamu (které může zobrazit jeho obsah jako miniatury). dlaždice, ikony nebo podrobnosti), grafy Microsoft Excelu (výsečové, spojnicové, pruhové, sloupcové hodnoty se vzorcem), Microsoft Word (normální, rozložení pro tisk, rozložení pro čtení, rozložení pro čtení, osnova), Microsoft Outlook – kalendářní data (rok, měsíc, týden, den) a Microsoft Windows Media Player skiny.Examples of controls that can present multiple views include the list view (which can show its contents as thumbnails, tiles, icons, or details), Microsoft Excel charts (pie, line, bar, cell value with a formula), Microsoft Word documents (normal, Web layout, print layout, reading layout, outline), Microsoft Outlook calendar (year, month, week, day), and Microsoft Windows Media Player skins. Podporovaná zobrazení jsou určena vývojářem ovládacího prvku a jsou specifická pro každý ovládací prvek.The supported views are determined by the control developer and are specific to each control.

Pokyny a konvence implementaceImplementation Guidelines and Conventions

Při implementaci modelu více ovládacích prvků zobrazení si všimněte následujících pokynů a konvencí:When implementing the Multiple View control pattern, note the following guidelines and conventions:

  • IMultipleViewProviderměla by být také implementována na kontejneru, který spravuje aktuální zobrazení, pokud se liší od ovládacího prvku, který poskytuje aktuální zobrazení.IMultipleViewProvider should also be implemented on a container that manages the current view if it is different from a control that provides the current view. Například Průzkumník Windows obsahuje ovládací prvek seznamu pro aktuální obsah složky, zatímco zobrazení pro ovládací prvek je spravováno z aplikace Průzkumník Windows.For example, Windows Explorer contains a List control for the current folder content while the view for the control is managed from the Windows Explorer application.

  • Ovládací prvek, který je schopný seřadit jeho obsah, není považován za podporu více zobrazení.A control that is able to sort its content is not considered to support multiple views.

  • Kolekce zobrazení musí být identická mezi instancemi.The collection of views must be identical across instances.

  • Názvy zobrazení musí být vhodné pro použití v Převod textu na řeč, Braillova písma a dalších aplikacích čitelných lidmi.View names must be suitable for use in Text to Speech, Braille, and other human-readable applications.

Vyžadovaná členové pro IMultipleViewProviderRequired Members for IMultipleViewProvider

Pro implementaci IMultipleViewProvider jsou vyžadovány následující vlastnosti a metody.The following properties and methods are required for implementing IMultipleViewProvider.

Vyžadovaná členovéRequired members Typ členaMember type PoznámkyNotes
CurrentView VlastnostProperty ŽádnéNone
GetSupportedViews MetodaMethod ŽádnéNone
GetViewName MetodaMethod ŽádnéNone
SetCurrentView MetodaMethod ŽádnéNone

K tomuto vzoru ovládacích prvků nejsou přidruženy žádné události.There are no events associated with this control pattern.

VýjimkyExceptions

Zprostředkovatel musí vyvolat následující výjimky.Provider must throw the following exceptions.

Typ výjimkyException type PodmínkaCondition
ArgumentException Když SetCurrentView je nebo GetViewName je volána s parametrem, který není členem podporované kolekce zobrazení.When either SetCurrentView or GetViewName is called with a parameter that is not a member of the supported views collection.

Viz takéSee also