Classe `CMFCTabCtrl`

Artigo
10/12/2023

A classe CMFCTabCtrl fornece funcionalidade para um controle guia. O controle guia exibe uma janela encaixada com guias simples ou tridimensionais na parte superior ou inferior. As guias podem exibir texto e uma imagem e podem alterar a cor quando ativas.

Sintaxe

class CMFCTabCtrl : public CMFCBaseTabCtrl

Membros

Construtores públicos

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

Métodos públicos

Nome	Descrição
`CMFCTabCtrl::ActivateMDITab`	Exibe a guia especificada do controle de guia atual e define o foco nessa guia.
`CMFCTabCtrl::AllowDestroyEmptyTabbedPane`
`CMFCTabCtrl::AutoSizeWindow`	Especifica se a estrutura deve redimensionar a área do cliente de todas as janelas de controle guia quando um elemento de interface do usuário do controle guia for alterado.
`CMFCTabCtrl::CalcRectEdit`	Compacta o tamanho da área da guia especificada. (Substitui `CMFCBaseTabCtrl::CalcRectEdit`).
`CMFCTabCtrl::Create`	Cria o controle da guia e o anexa ao objeto `CMFCTabCtrl`.
`CMFCTabCtrl::CreateObject`	Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
`CMFCTabCtrl::EnableActiveTabCloseButton`	Exibe ou oculta o botão Fechar ( X) na guia ativa.
`CMFCTabCtrl::EnableInPlaceEdit`	Habilita ou desabilita rótulos de guia editáveis. (Substitui `CMFCBaseTabCtrl::EnableInPlaceEdit`.)
`CMFCTabCtrl::EnableTabDocumentsMenu`	Substitui dois botões que rolam as guias da janela por um botão que abre um menu de janelas com guias.
`CMFCTabCtrl::EnsureVisible`	Garante que uma guia esteja visível.
`CMFCTabCtrl::GetDocumentIcon`	Recupera o símbolo associado a uma guia em um menu pop-up de janelas com guia.
`CMFCTabCtrl::GetFirstVisibleTabNum`	Recupera o índice da primeira guia visível no controle guia atual.
`CMFCTabCtrl::GetResizeMode`	Recupera um valor que especifica como o controle guia atual pode ser redimensionado.
`CMFCTabCtrl::GetScrollBar`	Recupera um ponteiro para o objeto da barra de rolagem associado ao controle guia.
`CMFCTabCtrl::GetTabArea`	Recupera o retângulo delimitador da área do rótulo de guia na parte superior ou inferior do controle guia. (Substitui `CMFCBaseTabCtrl::GetTabArea`.)
`CMFCTabCtrl::GetTabFromPoint`	Recupera a guia que contém um ponto especificado. (Substitui `CMFCBaseTabCtrl::GetTabFromPoint`.)
`CMFCTabCtrl::GetTabMaxWidth`	Recupera a largura máxima de uma guia.
`CMFCTabCtrl::GetTabsHeight`	Recupera a altura da área de guia do controle guia atual.
`CMFCTabCtrl::GetTabsRect`	Recupera um retângulo que limita a área de guia do controle guia atual. (Substitui `CMFCBaseTabCtrl::GetTabsRect`.)
`CMFCTabCtrl::GetThisClass`	Usado pela estrutura para obter um ponteiro para o objeto `CRuntimeClass` associado a esse tipo de classe.
`CMFCTabCtrl::GetWndArea`	Recupera o limite da área de cliente do controle guia atual.
`CMFCTabCtrl::HideActiveWindowHorzScrollBar`	Oculta a barra de rolagem horizontal, se houver, da janela ativa.
`CMFCTabCtrl::HideInactiveWindow`	Especifica se a estrutura deve exibir janelas de controle guia inativas.
`CMFCTabCtrl::HideNoTabs`	Habilita ou desabilita o desenho da área da guia se não houver guias visíveis.
`CMFCTabCtrl::HideSingleTab`	Habilita ou desabilita o desenho de uma guia quando há uma única janela com guias. (Substitui `CMFCBaseTabCtrl::HideSingleTab`.)
`CMFCTabCtrl::IsActiveInMDITabGroup`	Indica se a guia atual de um controle guia é a guia ativa em um grupo de guias de interface de vários documentos.
`CMFCTabCtrl::IsActiveTabBoldFont`	Indica se o texto da guia ativa é exibido usando uma fonte em negrito.
`CMFCTabCtrl::IsActiveTabCloseButton`	Indica se o botão Fechar ( X) é exibido em uma guia ativa ou no canto superior direito da área da guia.
`CMFCTabCtrl::IsDrawFrame`	Indica se a janela com guias desenha um retângulo delineado em torno de painéis inseridos.
`CMFCTabCtrl::IsFlatFrame`	Indica se o quadro ao redor da área da guia é plano ou 3D.
`CMFCTabCtrl::IsFlatTab`	Indica se a aparência das guias no controle guia atual é simples ou não.
`CMFCTabCtrl::IsLeftRightRounded`	Indica se a aparência do lado esquerdo e direito de uma guia no controle guia atual é arredondada.
`CMFCTabCtrl::IsMDITabGroup`	Indica se o controle guia atual está contido na área de cliente de uma janela de interface de vários documentos.
`CMFCTabCtrl::IsOneNoteStyle`	Indica se o controle guia atual é exibido no estilo do Microsoft OneNote.
`CMFCTabCtrl::IsPtInTabArea`	Determina se um ponto está dentro da área da guia. (Substitui `CMFCBaseTabCtrl::IsPtInTabArea`.)
`CMFCTabCtrl::IsSharedScroll`	Indica se o controle guia atual tem uma barra de rolagem que pode rolar as guias como um grupo.
`CMFCTabCtrl::IsTabDocumentsMenu`	Indica se o controle guia exibe botões de rolagem ou um botão que exibe um menu de janelas com guias.
`CMFCTabCtrl::IsVS2005Style`	Indica se as guias são exibidas no estilo do Visual Studio .NET 2005.
`CMFCTabCtrl::ModifyTabStyle`	Especifica a aparência das guias no controle guia atual.
`CMFCTabCtrl::MoveTab`	Move uma guia para outra posição de guia. (Substitui `CMFCBaseTabCtrl::MoveTab`.)
`CMFCTabCtrl::OnDragEnter`	Chamado pela estrutura quando o cursor é arrastado pela primeira vez para a janela de controle guia.
`CMFCTabCtrl::OnDragOver`	Chamado pela estrutura durante uma operação de arrastar quando o mouse é movido pela janela de destino para soltar. (Substitui `CMFCBaseTabCtrl::OnDragOver`.)
`CMFCTabCtrl::OnShowTabDocumentsMenu`	Exibe um menu pop-up de janelas com guias, aguarda até que o usuário selecione uma guia e ative a guia selecionada.
`CMFCTabCtrl::PreTranslateMessage`	Converte mensagens de janela antes de serem expedidas para as funções `TranslateMessage` e `DispatchMessage` do Windows. (Substitui `CMFCBaseTabCtrl::PreTranslateMessage`.)
`CMFCTabCtrl::RecalcLayout`	Recalcula o layout interno do controle guia. (Substitui `CMFCBaseTabCtrl::RecalcLayout`.)
`CMFCTabCtrl::SetActiveInMDITabGroup`	Define a guia atual de um controle guia como a guia ativa em um grupo de guias de interface de vários documentos.
`CMFCTabCtrl::SetActiveTab`	Ativa uma guia. (Substitui `CMFCBaseTabCtrl::SetActiveTab`.)
`CMFCTabCtrl::SetActiveTabBoldFont`	Habilita ou desabilita o uso de uma fonte em negrito nas guias ativas.
`CMFCTabCtrl::SetDrawFrame`	Habilita ou desabilita o desenho de um retângulo delineado em torno de uma barra inserida.
`CMFCTabCtrl::SetFlatFrame`	Especifica se é necessário desenhar um quadro plano ou 3D ao redor da área da guia.
`CMFCTabCtrl::SetImageList`	Especifica uma lista de imagens. (Substitui `CMFCBaseTabCtrl::SetImageList`.)
`CMFCTabCtrl::SetResizeMode`	Especifica como o controle guia atual pode ser redimensionado e, em seguida, redimensiona o controle.
`CMFCTabCtrl::SetTabMaxWidth`	Especifica a largura máxima da guia em uma janela com guias.
`CMFCTabCtrl::StopResize`	Encerra a operação de redimensionamento atual no controle guia.
`CMFCTabCtrl::SwapTabs`	Troca um par de guias. (Substitui `CMFCBaseTabCtrl::SwapTabs`.)
`CMFCTabCtrl::SynchronizeScrollBar`	Desenha uma barra de rolagem horizontal em um controle guia que exibe guias simples.

