CDockablePane クラス
更新 : 2007 年 11 月
ドッキング サイトにドッキングできる、またはタブ付きペインに含めることができるペインを実装します。
class CDockablePane : public CPane
メンバ
パブリック コンストラクタ
名前 |
説明 |
|---|---|
CDockablePane オブジェクトを構築し、初期化します。 |
パブリック メソッド
名前 |
説明 |
|---|---|
ペインを別のペインにアタッチします。これによって、タブ付きペインが作成されます。 |
|
(CBasePane::CalcFixedLayout をオーバーライドします。) |
|
|
|
別のペインを現在のペインにドッキングできるかどうかを調べます。 |
|
|
|
ペインが自動非表示モードをサポートするかどうかを判定します。(CBasePane::CanAutoHide をオーバーライドします。) |
|
現在のペインを別のペインにドッキングできるかどうかを判定します。 |
|
(CPane::ConvertToTabbedDocument をオーバーライドします。) |
|
(CPane::CopyState をオーバーライドします。) |
|
Windows コントロールを作成し、それを CDockablePane オブジェクトにアタッチします。 |
|
|
|
Windows コントロールを作成し、それを CDockablePane オブジェクトにアタッチします。 |
|
現在のペインからタブ付きペインを作成します。 |
|
|
|
(CPane::DockPaneStandard をオーバーライドします。) |
|
(CPane::DockToFrameWindow をオーバーライドします。) |
|
|
|
ドッキング ペインを別のドッキング ペインにドッキングします。 |
|
このペイン、およびコンテナ内の他のペインの自動非表示モードをまとめて有効または無効にします。 |
|
キャプション (グリップ) を表示または非表示にします。 |
|
|
|
|
|
|
|
|
|
現在のキャプションの高さを返します。 |
|
ペインのコンテナの既定のペイン区分線を返します。 |
|
与えられたポインタ位置に基づいてドッキングされたペインの機能を判断します。 |
|
ドッキング ペインのドラッグ感度を返します。 |
|
|
|
|
|
|
|
別のペインが現在のペインにドッキングされたときに作成されるタブ付きウィンドウに関するランタイム クラス情報を返します。 |
|
ドッキング ペインを自動非表示モードに切り替えられるかどうかを指定します。 |
|
ペイン内でユーザーがマウスをクリックした特定の位置を指定します。 |
|
(CBasePane::IsAccessibilityCompatible をオーバーライドします。) |
|
ペインが自動的に隠すモードかどうかを判断します。 |
|
ドッキング ペインとコンテナ内の他のすべてのペインを、自動非表示モードで配置できるかどうかを示します。 |
|
(CPane::IsChangeState をオーバーライドします。) |
|
現在のペインがドッキングされているかどうかを判定します。 |
|
|
|
|
|
ShowPane を呼び出してペインの表示と非表示を切り替える場合、自動非表示モードのペインの動作を決定します。 |
|
(CPane::IsInFloatingMultiPaneFrameWnd をオーバーライドします。) |
|
(CPane::IsResizable をオーバーライドします。) |
|
|
|
|
|
現在のペインの表示状態を判定します。 |
|
(CPane::LoadState をオーバーライドします。) |
|
ペインの親が変更されたときに、フレームワークによって呼び出されます。(CPane::OnAfterChangeParent をオーバーライドします。) |
|
フリーのドッキング バーがフレーム ウィンドウにドッキングされるときに、フレームワークによって呼び出されます。 |
|
ペインの親が変更される直前に、フレームワークによって呼び出されます。(CPane::OnBeforeChangeParent をオーバーライドします。) |
|
ペインがフローティング状態になる直前に、フレームワークによって呼び出されます。(CPane::OnBeforeFloat をオーバーライドします。) |
|
(CBasePane::OnUpdateCmdUI をオーバーライドします。) |
|
(CBasePane::PreTranslateMessage をオーバーライドします。) |
|
|
|
|
|
|
|
(CPane::SaveState をオーバーライドします。) |
|
(CBasePane::Serialize をオーバーライドします。) |
|
ドッキング ペインの表示モードと自動非表示モードを切り替えます。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
2 つのペインがドッキングされるときに作成されるタブ付きウィンドウのランタイム クラス情報を設定します。 |
|
ペインの表示と非表示を切り替えます。 |
|
ペインが自動非表示モードの場合にのみ表示するスライド アニメーションを備えたペインを表示または非表示にします。 |
|
自動非表示モードに切り替えます。 (CPane::ToggleAutoHide をオーバーライドします。) |
|
メイン フレーム ウィンドウまたはマルチミニフレーム ウィンドウ コンテナからペインをドッキング解除します。 |
|
|
プロテクト メソッド
名前 |
説明 |
|---|---|
ドッキング ペインが非表示 (自動非表示モード) かどうかを判断します。 |
|
自動的に隠すドッキング ペインがスライドをいつ停止するかを判断します。 |
|
ドッキング ペイン キャプション (グリップ) を描画します。 |
|
ユーザーが AFX_HTCLOSE ボタンと AFX_HTMAXBUTTON ボタン以外のキャプション ボタンを押したときに呼び出されます。 |
|
ペインが表示または非表示にされているときに自動非表示スライド効果を表示するために、フレームワークによって呼び出されます。 |
データ メンバ
名前 |
説明 |
|---|---|
ドッキング可能なペインの自動非表示アニメーションを無効にするかどうかを指定します。 |
|
ペインが自動的に隠すモードのときに、ペインの動作を決定します。 |
|
自動非表示モードでペインが表示または非表示にされているときのペインのアニメーション速度を指定します。 |
解説
CDockablePane は次の機能を実装します。
メイン フレーム ウィンドウへのペインのドッキング。
自動非表示モードへのペインの切り替え。
タブ付きウィンドウへのペインのアタッチ。
ミニフレームウィンドウでのペインの切り離し。
ミニフレーム ウィンドウにおける浮動ペインの、別のペインへのドッキング。
ペインのサイズ変更。
ドッキング ペインの状態の読み込みと保存。
.gif "メモ")
メモ :状態情報は、Windows レジストリに保存されます。
キャプション付きまたはキャプションなしのペインの作成。キャプションには、テキスト ラベルを設定できます。また、キャプションをグラデーションの色で塗りつぶすことができます。
ペインのコンテンツ表示中のペインのドラッグ。
ドラッグ四角形の表示中のペインのドラッグ。
アプリケーションでドッキング ペインを使用するには、CDockablePane クラスからペイン クラスを派生します。派生オブジェクトをメイン フレーム ウィンドウ オブジェクトまたはペインのインスタンスを制御するウィンドウ オブジェクトに埋め込みます。次に、メイン フレーム ウィンドウで WM_CREATE メッセージを処理するときに、CDockablePane::Create メソッドまたは CDockablePane::CreateEx メソッドを呼び出します。最後に、CBasePane::EnableDocking、CBasePane::DockPane、または CDockablePane::AttachToTabWnd を呼び出してペイン オブジェクトを設定します。
使用例
CDockablePane クラスのさまざまなメソッドを使用して CDockablePane オブジェクトを構成する方法を次の例に示します。この例では、ドッキング可能ペインのすべての機能の自動非表示を有効にする方法、キャプションまたはグリッパを有効にする方法、自動非表示モードを有効にする方法、ペインを表示する方法、および自動非表示モードのペインをアニメーション化する方法を示しています。このコード スニペットは、「VisualStudioDemo サンプル : MFC Visual Studio アプリケーション」の一部です。
// GetOwner is an inherited method.
CDockablePane* pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());
...
pParentBar->EnableAutohideAll();
pParentBar->EnableGripper(true);
pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
pParentBar->ShowPane(true,false,true);
pParentBar->Slide(true);
継承階層
必要条件
ヘッダー : afxDockablePane.h