注释
本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息,请参阅 Windows 自动化 API:UI 自动化。
本主题介绍实现的 IMultipleViewProvider准则和约定,包括有关事件和属性的信息。 主题末尾列出了指向其他引用的链接。
控件 MultipleViewPattern 模式用于支持提供且能够在同一组信息或子控件的多个表示形式之间进行切换的控件。
可显示多个视图的控件示例包括列表视图(可以将其内容显示为缩略图、磁贴、图标或详细信息),Microsoft Excel 图表(饼图、折线图、条形图、单元格值和公式),Microsoft Word 文档(普通、Web 布局、打印布局、阅读布局、大纲)、Microsoft Outlook 日历(年、月、周、日)和Microsoft Windows Media Player 外观。 支持的视图由控件开发人员确定,特定于每个控件。
实施准则和约定
实现“多视图”控件模式时,请注意以下准则和约定:
IMultipleViewProvider 还应该在管理当前视图的容器上实现,如果该容器与提供当前视图的控件不同。 例如,Windows 资源管理器包含当前文件夹内容的列表控件,而控件的视图是从 Windows 资源管理器应用程序管理的。
无法对其内容进行排序的控件不被视为支持多个视图。
视图集合在实例之间必须相同。
视图名称必须适用于文本转语音、盲文和其他可读应用程序。
IMultipleViewProvider 的必需成员
实现 IMultipleViewProvider 需要以下属性和方法。
必需成员 | 成员类型 | 注释 |
---|---|---|
CurrentView | 资产 | 没有 |
GetSupportedViews | 方法 | 没有 |
GetViewName | 方法 | 没有 |
SetCurrentView | 方法 | 没有 |
没有与此控件模式关联的事件。
例外
提供程序必须引发以下异常。
异常类型 | 条件 |
---|---|
ArgumentException | 当 SetCurrentView 或 GetViewName 与不是受支持视图集合成员的参数一同被调用时。 |