Membros de dados

Nome	Descrição
`CMFCTabCtrl::m_bEnableActivate`	Impede que o modo de exibição ativo perca o foco quando uma nova guia é inserida e habilitada.

Comentários

A classe CMFCTabCtrl dá suporte a:

Estilos de controle guia que incluem 3D, plano e plano com uma barra de rolagem horizontal compartilhada.
Guias localizadas na parte superior ou inferior da janela.
Guias que exibem texto, imagens ou texto e imagens.
Guias que alteram a cor quando a guia está ativa.
Alterações no tamanho da borda para guias ajustáveis.
Janelas com guia desanexáveis.

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

Siga estas etapas para adicionar um controle guia de encaixe redimensionável em seu aplicativo:

Criar uma instância de Classe CTabbedPane.
Chame CDockablePane::Create.
Use CBaseTabbedPane::AddTab ou CMFCBaseTabCtrl::InsertTab para adicionar novas guias.
Chame CBasePane::EnableDocking para que o controle guia de encaixe atual possa ser encaixado na janela de quadro principal.
Chame CFrameWndEx::DockPane para encaixar a janela com guias no quadro principal.

Para obter um exemplo de como criar uma janela com guias como uma barra de controle de encaixe, consulte Classe CTabbedPane. Para usar CMFCTabCtrl como um controle sem encaixe, crie um objeto CMFCTabCtrl e, em seguida, chame CMFCTabCtrl::Create.

