Classe de CMFCBaseTabCtrl

Artigo
02/25/2013

Implementa a funcionalidade básica para o windows com guias.

class CMFCBaseTabCtrl : public CWnd

Membros

Métodos públicos

Nome	Descrição
CMFCBaseTabCtrl::AddIcon
CMFCBaseTabCtrl::AddTab	Adiciona um novo à guia janela com guias.
CMFCBaseTabCtrl::ApplyRestoredTabInfo
CMFCBaseTabCtrl::AutoDestroyWindow
CMFCBaseTabCtrl::CalcRectEdit
CMFCBaseTabCtrl::CleanUp
CMFCBaseTabCtrl::ClearImageList
CMFCBaseTabCtrl::DetachTab	Dispara um guia de uma janela com guias.
CMFCBaseTabCtrl::EnableActivateLastActive
CMFCBaseTabCtrl::EnableAutoColor	Habilita ou desabilita coloração automática de tabulação.
CMFCBaseTabCtrl::EnableCustomToolTips	Habilita ou desabilita dicas de ferramentas personalizadas para guias.
CMFCBaseTabCtrl::EnableInPlaceEdit	Habilita ou desativa verificação as oferece suporte a edição de rótulos de tabulação.
CMFCBaseTabCtrl::EnableTabDetach	Permite que destacáveis guias.
CMFCBaseTabCtrl::EnableTabSwap	Habilita ou desabilita se o usuário pode alterar a ordem de tabulação usando mouse.
CMFCBaseTabCtrl::EnsureVisible	Rola as guias até que a especificado está visível.Este método não tem efeito se a guia especificado já é visível.
CMFCBaseTabCtrl::EnterDragMode
CMFCBaseTabCtrl::FindTargetWnd	Retorna um painel que contém um ponto específico.
CMFCBaseTabCtrl::FireChangeActiveTab
CMFCBaseTabCtrl::FireChangingActiveTab
CMFCBaseTabCtrl::GetActiveTab	Retorna o índice de tabulação ativo.
CMFCBaseTabCtrl::GetActiveTabColor	Retorna a cor do plano de fundo da guia ativo.
CMFCBaseTabCtrl::GetActiveTabTextColor	Retorna a cor do texto da guia ativo.
CMFCBaseTabCtrl::GetActiveWnd	Retorna um ponteiro a página ativa do controle de guia.
CMFCBaseTabCtrl::GetAutoColors	Retorna uma referência para a matriz de cores que são usadas para coloração automático.
CMFCBaseTabCtrl::GetFirstVisibleTab	Retorna um ponteiro para o primeiro guia visível.
CMFCBaseTabCtrl::GetFirstVisibleTabNum
CMFCBaseTabCtrl::GetHighlightedTab	Retorna o índice de tabulação atualmente realçado.
CMFCBaseTabCtrl::GetImageList
CMFCBaseTabCtrl::GetImageSize
CMFCBaseTabCtrl::GetLastVisibleTab
CMFCBaseTabCtrl::GetLocation	Retorna uma variável do tipo de dados de LOCAL indicando onde a área de guia é posicionado em relação ao controle de guia.Por exemplo, na parte superior ou inferior.
CMFCBaseTabCtrl::GetMaxWindowSize
CMFCBaseTabCtrl::GetTabArea	Retorna o tamanho e a posição da área da guia na janela com guias.A posição da área de guia é definida usando coordenadas.
CMFCBaseTabCtrl::GetTabBkColor	Retorna a cor do plano de fundo da guia especificada.
CMFCBaseTabCtrl::GetTabBorderSize	Retorna o tamanho das bordas da guia no controle de guias.
CMFCBaseTabCtrl::GetTabByID	Retorna o índice de tabulação que é identificado por um certo ID
CMFCBaseTabCtrl::GetTabCloseButton
CMFCBaseTabCtrl::GetTabFromHwnd	Retorna o índice de tabulação que contém um objeto especificado de HWND.
CMFCBaseTabCtrl::GetTabFromPoint	Retorna a guia que contém um ponto específico.
CMFCBaseTabCtrl::GetTabFullWidth
CMFCBaseTabCtrl::GetTabHicon	Retorna o ícone associado com o guia especificada.
CMFCBaseTabCtrl::GetTabID	Retorna a identificação de um guia usando o índice de tabulação.
CMFCBaseTabCtrl::GetTabIcon	Retorna a identificação do ícone para um guia especificada.
CMFCBaseTabCtrl::GetTabLabel	Retorna o texto de um guia especificada.
CMFCBaseTabCtrl::GetTabRect	Retorna o tamanho e a posição de um guia especificada.
CMFCBaseTabCtrl::GetTabsHeight
CMFCBaseTabCtrl::GetTabsRect
CMFCBaseTabCtrl::GetTabTextColor	Retorna a cor do texto de um guia especificada.
CMFCBaseTabCtrl::GetTabWnd	Retorna o ponteiro para um painel que reside em um página da guia especificada.
CMFCBaseTabCtrl::GetTabWndNoWrapper	Retorna o ponteiro direto a um controle que reside em um página da guia especificada, mesmo se o controle tem um wrapper.
CMFCBaseTabCtrl::GetTabsNum	Retorna o número de guias que estão contidos no controle de guias.
CMFCBaseTabCtrl::GetToolTipCtrl	Retorna uma referência ao controle de dica associado ao objeto de CMFCBaseTabCtrl .
CMFCBaseTabCtrl::GetVisibleTabsNum	Retorna o número de guias visíveis.
CMFCBaseTabCtrl::HasImage
CMFCBaseTabCtrl::HideSingleTab	Define uma opção que oculta uma guia da janela, mas somente se a janela exibe um com guias visível forte um guia.
CMFCBaseTabCtrl::InsertTab	Insere uma nova guia.
CMFCBaseTabCtrl::InvalidateTab
CMFCBaseTabCtrl::IsActiveTabCloseButton
CMFCBaseTabCtrl::IsAutoColor	Retorna um valor que indica se uma janela com guias estiver no modo de automático- cor.
CMFCBaseTabCtrl::IsAutoDestroyWindow
CMFCBaseTabCtrl::IsColored
CMFCBaseTabCtrl::IsDialogControl
CMFCBaseTabCtrl::IsDrawNoPrefix
CMFCBaseTabCtrl::IsFlatFrame	Retorna um valor que indica se o quadro para a área de guia é suave ou 3D.
CMFCBaseTabCtrl::IsFlatTab
CMFCBaseTabCtrl::IsHideSingleTab	Retorna um valor que indica se o controle de guia é configurado para ocultar uma guia, mas somente se uma janela com guias tem apenas um guia visível.
CMFCBaseTabCtrl::IsIconAdded
CMFCBaseTabCtrl::IsInPlaceEdit	Indica se os usuários podem modificar a um rótulo na guia.
CMFCBaseTabCtrl::IsLeftRightRounded
CMFCBaseTabCtrl::IsMDITab
CMFCBaseTabCtrl::IsOneNoteStyle	Indica se uma janela com guias exibe snaplines no estilo da Microsoft OneNote.
CMFCBaseTabCtrl::IsPtInTabArea	Verifica se um ponto especificado existe na área de tabulação.
CMFCBaseTabCtrl::IsTabCloseButtonHighlighted
CMFCBaseTabCtrl::IsTabCloseButtonPressed
CMFCBaseTabCtrl::IsTabDetachable	Indica se uma guia ser destacável.
CMFCBaseTabCtrl::IsTabIconOnly	Indica se ícones mas não rótulos de exibição de guias.
CMFCBaseTabCtrl::IsTabSwapEnabled	Indica se o usuário pode alterar posições de guia arrastando guias.
CMFCBaseTabCtrl::IsTabVisible	Indica se um guia especificada é visível.
CMFCBaseTabCtrl::IsVS2005Style
CMFCBaseTabCtrl::MoveTab
CMFCBaseTabCtrl::OnChangeTabs	Chamado pela estrutura quando o número de guias alterar.
CMFCBaseTabCtrl::OnDragEnter
CMFCBaseTabCtrl::OnDragLeave
CMFCBaseTabCtrl::OnDragOver
CMFCBaseTabCtrl::OnDrop
CMFCBaseTabCtrl::OnRenameTab
CMFCBaseTabCtrl::PreTranslateMessage	Usado pela classe CWinApp transladar mensagens de janela antes que são distribuídos funções do windows de TranslateMessage e de DispatchMessage .Overrides ( CWnd::PreTranslateMessage.)
CMFCBaseTabCtrl::RecalcLayout	Recalcula o layout interno de uma janela com guias.
CMFCBaseTabCtrl::RemoveAllTabs	Remove todos os guias de janela com guias.
CMFCBaseTabCtrl::RemoveTab	Remove um guia de uma janela com guias.
CMFCBaseTabCtrl::RenameTab
CMFCBaseTabCtrl::ResetImageList	Reinicializa a lista de imagem que está conectado a uma janela com guias.
CMFCBaseTabCtrl::Serialize	Leitura ou grava este objeto ou um arquivo neutro.Overrides ( CObject::Serialize.)
CMFCBaseTabCtrl::SetActiveTab	Ativa um guia.
CMFCBaseTabCtrl::SetActiveTabColor	Define a cor do plano de fundo para a guia ativa no momento.
CMFCBaseTabCtrl::SetActiveTabTextColor	Define a cor do texto para guias ativos.
CMFCBaseTabCtrl::SetAutoColors	Defina as cores de controle de guias que são aplicadas no modo automático de cor.
CMFCBaseTabCtrl::SetDockingBarWrapperRTC	Define a classe envoltório que é usada para todos os objetos que não são derivados de Classe de CDockablePane.
CMFCBaseTabCtrl::SetDrawNoPrefix	Ativar e desativar o processamento de caracteres de prefixo quando os rótulos da guia são desenhadas.
CMFCBaseTabCtrl::SetImageList	Define a lista de imagem ícone.
CMFCBaseTabCtrl::SetLocation
CMFCBaseTabCtrl::SetTabBkColor	Define a cor do plano de fundo para um guia especificada.
CMFCBaseTabCtrl::SetTabBorderSize	Define um novo tamanho da borda da guia.
CMFCBaseTabCtrl::SetTabHicon	Define um ícone na guia.
CMFCBaseTabCtrl::SetTabIcon	Define um ID de item de guia
CMFCBaseTabCtrl::SetTabIconOnly	Ativa e desativa o modo somente para um ícone” guia especificada.
CMFCBaseTabCtrl::SetTabLabel	Define um rótulo da guia igual a um valor de cadeia de caracteres especificado.
CMFCBaseTabCtrl::SetTabsHeight
CMFCBaseTabCtrl::SetTabTextColor	Define a cor do texto para um guia especificada.
CMFCBaseTabCtrl::SetTabsOrder	Organiza guias na ordem especificada.
CMFCBaseTabCtrl::ShowTab	Mostra ou oculta a guia especificado.
CMFCBaseTabCtrl::StartRenameTab
CMFCBaseTabCtrl::SwapTabs

