次の方法で共有


CDockablePane クラス

ドッキング サイトにドッキングできる、またはタブ付きペインに含めることができるペインを実装します。

class CDockablePane : public CPane

メンバー

Bb984433.collapse_all(ja-jp,VS.110).gifパブリック コンストラクター

名前

説明

CDockablePane::CDockablePane

CDockablePane オブジェクトを構築し、初期化します。

Bb984433.collapse_all(ja-jp,VS.110).gifパブリック メソッド

名前

説明

CDockablePane::AttachToTabWnd

ペインを別のペインにアタッチします。これによって、タブ付きペインが作成されます。

CDockablePane::CalcFixedLayout

ウィンドウ四角形のサイズを返します。

CDockablePane::CanAcceptMiniFrame

指定がミニフレーム ウィンドウにドッキングできるかどうかを判定します。

CDockablePane::CanAcceptPane

別のペインを現在のペインにドッキングできるかどうかを調べます。

CDockablePane::CanAutoHide

ペインが自動非表示モードをサポートするかどうかを判定します。(CBasePane::CanAutoHide をオーバーライドします。)

CDockablePane::CanBeAttached

現在のペインを別のペインにドッキングできるかどうかを判定します。

CDockablePane::ConvertToTabbedDocument

MDI タブ付きドキュメントに一つ以上のドッキング可能なペインを変換します。

CDockablePane::CopyState

ドッキングできるペインの状態をコピーします。

CDockablePane::Create

Windows コントロールを作成し、それを CDockablePane オブジェクトにアタッチします。

CDockablePane::CreateDefaultPaneDivider

フレーム ウィンドウにドッキングされるようにウィンドウの既定の区分線を作成します。

CDockablePane::CreateEx

Windows コントロールを作成し、それを CDockablePane オブジェクトにアタッチします。

CDockablePane::CreateTabbedPane

現在のペインからタブ付きペインを作成します。

CDockablePane::DockPaneContainer

ウィンドウにコンテナーをドッキングします。

CDockablePane::DockPaneStandard

アウトラインの (標準) を使用してドッキング ペインをドッキングします。

CDockablePane::DockToFrameWindow

内部使用。ペインをドッキングするには、CPane::DockPaneCDockablePane::DockToWindowを使用します。

CDockablePane::DockToRecentPos

格納されている最新のドッキング位置にペインをドッキングします。

CDockablePane::DockToWindow

ドッキング ペインを別のドッキング ペインにドッキングします。

CDockablePane::EnableAutohideAll

コンテナー内の他のペインとともにこのペインの自動非表示モードを有効または無効にします。

CDockablePane::EnableGripper

キャプション (グリップ) を表示または非表示にします。

CDockablePane::GetAHRestoredRect

表示されていた場合、自動非表示モードのペインの位置を指定します。

CDockablePane::GetAHSlideMode

ペインの自動非表示のスライド モードを取得します。

CDockablePane::GetAutoHideButton

内部使用。

CDockablePane::GetAutoHideToolBar

内部使用。

CDockablePane::GetCaptionHeight

現在のキャプションの高さを返します。

CDockablePane::GetDefaultPaneDivider

ペインのコンテナーの既定のペイン区分線を返します。

CDockablePane::GetDockingStatus

指定されたポインター位置に基づいてドッキングされるペインの機能を判断します。

CDockablePane::GetDragSensitivity

ドッキング ペインのドラッグ感度を返します。

CDockablePane::GetLastPercentInPaneContainer

ウィンドウがコンテナー内で占有空間の割合を取得します。

CDockablePane::GetTabArea

ウィンドウのタブ領域を取得します。

CDockablePane::GetTabbedPaneRTC

別のペインが現在のペインにドッキングされたときに作成されるタブ付きウィンドウに関するランタイム クラス情報を返します。

CDockablePane::HasAutoHideMode

ドッキング ペインが自動非表示モードに切り替えることができるかどうかを指定します。

CDockablePane::HitTest

ペイン内でユーザーがマウスをクリックした特定の位置を指定します。

CDockablePane::IsAccessibilityCompatible

内部使用。

CDockablePane::IsAutohideAllEnabled

ドッキング ペインとコンテナー内の他のすべてのペインを自動非表示モードに設定できるかどうかを示します。

CDockablePane::IsAutoHideMode

ペインが自動非表示モードにあるかどうかを判定します。

CDockablePane::IsChangeState

内部使用。

CDockablePane::IsDocked

現在のペインがドッキングされているかどうかを判定します。

CDockablePane::IsHideInAutoHideMode

ShowPaneを呼び出して、(表示または非表示にされます) 自動非表示モードのペインの動作を決定します。

CDockablePane::IsInFloatingMultiPaneFrameWnd

ウィンドウが複数のウィンドウ フレーム ウィンドウにあるかどうかを指定します。

CDockablePane::IsResizable

ウィンドウのサイズを変更できるかどうかを指定します。

CDockablePane::IsTabLocationBottom

タブがウィンドウの上部または下部にあるかどうかを指定します。

CDockablePane::IsTracked

ユーザーがペインをドラッグするかどうかを指定します。

CDockablePane::IsVisible

現在のペインの表示状態を判定します。

CDockablePane::LoadState

内部使用。

CDockablePane::OnAfterChangeParent

ペインの親が変更されたときに、フレームワークによって呼び出されます。(CPane::OnAfterChangeParent をオーバーライドします。)

CDockablePane::OnAfterDockFromMiniFrame

フリーのドッキング バーがフレーム ウィンドウにドッキングされるときに、フレームワークによって呼び出されます。

