UI オートメーション MultipleView コントロールパターンの実装

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ここでは、イベントやプロパティに関する情報など、IMultipleViewProvider を実装するガイドラインと規則について説明します。追加参照へのリンクはトピックの最後に示します。

MultipleViewPattern コントロールパターンは、同じ情報セットの複数の表現または子コントロールを提供し、その間で切り替えができるようにするコントロールをサポートするために使用されます。

複数のビューを表示できるコントロールの例として、リストビュー (サムネイル、タイル、アイコン、または詳細としてコンテンツを表示)、Microsoft Excel グラフ (円、折れ線、横棒、式を使用するセル値)、Microsoft Word ドキュメント (標準、Web レイアウト、印刷レイアウト、読み取りレイアウト、アウトライン)、Microsoft Outlook カレンダー (年、月、週、日)、Microsoft Windows Media Player スキンなどがあります。サポートされるビューは、コントロールの開発者によって決定され、各コントロールに固有です。

このトピックには次のセクションが含まれています。

実装のガイドラインと規則
IMultipleViewProvider の必須メンバ
例外
関連トピック

実装のガイドラインと規則

MultipleView コントロールパターンを実装する場合は、次のガイドラインと規則に注意してください。

現在のビューを管理するコンテナが現在のビューを提供するコントロールと異なる場合は、そのコンテナに IMultipleViewProvider も実装する必要があります。たとえば、Windows エクスプローラには現在のフォルダのコンテンツのリストコントロールが含まれていますが、そのコントロールのビューは Windows エクスプローラアプリケーションから管理されています。
自身のコンテンツを並べ替えることができるコントロールは、複数のビューをサポートしているとは見なされません。
ビューのコレクションは、すべてのインスタンスで同じである必要があります。
ビューの名前は、読み上げ、Braille、およびその他のユーザーが判読できるアプリケーションでの使用に適した名前にする必要があります。

IMultipleViewProvider の必須メンバ

次のプロパティとメソッドは、IMultipleViewProvider の実装時に必要です。

必須メンバ	メンバ型	説明
CurrentView	プロパティ	なし
GetSupportedViews	メソッド	なし
GetViewName	メソッド	なし
SetCurrentView	メソッド	なし

このコントロールパターンに関連付けられたイベントはありません。

例外

プロバイダは次の例外をスローする必要があります。

例外の種類	条件
ArgumentException	SetCurrentView または GetViewName が、サポートされているビューコレクションのメンバではないパラメータで呼び出された場合。