CDockablePane クラス
ドッキング サイトにドッキングできる、またはタブ付きペインに含めることができるペインを実装します。
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 は次の機能を実装します。
メイン フレーム ウィンドウへのペインのドッキング。
自動非表示モードへのペインの切り替え。
タブ付きウィンドウへのペインのアタッチ。
ミニフレームウィンドウでのペインの切り離し。
ミニフレーム ウィンドウにおける浮動ペインの、別のペインへのドッキング。
ペインのサイズ変更。
ドッキング ペインの状態の読み込みと保存。
注意
状態情報は、Windows レジストリに保存されます。
キャプション付きまたはキャプションなしのペインの作成。 キャプションには、テキスト ラベルを設定できます。また、キャプションをグラデーションの色で塗りつぶすことができます。
ペインのコンテンツ表示中のペインのドラッグ。
ドラッグ四角形の表示中のペインのドラッグ。
アプリケーションでドッキング ペインを使用するには、CDockablePane クラスからペイン クラスを派生します。 派生オブジェクトをメイン フレーム ウィンドウ オブジェクトまたはペインのインスタンスを制御するウィンドウ オブジェクトに埋め込みます。 次に、メイン フレーム ウィンドウで WM_CREATE メッセージを処理するときに、CDockablePane::Create メソッドまたは CDockablePane::CreateEx メソッドを呼び出します。 最後に、CBasePane::EnableDocking、CBasePane::DockPane、または CDockablePane::AttachToTabWnd を呼び出してペイン オブジェクトを設定します。
カスタマイズのヒント
次のヒントは CDockablePane オブジェクトに適用されます。
タブ付きではない 2 つのドッキング可能ペインに CDockablePane::AttachToTabWnd を呼び出した場合、タブ付きウィンドウへのポインターが ppTabbedControlBar パラメーターに返されます。 このパラメーターを使用することにより、続けてタブ付きウィンドウにタブを追加できます。
CDockablePane::AttachToTabWnd により作成されるタブ付きペインの種類は、pTabControlBarAttachTo パラメーターの CDockablePane オブジェクトにより決まります。 CDockablePane::SetTabbedPaneRTC を呼び出して、CDockablePane が作成するタブ付きペインの種類を設定できます。 既定の型は、最初に CDockablePane を作成するときに CDockablePane::Create の dwTabbedStyle により決まります。 dwTabbedStyle が AFX_CBRS_OUTLOOK_TABS の場合、既定の型は CMFCOutlookBar クラス です。dwTabbedStyle が AFX_CBRS_REGULAR_TABS の場合、既定の型は CTabbedPane クラス です。
ドッキング可能ペインを別のドッキング可能ペインにドッキングするには、CDockablePane::DockToWindow メソッドを呼び出します。 このメソッドを呼び出す前に、元のペインをどこかにドッキングする必要があります。
メンバー変数 CDockablePane::m_bHideInAutoHideMode は、CDockablePane::ShowPane を呼び出したときにドッキング可能ペインが自動非表示モードでどのように動作するかを制御します。 このメンバー変数が TRUE に設定されている場合、ドッキング可能ペインとその自動非表示ボタンは非表示になります。 それ以外の場合は、スライド インおよびスライド アウトします。
CDockablePane::m_bDisableAnimation メンバー変数を TRUE に設定することで、自動非表示アニメーションを無効にできます。
使用例
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