CDockablePane::AttachToTabWnd

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

現在のペインを対象のペインに関連付け、タブ付きペインを作成します。

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 に移動され、現在のペインは破棄されます。したがって、メソッドから制御が戻ると、現在のペインへのポインタが無効になる可能性があるため、このメソッドを呼び出す場合は十分な注意が必要です。