CDockablePane::OnBeforeChangeParent

ペインの親が変更される直前に、フレームワークによって呼び出されます。(CPane::OnBeforeChangeParent をオーバーライドします。)

CDockablePane::OnBeforeFloat

ペインがフローティング状態になる直前に、フレームワークによって呼び出されます (CPane::OnBeforeFloat をオーバーライドします)。

CDockablePane::RemoveFromDefaultPaneDividier

フレームワークは、ペインをドッキング解除されるときにこのメソッドを呼び出します。

CDockablePane::ReplacePane

特定のウィンドウでウィンドウを置き換えます。

CDockablePane::RestoreDefaultPaneDivider

フレームワークは既定のペイン区分線を復元するためにウィンドウが逆シリアル化するときにこのメソッドを呼び出します。

CDockablePane::SaveState

内部使用。

CDockablePane::Serialize

ウィンドウをシリアル化します。(CBasePane::Serialize をオーバーライドします。)

CDockablePane::SetAutoHideMode

表示モードと自動非表示のドッキング ペインの表示と非表示を切り替えます。

CDockablePane::SetAutoHideParents

ペインの自動非表示ボタンと自動非表示ツール バーを設定します。

CDockablePane::SetDefaultPaneDivider

内部使用。

CDockablePane::SetLastPercentInPaneContainer

ウィンドウがコンテナー内で占有空間の割合を設定します。

CDockablePane::SetResizeMode

内部使用。

CDockablePane::SetRestoredDefaultPaneDivider

復元された既定のペイン区分線を設定します。

CDockablePane::SetTabbedPaneRTC

2 つのペインがドッキングされるときに作成されるタブ付きウィンドウのランタイム クラス情報を設定します。

CDockablePane::ShowPane

ペインの表示と非表示を切り替えます。

CDockablePane::Slide

ペインが自動非表示モードの場合にのみ表示するスライド アニメーションを持つウィンドウを表示または非表示にします。

CDockablePane::ToggleAutoHide

自動非表示モードに切り替えます。 (CPane::ToggleAutoHide をオーバーライドします。)

CDockablePane::UndockPane

メイン フレーム ウィンドウまたはミニフレーム ウィンドウ コンテナーからペインをドッキング解除します。

CDockablePane::UnSetAutoHideMode

内部使用。自動非表示モードを設定するには、CDockablePane::SetAutoHideModeを使用します。

Bb984433.collapse_all(ja-jp,VS.110).gifプロテクト メソッド

名前

説明

CDockablePane::CheckAutoHideCondition

ドッキング ペインが非表示かどうかを判断します (自動非表示モードに)。

CDockablePane::CheckStopSlideCondition

自動非表示のドッキング ペインがスライドをいつ停止するかを判断します。

CDockablePane::DrawCaption

ドッキング ペイン キャプション (グリップ) を描画します。

CDockablePane::OnPressButtons

ユーザーが AFX_HTCLOSE ボタンと AFX_HTMAXBUTTON ボタン以外のキャプション ボタンを押したときに呼び出されます。

CDockablePane::OnSlide

ペインが表示または非表示にするときの自動非表示のスライド効果を表示するために、フレームワークによって呼び出されます。

Bb984433.collapse_all(ja-jp,VS.110).gifデータ メンバー

名前

説明

CDockablePane::m_bDisableAnimation

ドッキング可能なペインの自動非表示アニメーションを無効にするかどうかを指定します。

CDockablePane::m_bHideInAutoHideMode

ペインが自動非表示モードのときのペインの動作を決定します。

CDockablePane::m_nSlideSteps

これを自動非表示モードにと表示または非表示にされているときのペインのアニメーション速度を指定します。

解説

CDockablePane は次の機能を実装します。

  • メイン フレーム ウィンドウへのペインのドッキング。

  • ペインの自動非表示モードの切り替え。

  • タブ付きウィンドウへのペインのアタッチ。

  • ミニフレームウィンドウでのペインの切り離し。

  • ミニフレーム ウィンドウにおける浮動ペインの、別のペインへのドッキング。

  • ペインのサイズ変更。

  • ドッキング ペインの状態の読み込みと保存。

    [!メモ]

    状態情報は、Windows レジストリに保存されます。

  • キャプション付きまたはキャプションなしのペインの作成。キャプションには、テキスト ラベルを設定できます。また、キャプションをグラデーションの色で塗りつぶすことができます。

  • ペインのコンテンツ表示中のペインのドラッグ。

  • ドラッグ四角形の表示中のペインのドラッグ。

アプリケーションでドッキング ペインを使用するには、CDockablePane クラスからペイン クラスを派生します。派生オブジェクトをメイン フレーム ウィンドウ オブジェクトまたはペインのインスタンスを制御するウィンドウ オブジェクトに埋め込みます。次に、メイン フレーム ウィンドウで WM_CREATE メッセージを処理するときに、CDockablePane::Create メソッドまたは CDockablePane::CreateEx メソッドを呼び出します。最後に、CBasePane::EnableDockingCBasePane::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 オブジェクトを構成する方法を次の例に示します。例では、自動非表示のドッキングできるペインのすべての機能を有効にし、キャプションまたはグリッパーを有効にし、自動非表示モードを有効にし、ウィンドウの表示、自動非表示モードのペインをアニメーション化する方法を示します。このコード スニペットは 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);

継承階層

CObject

   CCmdTarget

      CWnd

         CBasePane

            CPane

               CDockablePane

必要条件

ヘッダー : afxDockablePane.h

参照

関連項目

階層図

CPane クラス

その他の技術情報

MFC クラス