Métodos protegidos

Nome	Descrição
CMFCBaseTabCtrl::CreateWrapper	Cria um wrapper para um objeto derivado de CWnd que não é derivado de CDockablePane.Para inserir um objeto de CMFCBaseTabCtrl , cada controle inserido deve ter um wrapper de encaixe ou ser derivado de CDockablePane. Você define a classe envoltório usando SetDockingBayWrapperRTC.

CMFCBaseTabCtrl::CreateWrapper

Cria um wrapper para um objeto derivado de CWnd que não é derivado de CDockablePane.Para inserir um objeto de CMFCBaseTabCtrl , cada controle inserido deve ter um wrapper de encaixe ou ser derivado de CDockablePane.

Você define a classe envoltório usando SetDockingBayWrapperRTC.

Membros de dados

Nome	Descrição
CMFCBaseTabCtrl::m_bActivateTabOnRightClick	Especifica se os guias estão selecionados usando um clique do mouse esquerdo ou um clique do mouse direito.
CMFCBaseTabCtrl::m_bAutoDestroyWindow	Especifica se os painéis que estão contidos em guias estão destruídos automaticamente.

Comentários

a classe de CMFCBaseTabCtrl é uma classe abstrata.Portanto, não pode ser instanciada.Para criar uma janela com guias, você deve derivar uma classe de CMFCBaseTabCtrl.A biblioteca MFC contém alguns exemplos de classes derivadas, dois dos quais são Classe de CMFCTabCtrl e Classe de CMFCOutlookBarTabCtrl.

