CMFCTabCtrl Classe

A CMFCTabCtrl classe fornece funcionalidade para o controlo de tabulação. O controlo de separadores apresenta uma janela acoplável com separadores planos ou tridimensionais no topo ou na base. Os separadores podem mostrar texto e uma imagem e mudar de cor quando ativos.

Sintaxe

class CMFCTabCtrl : public CMFCBaseTabCtrl

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados

Observações

A CMFCTabCtrl classe suporta:

• Estilos de controlo de tabulação que incluem 3D, plano e plano com uma barra de scroll horizontal partilhada.

• Separadores localizados no topo ou na parte inferior da janela.

• Separadores que mostram texto, imagens, ou texto e imagens.

• Separadores que mudam de cor quando o separador está ativo.

• Alterações no tamanho das bordas para abas ajustáveis.

• Janelas destacáveis com separações.

A CMFCTabCtrl classe pode ser usada com uma caixa de diálogo, mas destina-se a aplicações que utilizam barras de controlo de docking como Microsoft Excel e Visual Studio. Para mais informações, consulte CDockablePane Classe.

Siga estes passos para adicionar um controlo de separador de docking redimensionável na sua aplicação:

1. Crie uma instância de CTabbedPane Classe.

2. Ligue para o CDockablePane::Create.

3. Usar CBaseTabbedPane::AddTab ou CMFCBaseTabCtrl::InsertTab adicionar novas abas.

4. Chama CBasePane::EnableDocking para que o controlo atual do separador de acoplamento possa acoplar na janela principal do frame.

5. Chamada CFrameWndEx::DockPane para acoplar a janela com separadores no quadro principal.

Para um exemplo de como criar uma janela com separações como barra de controlo de acoplamento, veja CTabbedPane Classe. Para usar CMFCTabCtrl como controlo não acoplado, crie um CMFCTabCtrl objeto e depois chame CMFCTabCtrl::Create.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Example

O exemplo seguinte demonstra como usar vários métodos na CMFCTabCtrl classe para configurar um CMFCTabCtrl objeto. O exemplo explica como adicionar um separador, mostrar o botão Fechar no separador ativo, ativar etiquetas de separadores editáveis e exibir um menu pop-up com etiquetas de janelas com separadores. Este exemplo faz parte da amostra da Coleção Estatal.

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();

Requerimentos

Cabeçalho:afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Mostra o separador especificado do controlo de separador atual e define o foco nesse separador.

void ActivateMDITab(int nTab = -1);

Parâmetros

nTab
[dentro] O índice baseado em zero de um separador para mostrar, ou -1 para especificar o separador atualmente ativo.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Para mais detalhes, consulte o código-fonte localizado na mfc pasta da sua 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.

Observações

CMFCTabCtrl::AutoSizeWindow

Especifica se o framework deve redimensionar a área cliente de todas as janelas de controlo de separadores quando um elemento da interface de utilizador do controlo de separadores muda.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parâmetros

bAutoSize
[dentro] TRUE para redimensionar automaticamente as janelas de controlo de separadores; caso contrário, FALSE. O valor predefinido é TRUE.

Observações

CMFCTabCtrl::Create

Cria o controlo de tabulação e anexa-o ao CMFCTabCtrl objeto.

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

Parâmetros

style
[dentro] O estilo do controlo de separador. Para obter mais informações, consulte Observações.

rect
[dentro] Um retângulo que delimita o controlo do separador.

pParentWnd
[dentro] Um indicador para uma janela dos pais. Não pode ser NULL.

nID
[dentro] O ID do controlo de separador.

location
[dentro] A localização dos separadores. O valor predefinido é LOCATION_BOTTOM. Para obter mais informações, veja Observações.

bCloseBtn
[dentro] TRUE para mostrar um botão de fechar no separador; caso contrário, FALSE. O valor predefinido é FALSE.

Valor de retorno

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

Observações

A tabela seguinte descreve os valores que pode especificar para o style parâmetro.

A tabela seguinte lista os valores que pode especificar para o location parâmetro.

