Classe CMFCTabCtrl

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

Métodos públicos

Membros de dados

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:

1. Criar uma instância de Classe CTabbedPane.

2. Chame CDockablePane::Create.

3. Use CBaseTabbedPane::AddTab ou CMFCBaseTabCtrl::InsertTab para adicionar novas guias.

4. Chame CBasePane::EnableDocking para que o controle guia de encaixe atual possa ser encaixado na janela de quadro principal.

5. 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

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

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çalho: afxtabctrl.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 retorno

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 retorno

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.

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

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

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 retorno

Sempre TRUE.

Comentários

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

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 retorno

Sempre DROPEFFECT_NONE, o que significa que o destino de soltar 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 retorno

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 retorno

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 retorno

TRUE se o método for bem-sucedido. FALSE Se o controle Tab for criado usando um estilo simples ou se a sobrecarga do primeiro 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.

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 retorno

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