注
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、「Windows Automation API: UI オートメーション 」を参照してください。
このトピックでは、プロパティに関する情報など、 IDockProviderを実装するためのガイドラインと規則について説明します。 その他の参照へのリンクは、トピックの最後に一覧表示されます。
DockPattern コントロール パターンは、ドッキング コンテナー内のコントロールのドッキング プロパティを公開するために使用されます。 ドッキング コンテナーは、子要素を互いに相対的に水平方向および垂直方向に配置できるコントロールです。 このコントロール パターンを実装するコントロールの例については、「UI オートメーション クライアントのコントロール パターン マッピング 」を参照してください。
"クラス ビュー" ウィンドウが DockPosition.Right、"エラー 一覧" ウィンドウが DockPosition.Bottom である Visual Studio のドッキングの例
実装のガイドラインと規則
Dock コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。
IDockProvider では、ドッキング コンテナーのプロパティや、ドッキング コンテナー内の現在のコントロールに隣接してドッキングされるコントロールのプロパティは公開されません。
コントロールは、現在の z オーダーに基づいて相互に相対的にドッキングされます。z オーダーの配置が高いほど、ドッキング コンテナーの指定された端から配置されます。
ドッキング コンテナーのサイズが変更されると、コンテナー内のドッキングされたコントロールは、最初にドッキングされたのと同じエッジにフラッシュの位置が変更されます。 ドッキングされたコントロールは、 DockPositionのドッキング動作に応じて、コンテナー内の任意の領域を埋めるようにサイズも変更されます。 たとえば、 Top を指定すると、コントロールの左側と右側が展開され、使用可能な領域が埋められます。 Fillを指定すると、コントロールの4つの側面すべてが展開され、使用可能な領域を満たします。
マルチモニター システムでは、コントロールは現在のモニターの左側または右側にドッキングする必要があります。 それができない場合は、左端のモニターの左側または右端のモニターの右側にドッキングする必要があります。
IDockProvider の必須メンバー
IDockProvider インターフェイスの実装には、次のプロパティとメソッドが必要です。
| 必須メンバー | メンバーの種類 | 注記 |
|---|---|---|
| DockPosition | プロパティ | 無し |
| SetDockPosition | メソッド | 無し |
このコントロール パターンには、関連付けられたイベントはありません。
例外
プロバイダーは、次の例外をスローする必要があります。
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | SetDockPosition - コントロールが要求されたドック スタイルを実行できない場合。 |