Реализация шаблона элемента управления MultipleView модели автоматизации пользовательского интерфейса
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе приводятся рекомендации и соглашения для реализации IMultipleViewProvider, включая сведения о событиях и свойствах. Ссылки на дополнительные материалы перечислены в конце раздела.
Шаблон элемента управления MultipleViewPattern используется для поддержки элементов управления, которые предоставляют несколько представлений одного набора сведений или дочерних элементов управления и способны переключаться между ними.
Примеры элементов управления, которые могут представлять несколько представлений, включают представление списка (которое может отображать его содержимое в виде эскизов, плиток, значков или сведений), диаграммы Microsoft Excel (круговая линия, строка, значение ячейки с формулой), документы Microsoft Word (обычные, веб-макет, макет печати, макет чтения, структура), календарь Microsoft Outlook (год, месяц, неделя, день) и кожи Microsoft Медиаплеер Windows. Поддерживаемые представления определяются разработчиками элементов управления и относятся к конкретному элементу управления.
Правила и соглашения реализации
При реализации шаблона элемента управления Multiple View обратите внимание на следующие правила и соглашения.
IMultipleViewProvider также должен быть реализован в контейнере, который управляет текущим представлением, если он отличается от элемента управления, обеспечивающего текущее представление. Например, проводник содержит элемент управления "Список" для текущего содержимого папки, а представлением для этого элемента управления управляет приложение проводника.
Элемент управления, который может сортировать свое содержимое, не считается поддерживающим несколько представлений.
Коллекция представлений должна быть идентичной во всех экземплярах.
Имена представлений должны быть подходящими для использования в приложениях преобразования текста в речь, шрифта Брайля и других приложениях для удобства чтения.
Обязательные члены для IMultipleViewProvider
Следующие свойства и методы обязательны для реализации IMultipleViewProvider.
Обязательные члены | Тип члена | Примечания. |
---|---|---|
CurrentView | Свойство | нет |
GetSupportedViews | Способ | нет |
GetViewName | Способ | нет |
SetCurrentView | Способ | нет |
Отсутствуют события, связанные с этим шаблоном элемента управления.
Исключения
Поставщик должен вызывать следующие исключения.
Тип исключения | Condition |
---|---|
ArgumentException | Когда метод SetCurrentView или GetViewName вызывается с параметром, который не является членом коллекции поддерживаемых представлений. |
См. также
- Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса
- Поддержка шаблонов элементов управления в поставщике автоматизации пользовательского интерфейса
- Шаблоны элементов управления модели автоматизации пользовательского интерфейса для клиентов
- Общие сведения о дереве модели автоматизации пользовательского интерфейса
- Использование кэширования в модели автоматизации пользовательского интерфейса