Hierarquia de herança

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe CMFCTabCtrl para configurar um objeto CMFCTabCtrl. O exemplo explica como adicionar uma guia, exibir o botão Fechar na guia ativa, habilitar rótulos de guia editáveis e exibir um menu pop-up de rótulos de janelas com guias. Esse exemplo é parte do Exemplo de 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();

Requisitos

Cabeçalhoafxtabctrl.h:

`CMFCTabCtrl::ActivateMDITab`

Exibe a guia especificada do controle de guia atual e define o foco nessa guia.

void ActivateMDITab(int nTab = -1);

Parâmetros

nTab
[in] O índice baseado em zero de uma guia a ser exibida ou -1 para especificar a guia ativa no momento.

`CMFCTabCtrl::AllowDestroyEmptyTabbedPane`

Para conhecer mais detalhes, confira o código-fonte localizado na pasta mfc da instalação do Visual Studio. Por exemplo, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Valor de Devolução

Sempre TRUE.

Comentários

`CMFCTabCtrl::AutoSizeWindow`

Especifica se a estrutura deve redimensionar a área do cliente de todas as janelas de controle guia quando um elemento de interface do usuário do controle guia for alterado.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parâmetros

bAutoSize
[in] TRUE para redimensionar automaticamente janelas de controle guia; caso contrário, FALSE. O valor padrão é TRUE.

Comentários

`CMFCTabCtrl::Create`

Cria o controle da guia e o anexa ao objeto CMFCTabCtrl.

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

Parâmetros

style
[in] O estilo do controle guia. Para obter mais informações, consulte Comentários.

rect
[in] Um retângulo que limita o controle de guia.

pParentWnd
[in] Um ponteiro para uma janela pai. Não deve ser NULL.

nID
[in] A ID do controle de guia.

location
[in] A localização das guias. O valor padrão é LOCATION_BOTTOM. Para obter mais informações, consulte Comentários.

bCloseBtn
[in] TRUE para exibir um botão Fechar na guia; caso contrário, FALSE. O valor padrão é FALSE.

Valor de Devolução

TRUE se for bem-sucedido, caso contrário, FALSE.

Comentários

A tabela a seguir lista e descreve os valores que podem ser especificados no parâmetro style.

Estilo	Descrição
`STYLE_3D`	Cria um controle guia com uma aparência tridimensional.
`STYLE_FLAT`	Cria um controle guia com guias planas.
`STYLE_FLAT_SHARED_HORZ_SCROLL`	Cria um controle guia com guias planas e uma barra de rolagem que pode rolar as guias se elas forem recortadas por uma janela pai.
`STYLE_3D_ONENOTE`	Cria um controle guia no estilo do Microsoft OneNote.
`STYLE_3D_VS2005`	Cria um controle guia no estilo do Microsoft Visual Studio 2005.
`STYLE_3D_ROUNDED`	Cria um controle guia com guias arredondadas no estilo do Microsoft Visual Studio 2005.
`STYLE_3D_ROUNDED_SCROLL`	Cria um controle guia com guias arredondadas e botões de rolagem no estilo do Microsoft Visual Studio 2005.

A tabela a seguir lista os valores que podem ser especificados no parâmetro location.

Location	Descrição
`LOCATION_BOTTOM`	As guias estão localizadas na parte inferior do controle guia.
`LOCATION_TOP`	As guias estão localizadas na parte superior do controle guia.

Exemplo

O seguinte exemplo demonstra como usar o método Create na classe CMFCTabCtrl. Esse exemplo é parte do Exemplo de coleção de estado.

CMFCTabCtrl m_wndTabs;

// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

`CMFCTabCtrl::CalcRectEdit`

Compacta o tamanho da área da guia especificada.

virtual void CalcRectEdit(CRect& rectEdit);

Parâmetros

rectEdit
[in] Um retângulo que especifica a área de uma guia.

Comentários

Esse método é chamado quando você altera o rótulo de uma guia. Ele esvazia os lados esquerdo e direito do retângulo especificado por metade da altura da guia atual e esvazia a parte superior e inferior em uma unidade.

`CMFCTabCtrl::EnableActiveTabCloseButton`

Exibe ou oculta o botão Fechar ( X) na guia ativa.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parâmetros

bEnable
[in] TRUE para exibir o botão Fechar na guia ativa; FALSE para exibir o botão Fechar no canto superior direito da área de guia. O valor padrão é TRUE.

`CMFCTabCtrl::EnableInPlaceEdit`

Habilita ou desabilita rótulos de guia editáveis.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parâmetros

bEnable
[in] TRUE para habilitar rótulos de guia editáveis; FALSE para desabilitar rótulos de guia editáveis.

Comentários

`CMFCTabCtrl::EnableTabDocumentsMenu`

Alterna entre uma interface do usuário que usa dois botões para rolar as guias da janela e uma interface que exibe um menu pop-up de janelas com guias.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parâmetros

bEnable
[in] TRUE para exibir um menu pop-up de rótulos de janela com guias; FALSE para exibir botões de rolagem para frente e para trás. O valor padrão é TRUE.

Comentários

Quando o usuário clica em um rótulo de guia, a estrutura exibe a janela com guias correspondente. Se o rótulo de guia estiver visível, a janela com guias será aberta sem alterar sua posição. Se o usuário selecionar um documento no menu pop-up e a janela com guias correspondente estiver fora da tela, a janela com guias se tornará a primeira guia.

