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

[アーティクル]
08/09/2011

メモ
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。

ここでは、イベントやプロパティに関する情報など、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 が、サポートされているビューコレクションのメンバーではないパラメーターで呼び出された場合。