CDockablePane::AttachToTabWnd

Artikel
02/26/2013

Fügt den aktuellen Bereich zu einem Zielbereich an und erstellt eine Seite im Registerformat.

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

Parameter

[in] [out] pTabControlBarAttachTo
Gibt den Zielbereich an, dem der aktuelle Bereich zu angefügt werden.Der Zielbereich muss ein andockbares Fenster sein.
[in] dockMethod
Gibt die andockbare Methode an.
[in] bSetActive
TRUE, um die Seite im Registerformat nach dem Anfügevorgang zu ermöglichen; andernfalls FALSE.
[out] ppTabbedControlBar
Enthält die Seite im Registerformat, die vom Anfügevorgang entsteht.

Rückgabewert

Ein Zeiger auf den aktuellen Bereich, wenn keine Seite im Registerformat ist; andernfalls ein Zeiger zur Seite im Registerformat, die vom Anfügevorgang entsteht.Der Rückgabewert ist NULL, wenn der aktuelle Bereich nicht angefügt werden kann oder wenn ein Fehler auftritt.

Hinweise

Wenn die fügt eines andockbaren Fensters zu einem anderen Bereich mithilfe dieser Methode, Folgendes auftritt:

Die Frameworküberprüfungen, ob der Zielbereich pTabControlBarAttachTo ein regulärer Andocker Bereich ist, oder wenn es von CBaseTabbedPane abgeleitet wird.
Wenn der Zielbereich eine Seite im Registerformat ist, fügt das Framework den aktuellen Bereich ihm als Registerkarte hinzu.
Wenn der Zielbereich ein regulärer Andocker Bereich ist, stellt das Framework eine Seite im Registerformat erstellt.
- Das Framework ruft pTabControlBarAttachTo->CreateTabbedPane auf.Das Format der neuen Seite im Registerformat hängt vom m_pTabbedControlBarRTC-Member aus.Standardmäßig wird dieser Member zur Laufzeitklasse von CTabbedPane festgelegt.Wenn Sie das AFX_CBRS_OUTLOOK_TABS Stils als dwTabbedStyleCDockablePane::Create-Parameter an die Methode übergeben, wird das Ablaufklassenobjekt zur Laufzeitklasse von CMFCOutlookBar festgelegt.Sie können diesen Member jederzeit ändern, um das Format des neuen Bereichs zu ändern.
- Wenn diese Methode eine Seite im Registerformat erstellt wird, ersetzt das Framework den Zeiger auf pTabControlBarAttachTo (wenn der Bereich angedockt oder unverankert ist in ein MULTIMinirahmen Fenster), mit einem Zeiger auf die neue Seite im Registerformat.
- Das Framework fügt den pTabControlBarAttachTo Bereich der Seite im Registerformat als erste Registerkarte hinzu.Das Framework fügt dann den aktuellen Bereich als zweite Registerkarte hinzu.
Wenn der aktuelle Bereich von CBaseTabbedPane abgeleitet ist, sind alle Registerkarten auf pTabControlBarAttachTo verschoben und der aktuelle Bereich zerstört wird.Daher legen Sie vorsichtig, wenn Sie diese Methode aufrufen, da ein Zeiger auf den aktuellen Bereich möglicherweise ungültig ist, wenn die Methode zurückgibt.