次の方法で共有


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

Note

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

このトピックでは、イベントおよびプロパティに関する情報など、 IMultipleViewProviderの実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。

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

複数のビューを表示できるコントロールの例には、リスト ビュー (サムネイル、タイル、アイコン、または詳細の形でコンテンツを表示できる)、Microsoft Excel チャート (円、線、棒、式を含むセル値)、Microsoft Word 文書 (標準、Web レイアウト、印刷レイアウト、閲覧レイアウト、アウトライン)、Microsoft Outlook カレンダー (年、月、週、日)、Microsoft Windows Media Player スキンなどがあります。 サポートされるビューはコントロールの開発者によって決定され、各コントロールに固有です。

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

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

  • 現在のビューを管理するコンテナーが現在のビューを提供するコントロールとは異なる場合は、現在のビューを管理するためのコンテナーにもIMultipleViewProvider を実装する必要があります。 たとえば、Windows エクスプローラーには現在のフォルダーのコンテンツの List コントロールが含まれていますが、そのコントロールのビューは Windows エクスプローラーのアプリケーションから管理されています。

  • 自身のコンテンツを並べ替えることができるコントロールは、複数のビューをサポートしているとは見なされません。

  • ビューのコレクションは、インスタンス間で同じである必要があります。

  • ビューの名前は、読み上げ、ブライユ点字、その他の人間が判読できるアプリケーションでの使用に適した名前にする必要があります。

IMultipleViewProvider の必須メンバー

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

必須メンバー メンバーの型 メモ
CurrentView プロパティ なし
GetSupportedViews 方法 なし
GetViewName 方法 なし
SetCurrentView 方法 なし

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

例外

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

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

関連項目