CDockablePane::AttachToTabWnd
現在のペインを対象のペインに関連付け、タブ付きペインを作成します。
virtual CDockablePane* AttachToTabWnd(
CDockablePane* pTabControlBarAttachTo,
AFX_DOCK_METHOD dockMethod,
BOOL bSetActive = TRUE,
CDockablePane** ppTabbedControlBar = NULL
);
パラメーター
[入力、出力] pTabControlBarAttachTo
現在のペインが関連付けられるペインを指定します。対象のペインはドッキングできるペインである必要があります。[入力] dockMethod
ドッキング方法を指定します。[入力] bSetActive
関連付け操作の後にタブ付きペインをアクティブにする場合は TRUE。それ以外の場合は FALSE。[出力] ppTabbedControlBar
関連付け操作によって作成されたタブ付きペインを格納します。
戻り値
現在のペインがタブ付きペインではない場合は、ペインへのポインター。それ以外の場合は、関連付け操作によって作成されたタブ付きペインへのポインター。現在のペインを関連付けられない場合、またはエラーが発生した場合、戻り値は NULL です。
解説
このメソッドを使用してドッキングできるペインを別のペインに関連付けると、次の処理が行われます。
フレームワークは、対象のペインの pTabControlBarAttachTo が標準のドッキング ペインであるか、または CBaseTabbedPane から派生しているかをチェックします。
対象のペインがタブ付きペインの場合、フレームワークは現在のペインをタブとして対象のペインに追加します。
対象のペインが標準のドッキング ペインの場合、フレームワークはタブ付きペインを作成します。
フレームワークは pTabControlBarAttachTo->CreateTabbedPane を呼び出します。新しいタブ付きペインのスタイルは、m_pTabbedControlBarRTC メンバーによって異なります。既定では、このメンバーは CTabbedPane のランタイム クラスに設定されます。AFX_CBRS_OUTLOOK_TABS スタイルを dwTabbedStyle パラメーターとして CDockablePane::Create メソッドに渡すと、ランタイム クラス オブジェクトは CMFCOutlookBar のランタイム クラスに設定されます。このメンバーをいつでも変更して、新しいペインのスタイルを変更できます。
このメソッドがタブ付きペインを作成すると、フレームワークは pTabControlBarAttachTo へのポインター (ペインがマルチミニフレーム ウィンドウでドッキングまたはフローティング状態の場合) を、新しいタブ付きペインへのポインターに置き換えます。
フレームワークは、pTabControlBarAttachTo ペインを最初のタブとしてタブ付きペインに追加します。次に、現在のペインを 2 番目のタブとして追加します。
現在のペインが CBaseTabbedPane から派生する場合、そのタブはすべて pTabControlBarAttachTo に移動され、現在のペインは破棄されます。したがって、メソッドから制御が戻ると、現在のペインへのポインターが無効になる可能性があるため、このメソッドを呼び出す場合は十分な注意が必要です。
ドッキング レイアウトを作成するときにペインを別のペインに関連付ける場合は、dockMethod を DM_SHOW に設定します。
別のペインを関連付ける前に、最初のペインをドッキングする必要があります。
必要条件
ヘッダー : afxDockablePane.h