Поделиться через


CMDITabInfo Class

The CMDITabInfo class is used to pass parameters to CMDIFrameWndEx::EnableMDITabbedGroups method. Задайте элементы этого класса, чтобы контролировать поведение групп вкладок MDI.

Syntax

class CMDITabInfo

Members

Public Constructors

Name Description
CMDITabInfo::CMDITabInfo Default constructor.

Public Methods

Name Description
CMDITabInfo::Serialize Считывает этот объект из архива или записывает в него.

Data Members

Name Description
CMDITabInfo::m_bActiveTabCloseButton; Specifies whether a Close button is displayed on the label of the active tab.
CMDITabInfo::m_bAutoColor Указывает, следует ли цветить вкладки MDI.
CMDITabInfo::m_bDocumentMenu Указывает, отображается ли в группе вкладок всплывающее меню, в котором отображается список открытых документов или отображаются кнопки прокрутки.
CMDITabInfo::m_bEnableTabSwap Указывает, может ли пользователь переключать позиции вкладок путем перетаскивания.
CMDITabInfo::m_bFlatFrame Указывает, имеют ли вкладки плоскую рамку.
CMDITabInfo::m_bTabCloseButton Specifies whether each tab label displays a Close button.
CMDITabInfo::m_bTabCustomTooltips Указывает, включены ли пользовательские подсказки.
CMDITabInfo::m_bTabIcons Указывает, следует ли отображать значки на вкладках MDI.
CMDITabInfo::m_nTabBorderSize Указывает размер границы каждого окна вкладки.
CMDITabInfo::m_style Задает стиль меток вкладок.
CMDITabInfo::m_tabLocation Указывает, расположены ли метки вкладок в верхней или нижней части страницы.

Remarks

Этот класс задает параметры групп вкладок MDI, создаваемых платформой.

Example

В следующем примере показано, как задать значения различных переменных-членов в 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);

Inheritance Hierarchy

CMDITabInfo

Requirements

Header: afxmdiclientareawnd.h

CMDITabInfo::m_bActiveTabCloseButton

Specifies whether a Close button is displayed on the label of the active tab.

BOOL m_bActiveTabCloseButton;

Remarks

If TRUE, the label of the active tab will display a Close button. The Close button will be removed from the right top corner of the tab area. Otherwise, the label of the active tab will not display a Close button. The Close button will appear in the right top corner of the tab area.

CMDITabInfo::m_bAutoColor

Указывает, имеет ли каждая вкладка MDI собственный цвет.

BOOL m_bAutoColor;

Remarks

Если значение TRUE, каждая вкладка будет иметь собственный цвет. Набор цветов управляется библиотекой MFC. В противном случае вкладки отображаются в белом цвете. Значение по умолчанию — FALSE.

CMDITabInfo::m_bDocumentMenu

Указывает, отображает ли каждая вкладка всплывающее меню, в котором отображается список открытых документов в правой части области вкладок.

BOOL m_bDocumentMenu;

Remarks

Если значение TRUE, каждое окно вкладок отображает всплывающее меню, в котором отображается список открытых документов в правой части области вкладок; В противном случае окно вкладки отображает кнопки прокрутки в правом краю области вкладок. Значение по умолчанию — FALSE.

CMDITabInfo::m_bEnableTabSwap

Указывает, может ли пользователь переключать позиции вкладок путем перетаскивания.

BOOL m_bEnableTabSwap;

Remarks

Если значение TRUE, пользователь может изменить позиции вкладок, перетащив вкладки. В противном случае пользователь не может изменить позиции вкладок. Значение по умолчанию — TRUE.

CMDITabInfo::m_bFlatFrame

Указывает, имеет ли каждое окно вкладки плоскую рамку.

BOOL m_bFlatFrame;

CMDITabInfo::m_bTabCloseButton

Specifies whether each tab window displays a Close button.

BOOL m_bTabCloseButton;

Remarks

If TRUE, each tab window displays the Close button on the right edge of the tab. Otherwise, the Close button is not displayed. Значение по умолчанию — TRUE.

CMDITabInfo::m_bTabCustomTooltips

Указывает, отображаются ли подсказки вкладок.

BOOL m_bTabCustomTooltips;

Remarks

Если значение TRUE, приложение отправляет AFX_WM_ON_GET_TAB_TOOLTIP сообщение в основной кадр. Это сообщение можно обрабатывать с помощью макроса ON_REGISTERED_MESSAGE.

CMDITabInfo::m_bTabIcons

Указывает, следует ли отображать значки на вкладках MDI.

BOOL m_bTabIcons;

Remarks

Если значение TRUE, значки отображаются на каждой вкладке MDI. В противном случае значки не отображаются на вкладках. Значение по умолчанию — FALSE.

CMDITabInfo::m_nTabBorderSize

Задает размер границы (в пикселях) каждого окна вкладки.

int m_nTabBorderSize;

Remarks

CMFCVisualManager::GetMDITabsBordersSize returns the default value.

CMDITabInfo::m_style

Задает стиль меток вкладок.

CMFCTabCtrl::Style m_style

Remarks

Укажите один из следующих стилей для меток вкладок:

Macro Description
STYLE_3D 3D style.
STYLE_3D_ONENOTE Стиль Microsoft OneNote.
STYLE_3D_VS2005 Стиль Microsoft Visual Studio 2005.
STYLE_3D_SCROLLED Трехмерный стиль с метками вкладок прямоугольника.
STYLE_FLAT_SHARED_HORZ_SCROLL Неструктурированный стиль с общим горизонтальным полосой прокрутки.
STYLE_3D_ROUNDED_SCROLL Трехмерный стиль с метками круглых вкладок.

CMDITabInfo::m_tabLocation

Указывает, расположены ли метки вкладок в верхней или нижней части страницы.

CMFCTabCtrl::Location m_tabLocation;

Remarks

Примените к вкладкам один из следующих флагов расположения:

  • LOCATION_BOTTOM: метки вкладок расположены в нижней части страницы.

  • LOCATION_TOP: метки вкладок расположены в верхней части страницы

CMDITabInfo::Serialize

Считывает или записывает этот объект из архива или архива.

void Serialize(CArchive& ar);

Parameters

ar
[in] A CArchive Class object to serialize.

See also

CMDIFrameWndEx Class
Группы с вкладками MDI
Hierarchy Chart
Classes