CDockablePane::AttachToTabWnd

發行項
02/28/2013

附加目前窗格加入至目標窗格，會建立索引窗格。

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

參數

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 ，並終結目前窗格。因此，請注意，當您呼叫時，這個方法，因為對目前窗格的指標可能是無效的，則當方法傳回時。