注
このドキュメントは、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 - コントロールが要求されたドック スタイルを実行できない場合。 |