CDockingManager クラス
メイン フレーム ウィンドウのドッキング レイアウトを制御するコア機能を実装します。
class CDockingManager : public CObject
メンバー
.gif "Bb983791.collapse_all(ja-jp,VS.110).gif")
パブリック メソッド
名前 |
説明 |
|---|---|
ドッキング ペインを作成し、それをコントロール バーのリストに追加します。 |
|
バー ペインへのハンドルを非表示の MDI タブ付きバー ペインのリストに追加します。 |
|
ミニフレームの一覧にフレームを追加します。 |
|
ペインをドッキング マネージャーに登録します。 |
|
フレーム ウィンドウ内のすべてのペインのレイアウトを再計算して調整します。 |
|
すべてのペインおよび CPaneFrameWnd ウィンドウに WM_NCCALCSIZE メッセージを送信します。 |
|
四角形の配置を調整します。 |
|
自動非表示モードのドッキング ペインのサイズを、ドッキング サイトで囲まれたフレームのクライアント領域全体の幅または高さになるように変更します。 |
|
自動非表示ツール バーを作成します。 |
|
指定された配置を持つドッキング バーを一番上に置きます。 |
|
ドッキング ペインおよびツール バーの名前をメニューに追加します。 |
|
ドッキング ウィンドウの予想される四角形を計算します |
|
ドッキング マネージャーを作成します。 |
|
指定した点とドッキング ステータスを含むペインを判断します。 |
|
レジストリからのドッキング レイアウトの読み込みを有効または無効にします。 |
|
ペインを別のペインまたはフレーム ウィンドウにドッキングします。 |
|
ペインを別のペインの左側にドッキングします。 |
|
ペインのメイン フレームへのドッキングを有効にし、ドッキング ペインを作成し、それをコントロール バーのリストに追加します。 |
|
ドッキング ペインを作成し、メイン フレームへのペインのドッキングを有効にします。 |
|
すべてのドッキング ペインのキャプションにポップアップ メニューを開く、追加のボタンを表示します。 |
|
ユーザーが右マウス ボタンをクリックし、ライブラリが WM_CONTEXTMENU メッセージを処理している場合に、ライブラリに対して、アプリケーションのツール バーとドッキング ペインがリストされる特別なコンテキスト メニューを表示するよう指示します。 |
|
指定された位置にあり、指定された配置を持つバー ペインを取得します。 |
|
対象のバー ペインの ID を持つバー ペインを返します。 |
|
指定したコントロール ID でペインを検索します。 |
|
現在のすべてのツール バーの位置を仮想四角形にコミットします。 |
|
指定した点を含むフレームを返します。 |
|
クライアント領域の境界を含む四角形を取得します。 |
|
現在のドッキング モードを返します。 |
|
親ウィンドウ フレームへのポインターを取得します。 |
|
ペインの有効な配置を返します。 |
|
ミニフレームの一覧を取得します。 |
|
フレームの外縁を含む四角形を取得します。 |
|
ドッキング マネージャーに属するペインの一覧を返します。これには、すべての浮動ペインが含まれます。 |
|
スマート ドッキング マネージャーへのポインターを取得します。 |
|
スマート ドッキング マネージャーへのポインターを取得します。 |
|
ドッキング マネージャーのスマート ドッキングのパラメーターを返します。 |
|
スマート ドッキング マーカーの表示に使用されるテーマを返す静的メソッド。 |
|
自動的に隠すモードのペインを非表示にします。 |
|
ドッキング ペインを作成し、それをコントロール バーのリストに挿入します。 |
|
コントロール ペインをコントロール バーのリストに挿入します。 |
|
すべてのペインのキャプションにポップアップ メニューが表示されるかどうかを指定します。 |
|
すべてのペインのレイアウトが調整されているかどうかを確認します。 |
|
ドッキング マネージャーが OLE コンテナー モードであるかどうかを示します。 |
|
指定された点がドッキング サイトの近くにあるかどうかを判定します。 |
|
印刷プレビュー モードが設定されているかどうかを判定します。 |
|
レジストリからドッキング マネージャーの状態を読み込みます。 |
|
指定されたウィンドウをロックします。 |
|
フレーム ウィンドウがアクティブまたは非アクティブになるときに、フレームワークによって呼び出されます。 |
|
アクティブなポップアップ メニューが WM_DESTROY メッセージを処理するときに、フレームワークによって呼び出されます。 |
|
ミニフレーム ウィンドウを移動するために、フレームワークによって呼び出されます。 |
|
ペインのリストを持つメニューをビルドするときに、フレームワークによって呼び出されます。 |
|
指定した点を含むペインを返します。 |
|
指定されたコマンドのチェック ボックスをオンまたはオフにし、表示されるペインのレイアウトを再計算するために、フレームワークによって呼び出されます。 |
|
コントロールのリストに提示されるコントロールの内部レイアウトを再計算します。 |
|
空のペイン コンテナーを解放します。 |
|
指定された非表示のバー ペインを削除します。 |
|
指定したフレームをミニフレームの一覧から削除します。 |
|
ペインの登録を解除し、ドッキング マネージャーの一覧から削除します。 |
|
ペインを別のペインに置き換えます。 |
|
ミニフレームの一覧でフレームを再度並べ替えます。 |
|
レジストリにドッキング マネージャーの状態を保存します。 |
|
指定されたメッセージをすべてのミニフレームに送信します。 |
|
ドッキング マネージャーをアーカイブに書き込みます。(CObject::Serialize をオーバーライドします。) |
|
コントロール バーと指定されたペインのサイズ、幅、および高さを設定します。 |
|
ドッキング モードを設定します。 |
|
コントロール バー、ミニ フレーム、および自動非表示バーのドッキング状態を設定します。 |
|
印刷プレビューに表示されるバーの印刷プレビュー モードを設定します。 |
|
スマート ドッキングの動作を定義するパラメーターを設定します。 |
|
ミニフレーム ウィンドウの表示と非表示を切り替えます。 |
|
コントロールと自動非表示のバーのペインの表示と非表示を切り替えます。 |
|
スマート ドッキング マネージャーの配置に従って指定されたウィンドウのスマート ドッキングを開始します。 |
|
スマート ドッキングを停止します。 |
データ メンバー
名前 |
説明 |
|---|---|
OLE コンテナー モードの場合にドッキング マネージャーがペインを非表示にするかどうかを指定します。 |
|
グローバル ドッキング モードを指定します。 |
|
ドッキング感度を指定します。 |
|
即時ドッキング モードでドッキング ペインがドッキングするまでの待機時間をミリ秒単位で指定します。 |
|
ツール バーがメイン フレーム ウィンドウにドッキングされるまでの時間をミリ秒単位で指定します。 |
解説
メイン フレーム ウィンドウは、このクラスを自動的に作成および初期化します。
ドッキング マネージャー オブジェクトは、ドッキング レイアウト内にあるすべてのペインのリスト、およびメイン フレーム ウィンドウに属するすべての CPaneFrameWnd ウィンドウのリストも保持します。
CDockingManager クラスは、ペインまたは CPaneFrameWnd ウィンドウを検索するために使用できるサービスを実装します。これらのサービスはメイン フレーム ウィンドウのオブジェクトにラップされるので、通常は直接呼び出しません。詳細については、「CPaneFrameWnd クラス」を参照してください。
カスタマイズのヒント
次のヒントは CDockingManager オブジェクトに適用されます。
CDockingManager クラスは、次のドッキング モードをサポートします。
AFX_DOCK_TYPE::DT_IMMEDIATE
AFX_DOCK_TYPE::DT_STANDARD
AFX_DOCK_TYPE::DT_SMART
これらのドッキング モードは CDockingManager::m_dockModeGlobal により定義され、CDockingManager::SetDockingMode を呼び出すことにより設定されます。
非フローティングのサイズ変更できないペインを作成するには、CDockingManager::AddPane メソッドを呼び出します。このメソッドは、ペインのレイアウトを制御するドッキング マネージャーにペインを登録します。
使用例
CDockingManager クラスのさまざまなメソッドを使用して CDockingManager オブジェクトを構成する方法を次の例に示します。例では、すべてのドッキング ペインのキャプションでポップアップ メニューを開く追加のボタンを表示する方法、およびオブジェクトのドッキング モードを設定する方法を示しています。このコード スニペットは Visual Studio のデモのサンプルの一部です。
CDockingManager* pDockManager = GetDockingManager();
ASSERT_VALID(pDockManager);
pDockManager->AdjustPaneFrames();
pDockManager->EnableDockSiteMenu();
pDockManager->SetDockingMode(DT_STANDARD);
継承階層
必要条件
ヘッダー : afxDockingManager.h