UI オートメーション Dock コントロール パターンの実装
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
ここでは、プロパティに関する情報など、 IDockProviderを実装するガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。
DockPattern コントロール パターンは、ドッキング コンテナー内のコントロールのドッキング プロパティを公開するために使用します。 ドッキング コンテナーは、子要素を互いに水平方向または垂直方向に整列できるコントロールです。 このコントロール パターンを実装するコントロールの例については、「 Control Pattern Mapping for UI Automation Clients」をご覧ください。
"Class View" ウィンドウが DockPosition.Right に "Error List" ウィンドウが DockPosition.Bottom にそれぞれ配置された Visual Studio のドッキングの例
実装のガイドラインと規則
Dock コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。
IDockProvider は、ドッキング コンテナーのプロパティや、ドッキング コンテナー内の現在のコントロールに隣接してドッキングされるコントロールのプロパティは公開しません。
コントロールは、現在の重ね順に基づき、互いを基準としてドッキングされます。重ね順が上位であるほど、指定されたドッキング コンテナーの端から離れた位置に配置されます。
ドッキング コンテナーのサイズを変更すると、コンテナー内にドッキングされているコントロールは、もともとドッキングされていたのと同じ端に合わせて再配置されます。 また、ドッキングされているコントロールは、 DockPositionのドッキング動作に従って、コンテナー内のスペースを埋めるようにサイズ変更されます。 たとえば、 Top が指定されている場合は、コントロールの左側と右側が広がって、使用できるスペースを埋めます。 Fill が指定されている場合は、コントロールの 4 つの側面すべてが広がって、使用できるスペースを埋めます。
マルチモニター システムでは、コントロールは現在のモニターの左側または右側にドッキングする必要があります。 それが不可能な場合は、左端のモニターの左側、または右端のモニターの右側にドッキングする必要があります。
IDockProvider の必須メンバー
次のプロパティとメソッドは、IDockProvider インターフェイスの実装時に必要です。
| 必須メンバー | メンバーの型 | メモ |
|---|---|---|
| DockPosition | プロパティ | なし |
| SetDockPosition | 方法 | なし |
このコントロール パターンには、関連するイベントがありません。
例外
プロバイダーは、次の例外をスローする必要があります。
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | SetDockPosition - 要求されたドッキング スタイルをコントロールによって実行することができない場合。 |