`CMFCTabCtrl::EnsureVisible`

Garante que uma guia esteja visível.

virtual BOOL EnsureVisible(int iTab);

Parâmetros

iTab
[in] O índice baseado em zero de uma guia.

Valor de Devolução

TRUE se for bem-sucedido; FALSE se o índice de parâmetro iTab for inválido.

Comentários

Use esse método para garantir que a guia especificada esteja visível. O controle guia será rolado se for necessário.

`CMFCTabCtrl::GetDocumentIcon`

Recupera a imagem associada a uma guia em um menu pop-up de janelas com guia.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parâmetros

nCmdID
[in] A ID de comando de uma guia em um menu pop-up de janelas com guia.

Valor de Devolução

O identificador de uma imagem bitmap.

`CMFCTabCtrl::GetFirstVisibleTabNum`

Recupera o índice da primeira guia visível no controle guia atual.

virtual int GetFirstVisibleTabNum() const;

Valor de Devolução

O índice baseado em zero de uma guia no controle guia.

Comentários

Use esse método somente quando o controle guia for exibido no estilo do Microsoft OneNote. Use o método CMFCTabCtrl::IsOneNoteStyle para determinar o estilo.

`CMFCTabCtrl::GetResizeMode`

Recupera um valor que especifica como o controle guia atual pode ser redimensionado.

ResizeMode GetResizeMode() const;

Valor de Devolução

Um dos valores de enumeração CMFCTabCtrl::ResizeMode que especifica como o controle guia pode ser redimensionado. Para obter uma lista de valores possíveis, consulte a seção Comentários do método CMFCTabCtrl::SetResizeMode.

`CMFCTabCtrl::GetScrollBar`

Recupera um ponteiro para o objeto da barra de rolagem associado ao controle guia.

CScrollBar* GetScrollBar();

Valor de Devolução

Um ponteiro para um objeto de barra de rolagem ou NULL se o controle guia não foi criado usando o estilo STYLE_FLAT_SHARED_HORZ_SCROLL.

Comentários

Use esse método para acessar a barra de rolagem inserida do controle guia. Um objeto de barra de rolagem é criado somente quando o controle guia tem o estilo STYLE_FLAT_SHARED_HORZ_SCROLL.

`CMFCTabCtrl::GetTabArea`

Recupera o retângulo delimitador da área do rótulo de guia na parte superior ou inferior do controle guia.

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parâmetros

rectTabAreaTop
[out] Quando esse método retorna, essa referência contém um retângulo que limita a área de rótulo da guia superior. O retângulo está nas coordenadas de cliente. Essa referência estará vazia se nenhuma área de rótulo de guia existir na parte superior do controle guia.

rectTabAreaBottom
[out] Quando esse método retorna, essa referência contém um retângulo que limita a área de rótulo da guia inferior. O retângulo está nas coordenadas de cliente. Essa referência estará vazia se nenhuma área de rótulo de guia existir na parte inferior do controle guia.

Comentários

Use esse método para determinar o tamanho e a posição da área de guia na janela com guias.

`CMFCTabCtrl::GetTabMaxWidth`

Recupera a largura máxima de uma guia.

int GetTabMaxWidth() const;

Valor de Devolução

Largura máxima de uma guia em pixels. Se o valor retornado for 0, a largura da guia será ilimitada.

Comentários

Use o método CMFCTabCtrl::SetTabMaxWidth para definir a largura máxima da guia.

`CMFCTabCtrl::GetTabsHeight`

Recupera a altura da área de guia do controle guia atual.

virtual int GetTabsHeight() const;

Valor de Devolução

A altura da área de guia se qualquer guia estiver visível ou zero se nenhuma guia estiver visível.

`CMFCTabCtrl::GetTabsRect`

Recupera um retângulo que limita a área de guia do controle guia atual.

virtual void GetTabsRect(CRect& rect) const;

Parâmetros

rect
[out] Quando esse método é retornado, o parâmetro rect contém um retângulo que limita a área de guia.

`CMFCTabCtrl::GetWndArea`

Recupera o limite da área de cliente do controle guia atual.

void GetWndArea(CRect& rect) const;

Parâmetros

rect
[in, out] Quando esse método é retornado, esse parâmetro contém um retângulo que vincula o controle guia atual.

Comentários

`CMFCTabCtrl::HideActiveWindowHorzScrollBar`

Oculta a barra de rolagem horizontal, se houver, na janela ativa.

void HideActiveWindowHorzScrollBar();

Comentários

Use esse método para impedir que o controle guia pisque quando o usuário alterna entre páginas de controle guia.

`CMFCTabCtrl::HideInactiveWindow`

Especifica se a estrutura exibe janelas de controle guia inativas.

void HideInactiveWindow(BOOL bHide = TRUE);

Parâmetros

bHide
[in] TRUE não deve exibir uma janela inativa; FALSE deve exibir uma janela inativa. O valor padrão é TRUE.

Comentários

`CMFCTabCtrl::HideNoTabs`

Habilita ou desabilita o desenho da área de guia se não houver guias visíveis.

