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 が、サポートされているビュー コレクションのメンバーではないパラメーターで呼び出された場合。 |