CDockablePane::AttachToTabWnd
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.
Se você anexar um painel para outro durante a criação de um layout de encaixe, conjunto dockMethod para DM_SHOW.
Você deve encaixar o painel primeiro antes de anexar outro painel a ele.
Requisitos
Cabeçalho: afxDockablePane.h