CDockablePane::AttachToTabWnd

项目
03/01/2013

附加当前窗格到目标窗格中，创建一个选项卡式窗格。

virtual CDockablePane* AttachToTabWnd( 
    CDockablePane* pTabControlBarAttachTo,
    AFX_DOCK_METHOD dockMethod,
    BOOL bSetActive = TRUE,
    CDockablePane** ppTabbedControlBar = NULL
);

参数

[in] [out] pTabControlBarAttachTo
指定当前窗格附加的目标窗格。目标窗格必须是一个可停靠窗格。
[in] dockMethod
指定停靠方法。
[in] bSetActive
激活选项卡式窗格中TRUE 在附加操作后;否则，FALSE。
[out] ppTabbedControlBar
包含该选项卡式窗格从附加操作的结果。

返回值

对当前窗格的指针，因此，如果它不是一个选项卡式窗格;否则该选项卡式窗格的指针产生附加操作。返回值是 NULL，如果当前窗格无法附加，或者，如果错误。

备注

使用此方法时，一个停靠窗格附加到另一个窗格，会发生以下情况:

框架检查目标窗格 pTabControlBarAttachTo 是否为正常停靠窗格，或者从 CBaseTabbedPane派生。
如果目标窗格是一个选项卡式窗格，框架将当前窗格。它作为选项。
如果目标窗格为普通停靠窗格，结构创建一个选项卡式窗格。
- 框架调用 pTabControlBarAttachTo->CreateTabbedPane。新的选项卡式窗格的样式取决于 m_pTabbedControlBarRTC 成员。默认情况下，此成员设置为 CTabbedPane运行时选件类。如果通过 AFX_CBRS_OUTLOOK_TABS 样式作为 dwTabbedStyle 参数传递给 CDockablePane::Create 方法时，运行时选件类对象设置为 CMFCOutlookBar运行时选件类。可以在+任何+时间更改此成员将新的窗格的样式。
- 当此方法创建一个选项卡式窗格时，框架替换指向 pTabControlBarAttachTo (如果窗格是停靠或是浮动在一个多的袖珍框架窗口)将指向新的选项卡式窗格。
- 框架添加 pTabControlBarAttachTo 窗格。选项卡式窗格中，第一个选项。框架然后将当前窗格作为第二个选项。
如果当前窗格 CBaseTabbedPane从派生，其所有选项移到 pTabControlBarAttachTo，并销毁当前窗格。因此，小心，当调用此方法时，中，由于对当前窗格的指针可能无效，当方法返回时。