CDockablePane::AttachToTabWnd

Articolo
03/05/2013

Connette il riquadro corrente a un riquadro di destinazione, creando un riquadro a schede.

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

Parametri

[in] [out] pTabControlBarAttachTo
Specifica il riquadro di destinazione in cui il riquadro corrente viene connesso.Il riquadro di destinazione deve essere un riquadro ancorabile.
[in] dockMethod
Specifica il metodo di ancoraggio.
[in] bSetActive
TRUE per attivare il riquadro a schede dopo l'operazione di connessione, in caso contrario, FALSE.
[out] ppTabbedControlBar
Contiene il riquadro a schede risultante da un'operazione di connessione.

Valore restituito

Un puntatore al riquadro corrente, se non è un riquadro a schede; in caso contrario un puntatore al riquadro a schede che deriva dall'operazione di connessione.Il valore restituito è NULL se il riquadro corrente non può essere collegato, o se si verifica un errore.

Note

Quando si connette di un riquadro ancorabile a un altro riquadro utilizzando questo metodo, nell'viene generato:

I controlli del framework se il riquadro di destinazione pTabControlBarAttachTo è un riquadro ancorato normale o se è derivato da CBaseTabbedPane.
Se il riquadro di destinazione è un riquadro a schede, il framework aggiunge il riquadro corrente sulla scheda.
Se il riquadro di destinazione è un riquadro ancorato normale, il framework crea un riquadro a schede.
- Il framework chiama pTabControlBarAttachTo->CreateTabbedPane.Lo stile di nuovo riquadro a schede dipende dal membro m_pTabbedControlBarRTC.Per impostazione predefinita, questo membro viene impostato sulla classe di runtime CTabbedPane.Se si passa lo stile AFX_CBRS_OUTLOOK_TABS come parametro dwTabbedStyle al metodo CDockablePane::Create, l'oggetto della classe di runtime viene impostato sulla classe di runtime CMFCOutlookBar.È possibile modificare questo membro in qualsiasi momento per modificare lo stile di nuovo riquadro.
- Quando questo metodo crea un riquadro a schede, il framework sostituisce il puntatore a pTabControlBarAttachTo (se il riquadro è ancorato o float in una finestra cornice più) con un puntatore al nuovo riquadro a schede.
- Il framework aggiunge il riquadro pTabControlBarAttachTo il riquadro a schede come prima scheda.Il framework e aggiunge il riquadro corrente come seconda scheda.
Se il riquadro corrente è derivato da CBaseTabbedPane, tutte le schede vengono spostate in pTabControlBarAttachTo e il riquadro corrente viene eliminato.Di conseguenza, prestare attenzione quando si chiama questo metodo, poiché un puntatore al riquadro corrente può non essere valido quando il metodo restituisce.