Example

O exemplo seguinte demonstra como usar o Create método na CMFCTabCtrl aula. Este exemplo faz parte da amostra da Coleção Estatal.

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

Desinfla o tamanho da área de separação especificada.

virtual void CalcRectEdit(CRect& rectEdit);

Parâmetros

rectEdit
[dentro] Um retângulo que especifica a área de um separador.

Observações

Este método é chamado quando se altera o rótulo de um separador. Este método desinfla os lados esquerdo e direito do retângulo especificado em metade da altura da aba atual, e desinfla o topo e a base em uma unidade.

CMFCTabCtrl::EnableActiveTabCloseButton

Mostra ou esconde um botão de Fechar ( X) no separador ativo.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parâmetros

bEnable
[dentro] TRUE para mostrar o botão Fechar no separador ativo; FALSE para mostrar o botão Fechar no canto superior direito da área do separador. O valor predefinido é TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Ativa ou desativa rótulos de separadores editáveis.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parâmetros

bEnable
[dentro] TRUE para ativar rótulos de separadores editáveis; FALSE para desativar etiquetas de separadores editáveis.

Observações

CMFCTabCtrl::EnableTabDocumentsMenu

Alterna entre uma interface de utilizador que usa dois botões para percorrer os separadores das janelas e uma interface que mostra um menu pop-up de janelas com separadores.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parâmetros

bEnable
[dentro] TRUE para mostrar um menu pop-up com etiquetas de janelas com separadores; FALSE para mostrar os botões de scroll para a frente e para trás. O valor predefinido é TRUE.

Observações

Quando o utilizador clica num rótulo de separador, o framework apresenta a janela correspondente com separadores. Se o rótulo do separador for visível, a janela com separador é aberta sem alterar a sua posição. Se o utilizador selecionar um documento no menu pop-up e a janela com separadores correspondente estiver fora do ecrã, a janela com separadores torna-se o primeiro separador.

CMFCTabCtrl::EnsureVisible

Garante que um separador é visível.

virtual BOOL EnsureVisible(int iTab);

Parâmetros

iTab
[dentro] O índice zero de uma tabulação.

Valor de retorno

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

Observações

Use este método para garantir que o separador especificado é visível. O controlo de tabulação desloca-se se for necessário.

CMFCTabCtrl::GetDocumentIcon

Recupera a imagem associada a um separador num menu pop-up de janelas com separadores.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parâmetros

nCmdID
[dentro] O ID de comando de um separador num menu pop-up de janelas com separadores.

Valor de retorno

A alça de uma imagem bitmap.

CMFCTabCtrl::GetFirstVisibleTabNum

Recupera o índice do primeiro separador que está visível no controlo de separador atual.

virtual int GetFirstVisibleTabNum() const;

Valor de retorno

O índice em base zero de um separador no controlo de separador.

Observações

Use este método apenas quando o controlo de tabulação estiver apresentado ao estilo do Microsoft OneNote. Use o CMFCTabCtrl::IsOneNoteStyle método para determinar o estilo.

CMFCTabCtrl::GetResizeMode

Recupera um valor que especifica como o controlo de tabulação atual pode ser redimensionado.

ResizeMode GetResizeMode() const;

Valor de retorno

Um dos CMFCTabCtrl::ResizeMode valores de enumeração que especifica como o controlo de tabulação pode ser redimensionado. Para uma lista de valores possíveis, consulte a secção Observações do CMFCTabCtrl::SetResizeMode método.

CMFCTabCtrl::GetScrollBar

Recupera um ponteiro para o objeto da barra de deslocamento associado ao controlo de tabulação.

CScrollBar* GetScrollBar();

Valor de retorno

Um apontador para um objeto na barra de deslocamento, ou se NULL o controlo tab não foi criado usando o STYLE_FLAT_SHARED_HORZ_SCROLL estilo.

Observações

Use este método para aceder à barra de scroll embutida no controlo de separador. Um objeto na barra de scroll só é criado quando o controlo de tabulação tem o estilo.STYLE_FLAT_SHARED_HORZ_SCROLL

