CDockablePane::AttachToTabWnd

Artigo
08/25/2010

Anexa o painel corrente em 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 que anexa o painel corrente.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 anexar; caso contrário, FALSE.
[out] ppTabbedControlBar
Contém o painel com guias que resultados da operação de anexar.

Valor de retorno

Um ponteiro para o painel corrente se não for um painel com guias; caso contrário, um ponteiro para o painel com guias que resultados da operação de anexar.O valor retornado é NULL Se o painel corrente não pode ser anexado ou se ocorrer um erro.

Comentários

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

As verificações de estrutura se o painel de destino pTabControlBarAttachTo é uma expressão de encaixe painel ou se ele é derivado de CBaseTabbedPane.
Se o painel de destino é um painel com guias, a estrutura adicionará o painel corrente a ele sistema autônomo uma guia.
Se o painel de destino é um painel de encaixe regular, a estrutura cria um painel com guias.
- A estrutura chama pTabControlBarAttachTo->CreateTabbedPane. O estilo do novo painel com guias depende do m_pTabbedControlBarRTC membro. Por padrão, esse membro é conjunto à classe em tempo de execução de CTabbedPane.Se você passar o AFX_CBRS_OUTLOOK_TABS o estilo sistema autônomo o dwTabbedStyle parâmetro para o CDockablePane::criar método, o objeto de classe em tempo de execução é definido sistema autônomo a classe em tempo de execução do CMFCOutlookBar.Você pode alterar esse membro em qualquer time para alterar o estilo do painel de novo.
- Quando esse método cria um painel com guias, a estrutura substitui o ponteiro para pTabControlBarAttachTo (se o painel é encaixado ou flutuante em uma janela de multi-miniframe) com um ponteiro para o novo painel com guias.
- A estrutura adiciona o pTabControlBarAttachTo painel para o painel com guias sistema autônomo a primeira guia. A estrutura, em seguida, adiciona o painel corrente sistema autônomo uma segunda guia.
Se o painel corrente é derivado de CBaseTabbedPane, todas as suas guias são movidas para pTabControlBarAttachTo e o painel corrente é destruído. Portanto, tenha cuidado ao chamar esse método, porque um ponteiro para o painel corrente pode ser inválido quando o método retorna.