實作 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 | 呼叫 SetCurrentView 或 GetViewName 時使用的參數不是所支援檢視集合的成員。 |