次の方法で共有


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

更新 : 2007 年 11 月

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

DockPattern コントロール パターンは、ドッキング コンテナ内のコントロールのドッキング プロパティを公開するために使用します。ドッキング コンテナは、子要素を互いに水平方向または垂直方向に整列できるコントロールです。このコントロール パターンを実装するコントロールの例については、「UI オートメーション クライアントのコントロール パターン マッピング」を参照してください。

"Class View" ウィンドウが DockPosition.Right に "Error List" ウィンドウが DockPosition.Bottom にそれぞれ配置された Visual Studio のドッキングの例
ドッキングされた 2 つの子を持つドッキング コンテナ。

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

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

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

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

  • IDockProvider は、ドッキング コンテナのプロパティや、ドッキング コンテナ内の現在のコントロールに隣接してドッキングされるコントロールのプロパティは公開しません。

  • コントロールは、現在の z オーダーに基づき、相互に関連してドッキングされます。z オーダー配置が上位であるほど、指定されたドッキング コンテナの端から離れた位置に配置されます。

  • ドッキング コンテナのサイズを変更すると、コンテナ内のドッキングされているコントロールは、もともとドッキングされていたのと同じ端に合わせて再配置されます。また、DockPosition のドッキング動作に従って、ドッキングされているコントロールも、コンテナ内のスペースを埋めるようにサイズ変更されます。たとえば、Top が指定されている場合は、コントロールの左側と右側が広がって、使用できるスペースを埋めます。Fill が指定されている場合は、コントロールの 4 つの側面すべてが広がって、使用できるスペースを埋めます。

  • マルチモニタ システムでは、コントロールは現在のモニタの左側または右側にドッキングする必要があります。それが不可能な場合は、左端のモニタの左側、または右端のモニタの右側にドッキングする必要があります。

IDockProvider の必須メンバ

次のプロパティとメソッドは、IDockProvider インターフェイスの実装時に必要です。

必須メンバ

メンバ型

説明

DockPosition

プロパティ

なし

SetDockPosition

メソッド

なし

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

例外

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

例外の種類

条件

InvalidOperationException

SetDockPosition

  • 要求されたドッキング スタイルをコントロールが実行することができない場合。

参照

処理手順

UI オートメーション プロバイダでのコントロール パターンのサポート

UI オートメーションにおけるキャッシュの使用

概念

UI オートメーション コントロール パターンの概要

クライアントの UI オートメーション コントロール パターン

UI オートメーション ツリーの概要