CMFCTabCtrl::GetTabArea

Recupera o retângulo delimitador da área do rótulo de separador no topo ou na parte inferior do controlo de separador.

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

Parâmetros

rectTabAreaTop
[fora] Quando este método regressa, esta referência contém um retângulo que limita a área superior do rótulo do separador. O retângulo está nas coordenadas do cliente. Esta referência fica vazia se não existir uma área de rótulo de separador no topo do controlo de separador.

rectTabAreaBottom
[fora] Quando este método regressa, esta referência contém um retângulo que delimita a área inferior do rótulo do separador. O retângulo está nas coordenadas do cliente. Esta referência está vazia se não existir uma área de rótulo de separador na parte inferior do controlo de separador.

Observações

Use este método para determinar o tamanho e a posição da área do separador na janela separada.

CMFCTabCtrl::GetTabMaxWidth

Recupera a largura máxima de uma aba.

int GetTabMaxWidth() const;

Valor de retorno

Largura máxima de um separador, em pixels. Se o valor de retorno for 0, a largura do separador é ilimitada.

Observações

Use o método CMFCTabCtrl::SetTabMaxWidth para definir a largura máxima do separador.

CMFCTabCtrl::GetTabsHeight

Recupera a altura da área de separação do controlo de separador atual.

virtual int GetTabsHeight() const;

Valor de retorno

A altura da área do separador se algum separador for visível, ou zero se não houver separador visível.

CMFCTabCtrl::GetTabsRect

Recupera um retângulo que limita a área de tabulação do controlo de separador atual.

virtual void GetTabsRect(CRect& rect) const;

Parâmetros

rect
[fora] Quando este método retorna, o rect parâmetro contém um retângulo que limita a área da tabulação.

CMFCTabCtrl::GetWndArea

Recupera o limite da área do cliente do controlo de separação atual.

void GetWndArea(CRect& rect) const;

Parâmetros

rect
[inspira, expira] Quando este método retorna, este parâmetro contém um retângulo que limita o controlo de tabulação atual.

Observações

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Esconde a barra de deslocamento horizontal, se existir, na janela ativa.

void HideActiveWindowHorzScrollBar();

Observações

Use este método para evitar que o controlo de tabulação pisce quando o utilizador alterna entre páginas de controlo de separador.

CMFCTabCtrl::HideInactiveWindow

Especifica se o framework apresenta janelas de controlo de separadores inativas.

void HideInactiveWindow(BOOL bHide = TRUE);

Parâmetros

bHide
[dentro] TRUE não mostrar uma janela inativa; FALSE para mostrar uma janela inativa. O valor predefinido é TRUE.

Observações

CMFCTabCtrl::HideNoTabs

Ativa ou desativa o desenho da área do separador se não houver separadores visíveis.

void HideNoTabs(BOOL bHide=TRUE);

Parâmetros

bHide
[dentro] TRUE para permitir o desenho da área do separador; FALSE para desativar o desenho. O valor predefinido é TRUE.

Observações

CMFCTabCtrl::HideSingleTab

Ativa ou desativa o desenho de separadores se houver uma única janela com separador.

virtual void HideSingleTab(BOOL bHide=TRUE);

Parâmetros

bHide
[dentro] TRUE não desenhar um separador para uma única janela com separadores; FALSE para desenhar uma única tabulação. O valor padrão é TRUE.

Observações

CMFCTabCtrl::IsActiveInMDITabGroup

Indica se o separador atual de um controlo de separador é o separador ativo num grupo de separadores de múltiplos documentos da interface.

BOOL IsActiveInMDITabGroup() const;

Valor de retorno

TRUE se o separador atual de um controlo de separador for o separador ativo num grupo de separadores MDI; caso contrário, FALSE.

Observações

Pode organizar várias janelas de documentos em grupos de separadores verticais ou horizontais e facilmente embaralhar documentos de um grupo de separadores para outro.

CMFCTabCtrl::IsActiveTabBoldFont