Dicas de personalização

As dicas a seguir são pertinentes a Classe de CMFCBaseTabCtrl e as classes que herdarem de ele:

Se você ativar tabulações destacáveis, não mantenha ponteiros para o windows com guias.Essas guias destacáveis podem ser criados dinamicamente e destruído.Portanto, os ponteiros podem ficar inválidos.
Você pode configurar o controle da guia para que os usuários podem mover guias dinamicamente em um controle de guia usando o mouse.Essa funcionalidade é criada na classe de CMFCBaseTabCtrl .Para ativá-lo, chame CMFCBaseTabCtrl::EnableTabSwap.
Por padrão, as guias são os destacáveis quando você adiciona a um controle de guia.Você também pode adicionar guias não destacáveis usando CMFCBaseTabCtrl::AddTab.Se você definir o parâmetro bDetachable a FALSE, a guia não será destacável.Você também pode escolher se as guias são destacáveis chamando o método CMFCBaseTabCtrl::EnableTabDetach.
Os objetos são derivados de CWnd Class podem ser colocados em uma barra de encaixável controle ou em uma guia encaixável.Para que o controle inteiro é conectado, você deve fazer o objeto de CWnd encaixável.Para fazer isso, o MFC usa uma classe envoltório.Esta classe envoltório é Classe de CDockablePaneAdapter.Todos os objetos de CWnd que são adicionados a uma barra de controle encaixável ou um guia encaixável serão envolvidos em um objeto de CDockablePaneAdapter .Você pode desativar a caixa automática definindo o parâmetro m_bEnableWrapping do seu objeto de CMFCBaseTablCtrl a FALSE.Você também pode modificar a classe que o aplicativo usará como um wrapper usando o método CMFCBaseTabCtrl::SetDockingBarWrapperRTC.