void HideNoTabs(BOOL bHide=TRUE);

Parâmetros

bHide
[in] TRUE deve habilitar o desenho da área de guia; FALSE deve desabilitar o desenho. O valor padrão é TRUE.

Comentários

`CMFCTabCtrl::HideSingleTab`

Habilita ou desabilita o desenho da guia se houver uma única janela com guias.

virtual void HideSingleTab(BOOL bHide=TRUE);

Parâmetros

bHide
[in] TRUE não deve desenhar uma guia para uma única janela com guias; FALSE deve desenhar uma única guia. O valor padrão é TRUE.

Comentários

`CMFCTabCtrl::IsActiveInMDITabGroup`

Indica se a guia atual de um controle guia é a guia ativa em um grupo de guias de interface de vários documentos.

BOOL IsActiveInMDITabGroup() const;

Valor de Devolução

TRUE se a guia atual de um controle guia for a guia ativa em um grupo de guias MDI; caso contrário, FALSE.

Comentários

É possível organizar várias janelas do documento em grupos de guias verticais ou horizontais e embaralhar facilmente os documentos de um grupo de guias em outro.

`CMFCTabCtrl::IsActiveTabBoldFont`

Indica se o texto da guia ativa é exibido usando uma fonte em negrito.

BOOL IsActiveTabBoldFont() const;

Valor de Devolução

TRUE se a guia ativa for exibida usando a fonte em negrito; caso contrário, FALSE.

Comentários

Use o método CMFCTabCtrl::SetActiveTabBoldFont para alterar a fonte de guia ativa.

`CMFCTabCtrl::IsActiveTabCloseButton`

Indica se o botão Fechar ( X) é exibido em uma guia ativa ou no canto superior direito da área de guia.

virtual BOOL IsActiveTabCloseButton() const;

Valor de Devolução

TRUE se o botão Fechar for exibido na guia ativa; FALSE se o botão Fechar for exibido no canto superior direito da área de guia.

Comentários

`CMFCTabCtrl::IsDrawFrame`

Indica se a janela com guias desenha um retângulo delineado em torno de painéis inseridos.

BOOL IsDrawFrame() const;

Valor de Devolução

TRUE se um retângulo delineado for desenhado; caso contrário, FALSE.

Comentários

Use o método CMFCTabCtrl::SetDrawFrame para habilitar ou desabilitar o desenho de um retângulo delineado.

`CMFCTabCtrl::IsFlatFrame`

Indica se o quadro ao redor da área da guia é plano ou 3D.

BOOL IsFlatFrame() const;

Valor de Devolução

TRUE se o quadro ao redor da área de guia for plano; FALSE se o quadro for tridimensional.

Comentários

Use o método CMFCTabCtrl::SetFlatFrame para alterar a forma como o quadro é desenhado.

`CMFCTabCtrl::IsFlatTab`

Indica se a aparência das guias no controle guia atual é simples ou não.

virtual BOOL IsFlatTab() const;

Valor de Devolução

TRUE se a aparência das guias no controle guia atual for simples; caso contrário, FALSE.

`CMFCTabCtrl::IsLeftRightRounded`

Indica se a aparência do lado esquerdo e direito de uma guia no controle guia atual é arredondada.

virtual BOOL IsLeftRightRounded() const;

Valor de Devolução

TRUE se os lados das guias forem arredondados; caso contrário, FALSE.

`CMFCTabCtrl::IsMDITabGroup`

Indica se o controle guia atual está contido na área de cliente de uma janela de interface de vários documentos.

virtual BOOL IsMDITabGroup() const;

Valor de Devolução

TRUE se o controle guia atual estiver em uma janela da área do cliente MDI; caso contrário, FALSE.

`CMFCTabCtrl::IsOneNoteStyle`

Indica se o controle guia atual é exibido no estilo do Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Valor de Devolução

TRUE se o controle guia for exibido no estilo do Microsoft OneNote; caso contrário, FALSE.

`CMFCTabCtrl::IsSharedScroll`

Indica se o controle guia atual tem uma barra de rolagem que pode rolar as guias como um grupo.

BOOL IsSharedScroll() const;

Valor de Devolução

TRUE se o controle guia tiver uma barra de rolagem compartilhada; caso contrário, FALSE.

Comentários

Esse método retorna TRUE se o parâmetro style do método CMFCTabCtrl::Create for STYLE_FLAT_SHARED_HORZ_SCROLL.

`CMFCTabCtrl::IsTabDocumentsMenu`

Indica se o controle guia exibe botões de rolagem ou um botão que exibe um menu de janelas com guias.

BOOL IsTabDocumentsMenu() const;

Valor de Devolução

TRUE se as janelas com guias forem roladas usando um menu pop-up de rótulos de janela com guias; FALSE se as janelas com guias forem roladas usando botões de rolagem para frente e para trás.

Comentários

Use o método CMFCTabCtrl::EnableTabDocumentsMenu para especificar o método de rolagem de janelas com guias.

`CMFCTabCtrl::IsVS2005Style`

Indica se as guias foram desenhadas usando o estilo do Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Valor de Devolução

TRUE se as guias forem desenhadas usando o estilo do Visual Studio 2005; caso contrário, FALSE.

