實作 UI 自動化 MultipleView 控制項模式

注意

本文件適用對象為 .NET Framework 開發人員,其想要使用 System.Windows.Automation 命名空間中定義的受控 UI 自動化類別。 如需 UI 自動化的最新資訊,請參閱 Windows 自動化 API:UI 自動化

本主題將介紹實作 IMultipleViewProvider的方針和慣例,包括事件和屬性的相關資訊。 其他參考的連結列於此主題的結尾部分。

MultipleViewPattern 控制項模式可用來支援控制項,這種控制項提供相同一組資訊或子控制項的多種不同表示,而且能夠在這些表示之間切換。

能夠呈現多種檢視的控制項包括清單檢視 (以縮圖、並排顯示、圖示或詳細資料顯示內容)、Microsoft Excel 圖表 (圓形圖、折線圖、橫條圖、含公式的儲存格值)、Microsoft Word 文件 (標準、Web 版面配置、整頁模式、閱讀版面配置、大綱)、Microsoft Outlook 行事曆 (年、月、星期、天) 以及 Microsoft Windows 媒體播放器面板。 支援哪些檢視會由控制項的開發人員決定,而且是每個控制項所特有。

實作方針和慣例

實作多重檢視控制項模式時,請注意下列方針和慣例:

  • 若管理目前檢視的容器與提供目前檢視的控制項不同,則也應在容器上實作IMultipleViewProvider 。 例如,Windows 檔案總管包含目前資料夾內容的清單控制項,而控制項的檢視則是由 Windows 檔案總管應用程式管理。

  • 可以排序內容的控制項不視為支援多種檢視。

  • 檢視集合在執行個體之間必須完全相同。

  • 檢視名稱必須適用於文字轉換語音、點字以及其他人類看得懂的應用程式。

IMultipleViewProvider 的必要成員

以下是實作 IMultipleViewProvider 的必要屬性和方法。

必要成員 成員類型 備註
CurrentView 屬性
GetSupportedViews 方法
GetViewName 方法
SetCurrentView 方法

這個控制項模式沒有相關事件。

例外狀況

提供者必須擲回下列例外狀況。

例外狀況類型 Condition
ArgumentException 呼叫 SetCurrentViewGetViewName 時使用的參數不是所支援檢視集合的成員。

另請參閱