Indica se o texto do separador ativo é apresentado usando uma fonte a negrito.

BOOL IsActiveTabBoldFont() const;

Valor de retorno

TRUE se o separador ativo for apresentado usando a fonte a negrito; caso contrário, FALSE.

Observações

Use o CMFCTabCtrl::SetActiveTabBoldFont método para alterar a fonte de separação ativa.

CMFCTabCtrl::IsActiveTabCloseButton

Indica se o botão Fechar ( X) é exibido num separador ativo ou no canto superior direito da área do separador.

virtual BOOL IsActiveTabCloseButton() const;

Valor de retorno

TRUE se o botão Fechar estiver apresentado no separador ativo; FALSE se o botão Fechar estiver apresentado no canto superior direito da área do separador.

Observações

CMFCTabCtrl::IsDrawFrame

Indica se a janela com abas desenha um retângulo de moldura em torno de painéis embutidos.

BOOL IsDrawFrame() const;

Valor de retorno

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

Observações

Use o CMFCTabCtrl::SetDrawFrame método para ativar ou desativar o desenho de um retângulo de frame.

CMFCTabCtrl::IsFlatFrame

Indica se a moldura à volta da área da aba é plana ou 3D.

BOOL IsFlatFrame() const;

Valor de retorno

TRUE se a estrutura em torno da área da aba for plana; FALSE se o enquadramento for tridimensional.

Observações

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

CMFCTabCtrl::IsFlatTab

Indica se a aparência dos separadores no controlo de separador atual é plana ou não.

virtual BOOL IsFlatTab() const;

Valor de retorno

TRUE se a aparência dos separadores no controlo de separador atual for plana; caso contrário, FALSE.

CMFCTabCtrl::IsLeftRightRounded

Indica se a aparência do lado esquerdo e direito de um separador no controlo atual do separador está arredondada.

virtual BOOL IsLeftRightRounded() const;

Valor de retorno

TRUE se os lados de cada aba forem arredondados; caso contrário, FALSE.

CMFCTabCtrl::IsMDITabGroup

Indica se o controlo de tabulação atual está contido na área do cliente de uma janela de interface com múltiplos documentos.

virtual BOOL IsMDITabGroup() const;

Valor de retorno

TRUE se o controlo de separador atual estiver numa janela de área cliente MDI; caso contrário, FALSE.

CMFCTabCtrl::IsOneNoteStyle

Indica se o controlo de separador atual está apresentado ao estilo do Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Valor de retorno

TRUE se o controlo de separador for exibido ao estilo do Microsoft OneNote; caso contrário, FALSE.

CMFCTabCtrl::IsSharedScroll

Indica se o controlo de separadores atual tem uma barra de deslocamento que possa deslocar os separadores como um grupo.

BOOL IsSharedScroll() const;

Valor de retorno

TRUE se o controlo de tabulação tiver uma barra de scroll partilhada; caso contrário, FALSE.

Observações

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

CMFCTabCtrl::IsTabDocumentsMenu

Indica se o controlo de separador mostra botões de scroll ou um botão que mostra um menu de janelas com separadores.

BOOL IsTabDocumentsMenu() const;

Valor de retorno

TRUE se as janelas com separadores forem deslocadas usando um menu pop-up com etiquetas de janelas por separadores; FALSE Se as janelas com separadores são deslocadas usando botões de deslocamento para a frente e para trás.

Observações

Use o CMFCTabCtrl::EnableTabDocumentsMenu método para especificar o método de deslocar janelas com separadores.

CMFCTabCtrl::IsVS2005Style

Indica se as tabulações são desenhadas usando o estilo do Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Valor de retorno

TRUE se as tabulações forem desenhadas no estilo do Visual Studio 2005; caso contrário, FALSE.

Observações

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

CMFCTabCtrl::m_bEnableActivate

Evita que a vista ativa perca o foco quando um novo separador é inserido e ativado.

static BOOL m_bEnableActivate;

Observações

O foco é normalmente ocupado por uma nova janela com separador quando o separador é inserido e ativado. Defina a CMFCTabCtrl::m_bEnableActivate variável membro para FALSE manter o foco original. O valor predefinido é TRUE.

