CDockablePane::AttachToTabWnd

Artículo
04/10/2013

Asocia el panel actual en un panel de destino, creando un panel con fichas.

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

Parámetros

[in] [out] pTabControlBarAttachTo
Especifica el panel de destino al que el panel actual asociado.El panel de destino debe ser un panel acoplable.
[in] dockMethod
Especifica el método de acoplamiento.
[in] bSetActive
TRUE para generar el panel con fichas después de la operación de asociar; si no, FALSE.
[out] ppTabbedControlBar
Contiene el panel con fichas que es el resultado de la operación de asociar.

Valor devuelto

Un puntero al panel actual, si no es un panel con fichas; si no es un puntero al panel con fichas que resulta de la operación de asociar.El valor devuelto es NULL si el panel actual no puede asociarse, o si se produce un error.

Comentarios

Cuando un panel acoplable asócielos a otro panel utilizando este método, aparece lo siguiente:

El marco comprueba si el panel pTabControlBarAttachTo de destino es un panel regular de acoplamiento o si es derivado de CBaseTabbedPane.
Si el panel de destino es un panel con fichas, el marco agrega el panel actual a como una ficha.
Si el panel de destino es un panel regular de acoplamiento, el marco de trabajo crea un panel con fichas.
- El marco de trabajo llama a pTabControlBarAttachTo->CreateTabbedPane.El estilo de nuevo panel con fichas depende del miembro de m_pTabbedControlBarRTC .De forma predeterminada, establezca este miembro a la clase en tiempo de ejecución de CTabbedPane.Si pasa el estilo de AFX_CBRS_OUTLOOK_TABS como parámetro de dwTabbedStyle al método de CDockablePane::Create , el objeto de la clase en tiempo de ejecución se establece en la clase en tiempo de ejecución de CMFCOutlookBar.Puede cambiar este miembro en cualquier momento para cambiar el estilo de nuevo panel.
- Cuando este método crea un panel con fichas, el marco reemplaza el puntero a pTabControlBarAttachTo (si el panel estará acoplado o flotante en una ventana multi-miniframe) con un puntero al nuevo panel con fichas.
- El marco agrega el panel de pTabControlBarAttachTo el panel con fichas como la primera pestaña.El marco se agrega el panel actual como segunda ficha.
Si el panel actual es derivado de CBaseTabbedPane, todas las pestañas se mueven a pTabControlBarAttachTo y se destruye el panel actual.Por consiguiente, tenga cuidado cuando se llama a este método, porque un puntero al panel actual puede ser válido cuando el método devuelve.