Classe de CMFCTabCtrl

Artigo
02/25/2013

A classe de CMFCTabCtrl fornece funcionalidade para um controle de guia.O controle de guia exibe uma janela encaixável com as guias lisos ou tridimensionais na parte superior ou inferior.As guias podem exibir texto e uma imagem e podem modificar a cor quando ativos.

class CMFCTabCtrl : public CMFCBaseTabCtrl

Membros

Construtores public

Nome	Descrição
CMFCTabCtrl::CMFCTabCtrl	Construtor padrão.
CMFCTabCtrl::~CMFCTabCtrl	Destruidor.

Métodos públicos

Nome	Descrição
CMFCTabCtrl::ActivateMDITab	Exibe a guia especificada a guia atual do controle e defina o foco em essa guia.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow	Especifica se a estrutura é redimensionar a área cliente de todas as janelas de controle de tabulação quando um elemento de interface de usuário de alterações de controle de guia.
CMFCTabCtrl::CalcRectEdit	Desinfla o tamanho da área especificada na guia.Overrides ( CMFCBaseTabCtrl::CalcRectEdit.)
CMFCTabCtrl::Create	Cria o controle da guia e anexá-la ao objeto de CMFCTabCtrl .
CMFCTabCtrl::CreateObject	Usado pela estrutura dinâmica para criar uma instância de esse tipo da classe.
CMFCTabCtrl::EnableActiveTabCloseButton	Mostra ou oculta um botão fechar (X) na guia.
CMFCTabCtrl::EnableInPlaceEdit	Habilita ou desabilita rótulos editáveis de tabulação.Overrides ( CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu	Substitui dois botões que rolam os guias de janela com um botão que abre um menu do windows com guias.
CMFCTabCtrl::EnsureVisible	Garante que um guia é visível.
CMFCTabCtrl::GetDocumentIcon	Recupera o símbolo que está associado com uma guia em um menu pop-up do windows com guias.
CMFCTabCtrl::GetFirstVisibleTabNum	Retorna o índice do primeiro guia que é visível no controle atual na guia.
CMFCTabCtrl::GetResizeMode	Retorna um valor que especifica como o controle atual da guia pode ser redimensionado.
CMFCTabCtrl::GetScrollBar	Recupera um ponteiro para o objeto de barra de rolagem que está associado com o controle de guias.
CMFCTabCtrl::GetTabArea	Recupera o retângulo delimitador da área de rótulo da guia na parte superior ou inferior do controle de guia.Overrides ( CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint	Recupera a guia que contém um ponto específico.Overrides ( CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth	Obtém a largura máximo de um guia.
CMFCTabCtrl::GetTabsHeight	Recupera a altura da área da guia do controle atual na guia.
CMFCTabCtrl::GetTabsRect	Recupera um retângulo que limite a área da guia do controle atual na guia.Overrides ( CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass	Usado pela estrutura para obter um ponteiro para o objeto de CRuntimeClass que está associado com esse tipo da classe.
CMFCTabCtrl::GetWndArea	Recupera o limite da área cliente do controle atual na guia.
CMFCTabCtrl::HideActiveWindowHorzScrollBar	Oculta a barra de rolagem horizontal, se houver, da janela ativa.
CMFCTabCtrl::HideInactiveWindow	Especifica se a estrutura é exibir janelas inativas de controle de guia.
CMFCTabCtrl::HideNoTabs	Habilita ou desabilita desenhar a área da guia se não houver nenhum guia visível.
CMFCTabCtrl::HideSingleTab	Habilita ou desabilita desenhar um guia quando há uma única janela com guias.Overrides ( CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup	Indica se a guia atual de um controle de guia é a guia ativa em um grupo de guia de interface de documentos múltiplos.
CMFCTabCtrl::IsActiveTabBoldFont	Indica se o texto da guia ativa é exibido usando uma fonte em negrito.
CMFCTabCtrl::IsActiveTabCloseButton	Indica se o botão close (X) é exibido em uma guia ativo ou no canto superior direito da área de tabulação.
CMFCTabCtrl::IsDrawFrame	Indica se a janela desenhar um retângulo com guias do quadro ao redor de painéis inseridos.
CMFCTabCtrl::IsFlatFrame	Indica se o quadro ao redor da área de guia é suave ou 3D.
CMFCTabCtrl::IsFlatTab	Indica se a aparência dos guias no controle atual da guia é suave ou não.
CMFCTabCtrl::IsLeftRightRounded	Indica se a aparência da esquerda e do lado direito de uma guia no controle atual da guia é arredondada.
CMFCTabCtrl::IsMDITabGroup	Indica se o controle atual da guia está contido na área cliente de uma janela de interface de documentos múltiplos.
CMFCTabCtrl::IsOneNoteStyle	Indica se o controle da guia atual é exibido no estilo da Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea	Determina se um ponto está dentro da área de tabulação.Overrides ( CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll	Indica se o controle atual da guia possui uma barra de rolagem que pode rolar suas guias como um grupo.
CMFCTabCtrl::IsTabDocumentsMenu	Indica se o controle de guia exibe botões de rolagem ou um botão que exibe um menu do windows com guias.
CMFCTabCtrl::IsVS2005Style	Indica se as guias são exibidos no estilo Visual studio.net 2005.
CMFCTabCtrl::ModifyTabStyle	Especifica a aparência dos guias no controle atual na guia.
CMFCTabCtrl::MoveTab	Move um guia para outra posição de guia.Overrides ( CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter	Chamado pela estrutura quando o cursor é arrastado primeiro na janela de controle de guia.
CMFCTabCtrl::OnDragOver	Chamado pela estrutura durante uma operação de arrastar quando o mouse é movida sobre a janela de destino alvo.Overrides ( CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu	Exibe um menu pop-up do windows com guias, aguarda até que o usuário selecione um guia, e torna a guia selecionada a guia.
CMFCTabCtrl::PreTranslateMessage	Converte mensagens de janela antes que são distribuídos funções do windows de TranslateMessage e de DispatchMessage .Overrides ( CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout	Recalcula o layout interno do controle de guia.Overrides ( CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup	Define a guia atual de um controle de guias como a guia ativa em um grupo de guia de interface de documentos múltiplos.
CMFCTabCtrl::SetActiveTab	Ativa um guia.Overrides ( CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont	Habilita ou desativa uso de uma fonte em negrito guias ativos.
CMFCTabCtrl::SetDrawFrame	Habilita ou desabilita o retângulo de quadro de drawinga redor uma barra inserido.
CMFCTabCtrl::SetFlatFrame	Especifica se desenhar um plano ou um quadro 3D em torno da área de tabulação.
CMFCTabCtrl::SetImageList	Especifica uma lista de imagem.Overrides ( CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode	Especifica como o controle atual da guia pode ser redimensionado e reexibe o controle.
CMFCTabCtrl::SetTabMaxWidth	Especifica a largura máximo da guia em uma janela com guias.
CMFCTabCtrl::StopResize	Finaliza a atual redimensiona a operação no controle de guias.
CMFCTabCtrl::SwapTabs	Alterna um par de guias.Overrides ( CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar	Desenha uma barra de rolagem horizontal em um controle de guias que exibe snaplines lisos.

Membros de dados

Nome	Descrição
CMFCTabCtrl::m_bEnableActivate	Impede a exibição ativa de foco perder nova guia quando um é inserido e ativado.

Comentários

Suporta da classe de CMFCTabCtrl :

Catalogue os estilos de controle que incluem 3D, simplificam, e simplificam com uma barra de rolagem horizontal compartilhado.
Guias localizados na parte superior ou inferior da janela.
Guias que exibem o texto, imagens, ou texto e imagens.
Guias que alteram a cor quando a guia está ativa.
O tamanho da borda muda para ajustáveis guias.
O windows com guias destacáveis.

A classe de CMFCTabCtrl pode ser usada com uma caixa de diálogo, mas é destinada para aplicativos que usam o encaixe de barras de controle como Microsoft Excel e Visual Studio.Para mais informações, consulte Classe de CDockablePane.

Siga estas etapas para adicionar um redimensionável, inserindo o controle de guias em seu aplicativo:

Crie uma instância de Classe de CTabbedPane.
Chame CDockablePane::Create.
Use CBaseTabbedPane::AddTab ou CMFCBaseTabCtrl::InsertTab para adicionar novas guias.
Chame CBasePane::EnableDocking de modo que o controle atual da guia de encaixe possa inserir na janela do quadro chave.
Chame CFrameWndEx::DockPane para inserir a janela com guias no quadro chave.

Para um exemplo de como criar uma janela com guias como uma barra de controle de encaixe, consulte Classe de CTabbedPane.Para usar CMFCTabCtrl como um controle que não são de encaixe, crie um objeto de CMFCTabCtrl e então chame CMFCTabCtrl::Create.

Hierarquia de herança

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe de CMFCTabCtrl para configurar um objeto de CMFCTabCtrl .O exemplo explica como adicionar um a guia, mostrar o botão fechar na guia ativa, active rótulos editáveis na guia, e exibir um menu pop-up de rótulos de janela com guias.Este exemplo é parte de Exemplo da coleção de estado.

    CMFCTabCtrl m_wndTabs;


...


    // Attach list windows to tab:
    // CListCtrl m_wndList1
    // CListCtrl m_wndList2
    // CListCtrl m_wndList3
    m_wndTabs.AddTab (&m_wndList1, _T("Output 1"), (UINT)-1);
    m_wndTabs.AddTab (&m_wndList2, _T("Output 2"), (UINT)-1);
    m_wndTabs.AddTab (&m_wndList3, _T("Output 3"), (UINT)-1);

    m_wndTabs.EnableActiveTabCloseButton();
    m_wndTabs.EnableInPlaceEdit(true);
    m_wndTabs.EnableTabDocumentsMenu();
    m_wndTabs.SetActiveTab(1);
    m_wndTabs.SetDrawFrame();
    m_wndTabs.SetFlatFrame();