Comentários

Use o parâmetro style do método CMFCTabCtrl::Create para especificar como as guias são desenhadas.

`CMFCTabCtrl::m_bEnableActivate`

Impede que o modo de exibição ativo perca o foco quando uma nova guia é inserida e habilitada.

static BOOL m_bEnableActivate;

Comentários

O foco geralmente é tomado por uma nova janela com guias quando a guia é inserida e ativada. Defina a variável de membro CMFCTabCtrl::m_bEnableActivate como FALSE para manter o foco original. O valor padrão é TRUE.

`CMFCTabCtrl::ModifyTabStyle`

Especifica a aparência das guias no controle guia atual.

BOOL ModifyTabStyle(Style style);

Parâmetros

style
[in] Um dos valores de enumeração que especifica a aparência do controle guia. Para obter mais informações, confira a tabela em Comentários.

Valor de Devolução

Sempre TRUE.

Comentários

O valor do parâmetro style pode ser uma das seguintes enumerações CMFCTabCtrl::Style.

Nome	Descrição
`STYLE_3D`	Exibe guias tridimensionais retangulares com cantos arredondados.
`STYLE_3D_ONENOTE`	Exibe guias tridimensionais com um lado vertical, um lado inclinado e cantos arredondados.
`STYLE_3D_ROUNDED`	Exibe guias tridimensionais com lados inclinados e cantos arredondados.
`STYLE_3D_ROUNDED_SCROLL`	Exibe guias tridimensionais com lados inclinados e cantos arredondados. Se houver mais guias que podem ser exibidas ao mesmo tempo, a estrutura exibirá uma seta suspensa e um menu de guias para tornar ativo.
`STYLE_3D_SCROLLED`	Exibe guias tridimensionais e retangulares. Se houver mais guias que podem ser exibidas ao mesmo tempo, a estrutura exibirá uma seta suspensa e um menu de guias para tornar ativo.
`STYLE_3D_VS2005`	Exibe guias tridimensionais arredondadas com um lado inclinado e um lado vertical.
`STYLE_FLAT`	Exibe guias bidimensionais com os lados esquerdo e direito inclinados.
`STYLE_FLAT_SHARED_HORZ_SCROLL`	Exibe guias bidimensionais. Se houver mais guias que podem ser exibidas ao mesmo tempo, a estrutura exibirá setas de rolagem nas extremidades da área de guia.

`CMFCTabCtrl::OnDragEnter`

Chamado pela estrutura durante uma operação do tipo "arrastar e soltar" quando o cursor entra pela primeira vez na janela do controle guia atual.

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parâmetros

pDataObject
[in] Aponta para um objeto de dados que contém os dados arrastrados pelo usuário.

dwKeyState
[in] Contém o estado das teclas modificadoras. Esse parâmetro é uma combinação bit a bit "or" (|) dos seguintes valores: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON e MK_RBUTTON. Para obter mais informações, consulte a seção Parâmetros de mensagens de Sobre a entrada do mouse.

point
[in] Contém a localização atual do cursor nas coordenadas de cliente.

Valor de Devolução

Sempre DROPEFFECT_NONE, o que significa que o destino de descarte não pode aceitar os dados.

Comentários

Use esse método para dar suporte a uma operação do tipo "arrastar e soltar". Substitua esse método para implementar seu próprio comportamento personalizado.

Por padrão, esse método chama apenas CMFCTabCtrl::OnDragOver, que sempre retorna DROPEFFECT_NONE.

`CMFCTabCtrl::OnDragOver`

Chamado pela estrutura durante uma operação de arrastar quando o mouse é movido pela janela de destino para soltar.

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parâmetros

pDataObject
[in] Ponteiro para um objeto COleDataObject que está sendo arrastado sobre o destino de soltar.

dwKeyState
[in] O estado das teclas modificadoras, que é uma combinação bit a bit "ou" (|) de MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON eMK_RBUTTON. Para obter mais informações, consulte "Parâmetros de mensagem" em Sobre a entrada do mouse.

point
[in] A posição atual do mouse.

Valor de Devolução

Sempre DROPEFFECT_NONE.

Comentários

Substitua este método pela implementação personalizada. Para obter mais informações, consulte o método CView::OnDragOver.

`CMFCTabCtrl::OnShowTabDocumentsMenu`

Exibe um menu pop-up de janelas com guias, aguarda até que o usuário selecione uma guia e ative a guia selecionada.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parâmetros

point
[in] As coordenadas de onde o menu pop-up deve ser exibido.

Comentários

`CMFCTabCtrl::SetActiveInMDITabGroup`

Define a guia atual de um controle guia como a guia ativa em um grupo de guias de interface de vários documentos.

void SetActiveInMDITabGroup(BOOL bActive);

Parâmetros

bActive
[in] TRUE para tornar a guia atual ativa; FALSE para tornar a guia atual inativa.

Comentários

É possível organizar várias janelas do documento em grupos de guias verticais ou horizontais e embaralhar facilmente os documentos de um grupo de guias em outro.

`CMFCTabCtrl::SetActiveTab`

Ativa uma guia.

virtual BOOL SetActiveTab(int iTab);

