Compartilhar via


Classe CMDITabInfo

A classe CMDITabInfo é usada para passar parâmetros para o método CMDIFrameWndEx::EnableMDITabbedGroups. Defina membros dessa classe para controlar o comportamento de grupos com guias MDI.

Sintaxe

class CMDITabInfo

Membros

Construtores públicos

Nome Descrição
CMDITabInfo::CMDITabInfo Construtor padrão.

Métodos públicos

Nome Descrição
CMDITabInfo::Serialize Lê ou grava esse objeto de ou em uma camada de arquivos.

Membros de dados

Nome Descrição
CMDITabInfo::m_bActiveTabCloseButton; Especifica se um botão Fechar é exibido na etiqueta da guia ativa.
CMDITabInfo::m_bAutoColor Especifica se as guias MDI devem ser coloridas.
CMDITabInfo::m_bDocumentMenu Especifica se o grupo de guias exibe um menu pop-up que mostra uma lista de documentos abertos ou exibe botões de rolagem.
CMDITabInfo::m_bEnableTabSwap Especifica se o usuário pode trocar as posições das guias arrastando.
CMDITabInfo::m_bFlatFrame Especifica se as guias têm um quadro simples.
CMDITabInfo::m_bTabCloseButton Especifica se cada etiqueta de guia exibe um botão Fechar.
CMDITabInfo::m_bTabCustomTooltips Especifica se as dicas de ferramentas personalizadas estão habilitadas.
CMDITabInfo::m_bTabIcons Especifica se os ícones devem ser exibidos nas guias MDI.
CMDITabInfo::m_nTabBorderSize Especifica o tamanho da borda de cada janela de guia.
CMDITabInfo::m_style Especifica o estilo dos rótulos de guia.
CMDITabInfo::m_tabLocation Especifica se os rótulos de guias estão localizados na parte superior ou inferior da página.

Comentários

Essa classe especifica os parâmetros dos grupos de guias MDI que a estrutura cria.

Exemplo

O exemplo a seguir demonstra como definir os valores das várias variáveis de membro na classe CMDITabInfo.

CMDITabInfo mdiTabParams;
mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_ONENOTE;
// set to FALSE to place close button at right of tab area
mdiTabParams.m_bActiveTabCloseButton = FALSE;
// set to TRUE to enable document icons on MDI taba
mdiTabParams.m_bTabIcons = TRUE;
// set to FALSE to disable auto-coloring of MDI tabs
mdiTabParams.m_bAutoColor = FALSE;
// set to TRUE to enable the document menu at the right edge of the tab area
mdiTabParams.m_bDocumentMenu = TRUE;
//set to TRUE to enable the user to change the tabs positions by dragging the tabs
mdiTabParams.m_bEnableTabSwap = TRUE;
// set to TRUE to give each tab window has a flat frame
mdiTabParams.m_bFlatFrame = TRUE;
// set to TRUE to enable each tab window to display the Close button on the right edge of the tab.
mdiTabParams.m_bTabCloseButton = FALSE;
// set to TRUE to enable the tabs to display tooltips.
mdiTabParams.m_bTabCustomTooltips = TRUE;
// Specifies that the tabs labels are located at the top of the page
mdiTabParams.m_tabLocation = CMFCTabCtrl::LOCATION_TOP;
EnableMDITabbedGroups(TRUE, mdiTabParams);

Hierarquia de herança

CMDITabInfo

Requisitos

Cabeçalho: afxmdiclientareawnd.h

CMDITabInfo::m_bActiveTabCloseButton;

Especifica se um botão Fechar é exibido na etiqueta da guia ativa.

BOOL m_bActiveTabCloseButton;

Comentários

Se TRUE, a etiqueta da guia ativa exibirá um botão Fechar. O botão Fechar será removido do canto superior direito da área de guia. Caso contrário, a etiqueta da guia ativa não exibirá um botão Fechar. O botão Fechar aparecerá no canto superior direito da área de guia.

CMDITabInfo::m_bAutoColor

Especifica se cada guia MDI tem uma cor própria.

