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