Parâmetros

iTab
[in] Especifica o índice baseado em zero da guia a ser ativada.

Valor de Devolução

TRUE se a guia especificada estiver ativada; FALSE se o valor do parâmetro iTab especificado for inválido.

Comentários

Isso envia a notificação AFX_WM_CHANGE_ACTIVE_TAB para a janela pai e o quadro pai do controle guia.

O método SetActiveTab chama automaticamente o método CMFCTabCtrl::HideActiveWindowHorzScrollBar para evitar que a tela pisque.

`CMFCTabCtrl::SetActiveTabBoldFont`

Habilita ou desabilita o uso de uma fonte em negrito nas guias ativas.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parâmetros

bIsBold
[in] TRUE para usar uma fonte em negrito para exibir o rótulo da guia ativa; FALSE para usar a fonte padrão para exibir o rótulo. O valor padrão é TRUE.

Comentários

`CMFCTabCtrl::SetDrawFrame`

Especifica se um retângulo delineado é desenhado em torno de uma barra inserida.

void SetDrawFrame(BOOL bDraw=TRUE);

Parâmetros

bDraw
[in] TRUE para exibir um retângulo delineado em torno de uma barra inserida; caso contrário, FALSE. O valor padrão é TRUE.

Comentários

`CMFCTabCtrl::SetFlatFrame`

Especifica se é necessário desenhar um quadro plano ou 3D ao redor da área da guia.

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

Parâmetros

bFlat
[in] TRUE para desenhar um quadro plano (2D) ao redor da área de guia; FALSE para desenhar um quadro tridimensional (3D). O valor padrão é TRUE.

bRepaint
[in] TRUE para redesenhar a janela imediatamente; caso contrário, FALSE. O valor padrão é TRUE.

Comentários

`CMFCTabCtrl::SetImageList`

Especifica uma lista de imagens.

