CDockablePane::AttachToTabWnd

Artigo
06/10/2015

Anexa o painel atual para um painel de destino, criando um painel com guias.

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

Parâmetros

[in] [out] pTabControlBarAttachTo
Especifica o painel de destino para que o painel atual anexa. O painel de destino deve ser um painel encaixável.
[in] dockMethod
Especifica o método de encaixe.
[in] bSetActive
TRUE para ativar o painel com guias após a operação de anexo; caso contrário, FALSE.
[out] ppTabbedControlBar
Contém o painel com guias o resultado da operação de anexo.

Valor de retorno

Um ponteiro para o painel atual, se não é um painel com guias; se não um ponteiro para o painel com guias que resulta da operação de anexo. O valor de retorno é NULL se o painel atual não pode ser anexado, ou se ocorrer um erro.

Comentários

Quando um painel encaixável anexa a outro painel usando esse método, ocorre o seguinte:

A estrutura verifica se o painel pTabControlBarAttachTo de destino é um painel de encaixe normal ou se é derivado de CBaseTabbedPane.
Se o painel de destino é um painel com guias, a estrutura adiciona o painel atual como um guia.
Se o painel de destino é um painel normal de encaixe, a estrutura cria um painel com guias.
- a estrutura chama pTabControlBarAttachTo->CreateTabbedPane. O estilo do novo painel com guias depende do membro de m_pTabbedControlBarRTC . Por padrão, esse membro é definida como a classe em tempo de execução de CTabbedPane. Se você passar o estilo de AFX_CBRS_OUTLOOK_TABS como o parâmetro de dwTabbedStyle para o método de CDockablePane::Create , o objeto da classe de tempo de execução é definido como uma classe de tempo de execução de CMFCOutlookBar. Você pode alterar esse membro a qualquer momento para alterar o estilo do novo painel.
- Quando esse método cria um painel com guias, a estrutura substitui o ponteiro para pTabControlBarAttachTo (se o painel é conectado ou flutuante em uma janela miniframe multi -) com um ponteiro para o novo painel com guias.
- A estrutura adiciona o painel de pTabControlBarAttachTo para o painel com guias como o primeiro guia. A estrutura então adiciona o painel atual como um segundo guia.
Se o painel atual é derivado de CBaseTabbedPane, todos os guias são movidos para pTabControlBarAttachTo e o painel atual é destruído. Portanto, tenha cuidado quando você chamar esse método, como um ponteiro para o painel atual pode ser válido quando o método retorna.