CMFCTabCtrl::ModifyTabStyle

Especifica a aparência dos separadores no controlo de separadores atual.

BOOL ModifyTabStyle(Style style);

Parâmetros

style
[dentro] Um dos valores de enumeração que especifica a aparência do controlo de tabulação. Para mais informações, consulte a tabela em Observações.

Valor de retorno

Sempre TRUE.

Observações

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

CMFCTabCtrl::OnDragEnter

Chamado pelo framework durante uma operação de arrastar e largar, quando o cursor entra pela primeira vez na janela do controlo de separador atual.

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

Parâmetros

pDataObject
[dentro] Aponta para um objeto de dados que contém dados que o utilizador arrasta.

dwKeyState
[dentro] Contém o estado das teclas modificadoras. Este parâmetro é uma combinação bit a bit "ou" (|) dos seguintes valores: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON, e MK_RBUTTON. Para mais informações, consulte a secção Parâmetros de Mensagemde Sobre a Entrada do Rato.

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

Valor de retorno

Sempre DROPEFFECT_NONE, o que significa que o drop target não pode aceitar os dados.

Observações

Use este método para suportar uma operação de arrastar e largar. Anule este método para implementar o seu próprio comportamento personalizado.

Por defeito, este método só chama CMFCTabCtrl::OnDragOver, que devolve DROPEFFECT_NONEsempre .

CMFCTabCtrl::OnDragOver

Chamado pela estrutura durante uma operação de arrasto quando o rato é movido sobre a janela de drop target.

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

Parâmetros

pDataObject
[dentro] Aponta para um COleDataObject objeto que está a ser arrastado sobre o alvo de drop.

dwKeyState
[dentro] O estado das teclas modificadoras, que é uma combinação bit a bit "ou" (|) de MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON, e MK_RBUTTON. Para mais informações, consulte "Parâmetros da Mensagem" em Sobre a Entrada do Rato.

point
[dentro] A posição atual do rato.

Valor de retorno

Sempre DROPEFFECT_NONE.

Observações

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

CMFCTabCtrl::OnShowTabDocumentsMenu

Exibe um menu pop-up de janelas com separadores, espera até o utilizador selecionar um separador e torna o separador selecionado o separador ativo.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parâmetros

point
[dentro] As coordenadas de onde mostrar o menu pop-up.

Observações

CMFCTabCtrl::SetActiveInMDITabGroup

Define o separador atual de um controlo de separador como o separador ativo num grupo de separadores com múltiplos documentos de interface.

void SetActiveInMDITabGroup(BOOL bActive);

Parâmetros

bActive
[dentro] TRUE para tornar o separador atual o separador ativo; FALSE para tornar o separador atual inativo.

Observações

Pode organizar várias janelas de documentos em grupos de separadores verticais ou horizontais e facilmente embaralhar documentos de um grupo de separadores para outro.

CMFCTabCtrl::SetActiveTab

Ativa um separador.

virtual BOOL SetActiveTab(int iTab);

Parâmetros

iTab
[dentro] Especifica o índice baseado em zero do separador a ativar.

Valor de retorno

TRUE se o separador especificado foi ativado; FALSE se o valor do parâmetro especificado iTab for inválido.

Observações

Isto envia a AFX_WM_CHANGE_ACTIVE_TAB notificação para a janela pai e para o frame do pai do controlo de separador.

O SetActiveTab método chama automaticamente o CMFCTabCtrl::HideActiveWindowHorzScrollBar método para evitar que o ecrã pisce.

CMFCTabCtrl::SetActiveTabBoldFont

Permite ou desativa o uso de uma fonte a negrito em separadores ativos.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parâmetros

bIsBold
[dentro] TRUE usar uma fonte a negrito para mostrar o rótulo do separador ativo; FALSE para usar a fonte padrão para mostrar a etiqueta. O valor predefinido é TRUE.

Observações

CMFCTabCtrl::SetDrawFrame

