次の方法で共有


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

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

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

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

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

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

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

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

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

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

  • ビュー名は、テキスト読み上げ、点字、およびその他の人間が判読できるアプリケーションでの使用に適している必要があります。

IMultipleViewProvider の必須メンバー

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

必須メンバー メンバーの種類 注記
CurrentView プロパティ 無し
GetSupportedViews メソッド 無し
GetViewName メソッド 無し
SetCurrentView メソッド 無し

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

例外

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

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

こちらも参照ください