virtual BOOL SetImageList(
    UINT uiID,
    int cx=15,
    COLORREF clrTransp=RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parâmetros

uiID
[in] A ID de um recurso de bitmap que contém a lista de imagens.

cx
[in] A largura de cada imagem em pixels. O valor padrão é 15.

clrTransp
[in] A cor da imagem transparente. As partes da imagem que são dessa cor serão transparentes. O valor padrão é a cor magenta, RGB(255,0,255).

hImageList
[in] Um identificador para uma lista de imagens pré-carregadas.

Valor de Devolução

TRUE se o método for bem-sucedido. FALSE Se o controle Tab for criado usando um estilo simples ou se a primeira sobrecarga de método não puder carregar o bitmap especificado pelo uiID parâmetro.

Comentários

Use esse método para definir uma lista de imagens para o controle guia. As imagens da lista de imagens são exibidas ao lado do rótulo de guia. Esse método recalcula a altura da guia para que ela seja dimensionada para conter a imagem e o texto.

Use o método CMFCBaseTabCtrl::AddTab herdado pelo controle guia para especificar o índice da imagem a ser exibida.

`CMFCTabCtrl::SetResizeMode`

Especifica como o controle guia atual pode ser redimensionado e, em seguida, redimensiona o controle.

void SetResizeMode(ResizeMode resizeMode);

Parâmetros

resizeMode
[in] Um dos valores de enumeração CMFCTabCtrl::ResizeMode que especifica como o controle guia pode ser redimensionado. Para obter uma lista de valores possíveis, consulte a tabela em Comentários.

Comentários

O parâmetro resizeMode pode ser um dos seguintes valores de enumeração ResizeMode.

Nome	Descrição
`RESIZE_NO`	O controle de guia não pode ser redimensionado.
`RESIZE_VERT`	O controle guia pode ser redimensionado verticalmente, mas não horizontalmente.
`RESIZE_HORIZ`	O controle guia pode ser redimensionado horizontalmente, mas não verticalmente.

`CMFCTabCtrl::SetTabMaxWidth`

Especifica a largura máxima da guia em uma janela com guias.

void SetTabMaxWidth(int nTabMaxWidth);

Parâmetros

nTabMaxWidth
[in] A largura máxima da guia em pixels.

Comentários

Use esse método para limitar a largura de cada guia em uma janela com guias. Esse método será útil se as guias tiverem rótulos muito longos. O construtor de classe CMFCTabCtrl inicializa a largura máxima da guia para 0, o que realmente significa que a largura não é limitada.

`CMFCTabCtrl::StopResize`

Encerra a operação de redimensionamento atual no controle guia.

void StopResize(BOOL bCancel);

Parâmetros

bCancel
[in] TRUE para abandonar a operação de redimensionamento atual; FALSE para concluir a operação de redimensionamento atual. Em ambos os casos, a estrutura suspende o desenho do retângulo de redimensionamento.

`CMFCTabCtrl::SynchronizeScrollBar`

Desenha uma barra de rolagem horizontal em um controle guia que exibe guias simples.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parâmetros

pScrollInfo
[out] Ponteiro para uma estrutura SCROLLINFO ou NULL. Quando esse método retorna e se esse parâmetro não for NULL, a estrutura contém todos os parâmetros da barra de rolagem. O valor padrão é NULL.

Valor de Devolução

TRUE se esse método tiver êxito; caso contrário, FALSE.

Comentários

Esse método afeta apenas um controle guia que exibe guias planas. A barra de rolagem influencia todas as guias concomitantemente.

Confira também

Gráfico da hierarquia
Classes
Classe CDockablePane
Classe CMFCBaseTabCtrl

Compartilhar via

Classe CMFCTabCtrl

Sintaxe

Membros

Construtores públicos

Métodos públicos

Membros de dados

Comentários

Hierarquia de herança

Exemplo

Requisitos

CMFCTabCtrl::ActivateMDITab

Parâmetros

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Valor de Devolução

Comentários

CMFCTabCtrl::AutoSizeWindow

Parâmetros

Comentários

CMFCTabCtrl::Create

Parâmetros

Valor de Devolução

Comentários

Exemplo

CMFCTabCtrl::CalcRectEdit

Parâmetros

Comentários

CMFCTabCtrl::EnableActiveTabCloseButton

Parâmetros

CMFCTabCtrl::EnableInPlaceEdit

Parâmetros

Comentários

CMFCTabCtrl::EnableTabDocumentsMenu

Parâmetros

Comentários

CMFCTabCtrl::EnsureVisible

Parâmetros

Valor de Devolução

Comentários

CMFCTabCtrl::GetDocumentIcon

Parâmetros

Valor de Devolução

CMFCTabCtrl::GetFirstVisibleTabNum

Valor de Devolução

Comentários

CMFCTabCtrl::GetResizeMode

Valor de Devolução

CMFCTabCtrl::GetScrollBar

Valor de Devolução

Comentários

CMFCTabCtrl::GetTabArea

Parâmetros

Comentários

CMFCTabCtrl::GetTabMaxWidth

Valor de Devolução

Comentários

CMFCTabCtrl::GetTabsHeight

Valor de Devolução

CMFCTabCtrl::GetTabsRect

Parâmetros

CMFCTabCtrl::GetWndArea

Parâmetros

Comentários

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Comentários

CMFCTabCtrl::HideInactiveWindow

Parâmetros

Comentários

CMFCTabCtrl::HideNoTabs

Parâmetros

Comentários

CMFCTabCtrl::HideSingleTab

Parâmetros

Comentários

CMFCTabCtrl::IsActiveInMDITabGroup

Valor de Devolução

Comentários

CMFCTabCtrl::IsActiveTabBoldFont

Valor de Devolução

Comentários

Classe `CMFCTabCtrl`

`CMFCTabCtrl::ActivateMDITab`

`CMFCTabCtrl::AllowDestroyEmptyTabbedPane`

`CMFCTabCtrl::AutoSizeWindow`

`CMFCTabCtrl::Create`

`CMFCTabCtrl::CalcRectEdit`

`CMFCTabCtrl::EnableActiveTabCloseButton`

`CMFCTabCtrl::EnableInPlaceEdit`

`CMFCTabCtrl::EnableTabDocumentsMenu`

`CMFCTabCtrl::EnsureVisible`

`CMFCTabCtrl::GetDocumentIcon`

`CMFCTabCtrl::GetFirstVisibleTabNum`

`CMFCTabCtrl::GetResizeMode`

`CMFCTabCtrl::GetScrollBar`

`CMFCTabCtrl::GetTabArea`

`CMFCTabCtrl::GetTabMaxWidth`

`CMFCTabCtrl::GetTabsHeight`

`CMFCTabCtrl::GetTabsRect`

`CMFCTabCtrl::GetWndArea`

`CMFCTabCtrl::HideActiveWindowHorzScrollBar`

`CMFCTabCtrl::HideInactiveWindow`

`CMFCTabCtrl::HideNoTabs`

`CMFCTabCtrl::HideSingleTab`

`CMFCTabCtrl::IsActiveInMDITabGroup`

`CMFCTabCtrl::IsActiveTabBoldFont`

`CMFCTabCtrl::IsActiveTabCloseButton`

`CMFCTabCtrl::IsDrawFrame`

`CMFCTabCtrl::IsFlatFrame`

`CMFCTabCtrl::IsFlatTab`

`CMFCTabCtrl::IsLeftRightRounded`

`CMFCTabCtrl::IsMDITabGroup`

`CMFCTabCtrl::IsOneNoteStyle`

`CMFCTabCtrl::IsSharedScroll`

`CMFCTabCtrl::IsTabDocumentsMenu`

`CMFCTabCtrl::IsVS2005Style`

`CMFCTabCtrl::m_bEnableActivate`

`CMFCTabCtrl::ModifyTabStyle`

`CMFCTabCtrl::OnDragEnter`

`CMFCTabCtrl::OnDragOver`

`CMFCTabCtrl::OnShowTabDocumentsMenu`

`CMFCTabCtrl::SetActiveInMDITabGroup`

`CMFCTabCtrl::SetActiveTab`

`CMFCTabCtrl::SetActiveTabBoldFont`

`CMFCTabCtrl::SetDrawFrame`

`CMFCTabCtrl::SetFlatFrame`

`CMFCTabCtrl::SetImageList`

`CMFCTabCtrl::SetResizeMode`

`CMFCTabCtrl::SetTabMaxWidth`