Especifica se um retângulo de quadro é desenhado em torno de uma barra embutida.

void SetDrawFrame(BOOL bDraw=TRUE);

Parâmetros

bDraw
[dentro] TRUE para exibir um retângulo de moldura em torno de uma barra embutida; caso contrário, FALSE. O valor predefinido é TRUE.

Observações

CMFCTabCtrl::SetFlatFrame

Especifica se deve desenhar um quadro plano ou 3D à volta da área do separador.

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

Parâmetros

bFlat
[dentro] TRUE desenhar uma moldura plana (2D) em torno da área da separação; FALSE para desenhar um enquadramento tridimensional (3D). O valor predefinido é TRUE.

bRepaint
[dentro] TRUE redesenhar imediatamente a janela; caso contrário, FALSE. O valor predefinido é TRUE.

Observações

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
[dentro] O ID de um recurso bitmap que contém a lista de imagens.

cx
[dentro] A largura de cada imagem, em píxeis. O valor padrão é 15.

clrTransp
[dentro] A cor da imagem transparente. As partes da imagem que têm esta cor serão transparentes. O valor padrão é a cor magenta, RGB(255,0,255).

hImageList
[dentro] Um handle para uma lista de imagens pré-carregada.

Valor de retorno

TRUE Se este método for bem-sucedido. FALSE se o controlo de tabulação for criado usando um estilo plano ou se o primeiro método de sobrecarga não conseguir carregar o bitmap especificado pelo uiID parâmetro.

Observações

Use este método para definir uma lista de imagens para o controlo de tabulação. As imagens da lista de imagens são exibidas ao lado do rótulo do separador. Este método recalcula a altura do separador para que o separador seja dimensionado para conter tanto a imagem como o texto.

Use o CMFCBaseTabCtrl::AddTab método herdado pelo controlo de tabulação para especificar o índice da imagem a ser exibida.

CMFCTabCtrl::SetResizeMode

Especifica como o controlo de separação atual pode ser redimensionado e depois volta a mostrar o controlo.

void SetResizeMode(ResizeMode resizeMode);

Parâmetros

resizeMode
[dentro] Um dos CMFCTabCtrl::ResizeMode valores de enumeração que especifica como o controlo de tabulação pode ser redimensionado. Para uma lista de valores possíveis, consulte a tabela em Observações.

Observações

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

CMFCTabCtrl::SetTabMaxWidth

Especifica a largura máxima de separador numa janela com separadores.

void SetTabMaxWidth(int nTabMaxWidth);

Parâmetros

nTabMaxWidth
[dentro] A largura máxima do separador, em pixels.

Observações

Use este método para limitar a largura de cada aba numa janela separada. Este método é útil se os separadores tiverem etiquetas muito longas. O CMFCTabCtrl construtor de classes inicializa a largura máxima de tabulação para 0, o que na verdade significa que a largura não é limitada.

CMFCTabCtrl::StopResize

Termina a operação de redimensionamento atual no controlo de aba.

void StopResize(BOOL bCancel);

Parâmetros

bCancel
[dentro] TRUE abandonar a operação atual de redimensionamento; FALSE para completar a operação de redimensionamento atual. Em qualquer dos casos, a estrutura deixa de desenhar o retângulo de redimensionamento.

CMFCTabCtrl::SynchronizeScrollBar

Desenha uma barra de scroll horizontal num controlo de tabulação que mostra separadores planos.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parâmetros

pScrollInfo
[fora] Apontador para uma SCROLLINFO estrutura ou NULL. Quando este método retorna, e se este parâmetro não NULLfor , a estrutura contém todos os parâmetros da barra de deslocamento. O valor predefinido é NULL.

Valor de retorno

TRUE se este método tiver sucesso; caso contrário, FALSE.

Observações

Este método afeta apenas um controlo de separador que apresenta separadores planos. A barra de scroll influencia todos os separadores ao mesmo tempo.

Consulte também

Gráfico de Hierarquia
Classes
CDockablePane Classe
CMFCBaseTabCtrl Classe