BOOL m_bAutoColor;

Comentários

Se TRUE, cada guia terá uma cor própria. O conjunto de cores é gerenciado pela biblioteca MFC. Caso contrário, as guias serão exibidas em branco. O valor padrão é FALSE.

CMDITabInfo::m_bDocumentMenu

Especifica se cada guia exibe um menu pop-up que mostra uma lista de documentos abertos na borda direita da área de guia.

BOOL m_bDocumentMenu;

Comentários

Se TRUE, cada janela de guia exibe um menu pop-up que mostra uma lista de documentos abertos na borda direita da área de guia. Caso contrário, a janela de guia exibirá botões de rolagem na borda direita da área de guia. O valor padrão é FALSE.

CMDITabInfo::m_bEnableTabSwap

Especifica se o usuário pode trocar as posições das guias arrastando.

BOOL m_bEnableTabSwap;

Comentários

Se TRUE, o usuário poderá alterar as posições das guias arrastando as guias. Caso contrário, o usuário não poderá alterar as posições das guias. O valor padrão é TRUE.

CMDITabInfo::m_bFlatFrame

Especifica se cada janela de guia tem um quadro simples.

BOOL m_bFlatFrame;

CMDITabInfo::m_bTabCloseButton

Especifica se cada janela de guia exibe um botão Fechar.

BOOL m_bTabCloseButton;

Comentários

Se TRUE, cada janela de guia exibirá o botão Fechar na borda direita da guia. Caso contrário, o botão Fechar não será exibido. O valor padrão é TRUE.

CMDITabInfo::m_bTabCustomTooltips

Especifica se as guias exibem dicas de ferramenta.

BOOL m_bTabCustomTooltips;

Comentários

Se TRUE, o aplicativo enviará uma mensagem AFX_WM_ON_GET_TAB_TOOLTIP para o quadro principal. Você pode lidar com essa mensagem usando a macro ON_REGISTERED_MESSAGE.

CMDITabInfo::m_bTabIcons

Especifica se os ícones devem ser exibidos nas guias MDI.

BOOL m_bTabIcons;

Comentários

Se TRUE, os ícones serão exibidos em cada guia MDI. Caso contrário, os ícones não serão exibidos nas guias. O valor padrão é FALSE.

CMDITabInfo::m_nTabBorderSize

Especifica o tamanho da borda, em pixels, de cada janela de guia.

int m_nTabBorderSize;

Comentários

CMFCVisualManager::GetMDITabsBordersSize retorna o valor padrão.

CMDITabInfo::m_style

Especifica o estilo dos rótulos de guia.

CMFCTabCtrl::Style m_style

Comentários

Especifique um dos seguintes estilos para os rótulos de guia:

Macro Descrição
STYLE_3D Estilo 3D.
STYLE_3D_ONENOTE Estilo do Microsoft OneNote.
STYLE_3D_VS2005 Estilo do Microsoft Visual Studio 2005.
STYLE_3D_SCROLLED Estilo 3D com rótulos de guia de retângulo.
STYLE_FLAT_SHARED_HORZ_SCROLL Estilo simples com barra de rolagem horizontal compartilhada.
STYLE_3D_ROUNDED_SCROLL Estilo 3D com rótulos de guias redondas.

CMDITabInfo::m_tabLocation

Especifica se os rótulos de guias estão localizados na parte superior ou inferior da página.

CMFCTabCtrl::Location m_tabLocation;

Comentários

Aplique às guias um dos seguintes sinalizadores de local:

  • LOCATION_BOTTOM: os rótulos de guias estão localizados na parte inferior da página.

  • LOCATION_TOP: os rótulos de guias estão localizados na parte superior da página

CMDITabInfo::Serialize

Lê ou grava esse objeto de um arquivo morto ou em um arquivo.

void Serialize(CArchive& ar);

Parâmetros

ar
[in] Um objeto da Classe CArchive a ser serializado.

Confira também

Classe CMDIFrameWndEx
Grupos com guias da MDI
Gráfico da hierarquia
Classes