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

Класс CMFCTabCtrl

  • Статья

Класс CMFCTabCtrl предоставляет функциональные возможности для элемента управления табуляции. Элемент управления "вкладка" отображает закрепляемое окно с плоскими или трехмерными вкладками в верхней или нижней части. Вкладки могут отображать текст и изображение и могут изменять цвет, когда активны.

Синтаксис

class CMFCTabCtrl : public CMFCBaseTabCtrl

Участники

Открытые конструкторы

Имя Описание
CMFCTabCtrl::CMFCTabCtrl Конструктор по умолчанию.
CMFCTabCtrl::~CMFCTabCtrl Деструктор.

Открытые методы

Имя Описание
CMFCTabCtrl::ActivateMDITab Отображает указанную вкладку текущего элемента управления вкладки и задает фокус на этой вкладке.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow Указывает, следует ли изменять размер клиентской области всех окон управления вкладками при изменении элемента пользовательского интерфейса элемента элемента управления вкладок.
CMFCTabCtrl::CalcRectEdit Дефляции размера указанной области табуляции. (Переопределяет CMFCBaseTabCtrl::CalcRectEdit.)
CMFCTabCtrl::Create Создает элемент управления tab и присоединяет его к объекту CMFCTabCtrl .
CMFCTabCtrl::CreateObject Используется платформой для создания динамического экземпляра этого типа класса.
CMFCTabCtrl::EnableActiveTabCloseButton Отображает или скрывает кнопку "Закрыть" ( X) на активной вкладке.
CMFCTabCtrl::EnableInPlaceEdit Включает или отключает редактируемые метки вкладок. (Переопределяет CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu Заменяет две кнопки, которые прокручивают вкладки окна кнопкой, которая открывает меню вкладок окон.
CMFCTabCtrl::EnsureVisible Гарантирует, что вкладка отображается.
CMFCTabCtrl::GetDocumentIcon Извлекает символ, связанный с вкладкой в всплывающем меню в окнах с вкладками.
CMFCTabCtrl::GetFirstVisibleTabNum Извлекает индекс первой вкладки, видимой в текущем элементе управления вкладки.
CMFCTabCtrl::GetResizeMode Извлекает значение, указывающее, как можно изменить размер текущего элемента управления вкладки.
CMFCTabCtrl::GetScrollBar Извлекает указатель на объект полосы прокрутки, связанный с элементом управления tab.
CMFCTabCtrl::GetTabArea Извлекает ограничивающий прямоугольник области метки табуляции в верхней или нижней части элемента управления табуляции. (Переопределяет CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint Извлекает вкладку, содержащую указанную точку. (Переопределяет CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth Извлекает максимальную ширину вкладки.
CMFCTabCtrl::GetTabsHeight Извлекает высоту области вкладок текущего элемента управления табуляции.
CMFCTabCtrl::GetTabsRect Извлекает прямоугольник, ограничивающий область вкладок текущего элемента управления табуляции. (Переопределяет CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass Используется платформой для получения указателя на CRuntimeClass объект, связанный с этим типом класса.
CMFCTabCtrl::GetWndArea Извлекает границу клиентской области текущего элемента управления tab.
CMFCTabCtrl::HideActiveWindowHorzScrollBar Скрывает горизонтальную полосу прокрутки, если она есть, активного окна.
CMFCTabCtrl::HideInactiveWindow Указывает, должна ли платформа отображать неактивные окна управления вкладками.
CMFCTabCtrl::HideNoTabs Включает или отключает рисование области вкладок, если видимые вкладки отсутствуют.
CMFCTabCtrl::HideSingleTab Включает или отключает рисование вкладки при наличии одного окна табуляции. (Переопределяет CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup Указывает, является ли текущая вкладка элемента управления вкладкой активной в группе вкладок нескольких интерфейсов документов.
CMFCTabCtrl::IsActiveTabBoldFont Указывает, отображается ли текст активной вкладки с помощью полужирного шрифта.
CMFCTabCtrl::IsActiveTabCloseButton Указывает, отображается ли кнопка "Закрыть" ( X) на активной вкладке или в правом верхнем углу области вкладок.
CMFCTabCtrl::IsDrawFrame Указывает, рисует ли окно табуляции прямоугольник кадра вокруг внедренных панелей.
CMFCTabCtrl::IsFlatFrame Указывает, является ли кадр вокруг области вкладок неструктурированным или трехмерным.
CMFCTabCtrl::IsFlatTab Указывает, является ли внешний вид вкладок в текущем элементе управления табуляции неструктурированным или нет.
CMFCTabCtrl::IsLeftRightRounded Указывает, округляется ли внешний вид левой и правой стороны вкладки в текущем элементе управления вкладки.
CMFCTabCtrl::IsMDITabGroup Указывает, содержится ли текущий элемент управления вкладки в клиентской области окна интерфейса с несколькими документами.
CMFCTabCtrl::IsOneNoteStyle Указывает, отображается ли текущий элемент управления вкладки в стиле Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea Определяет, находится ли точка внутри области вкладок. (Переопределяет CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll Указывает, имеет ли текущий элемент управления вкладки полосу прокрутки, которая может прокручивать ее вкладки в виде группы.
CMFCTabCtrl::IsTabDocumentsMenu Указывает, отображает ли элемент управления вкладки кнопки прокрутки или кнопку, отображающую меню вкладок.
CMFCTabCtrl::IsVS2005Style Указывает, отображаются ли вкладки в стиле Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle Указывает внешний вид вкладок в текущем элементе управления табуляции.
CMFCTabCtrl::MoveTab Перемещает вкладку на другую позицию вкладки. (Переопределяет CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter Вызывается платформой при первом перетаскивании курсора в окно управления вкладкой.
CMFCTabCtrl::OnDragOver Вызывается платформой во время операции перетаскивания при перемещении мыши по окне целевого объекта удаления. (Переопределяет CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu Отображает всплывающее меню в окнах с вкладками, ожидает, пока пользователь не выберет вкладку и сделает выбранную вкладку активной вкладкой.
CMFCTabCtrl::PreTranslateMessage Преобразует сообщения окна перед их отправкой TranslateMessage в функции Windows и DispatchMessage windows. (Переопределяет CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout Повторно вычисляет внутренний макет набора вкладок. (Переопределяет CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup Задает текущую вкладку элемента управления вкладки в качестве активной вкладки в группе вкладок нескольких интерфейсов документов.
CMFCTabCtrl::SetActiveTab Активирует вкладку. (Переопределяет CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont Включает или отключает использование полужирного шрифта на активных вкладках.
CMFCTabCtrl::SetDrawFrame Включает или отключает рисование прямоугольника кадра вокруг встроенной панели.
CMFCTabCtrl::SetFlatFrame Указывает, следует ли нарисовать плоскую или трехмерную рамку вокруг области вкладок.
CMFCTabCtrl::SetImageList Указывает список изображений. (Переопределяет CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode Указывает, как можно изменить размер текущего элемента управления табуляции, а затем повторно воспроизвести элемент управления.
CMFCTabCtrl::SetTabMaxWidth Указывает максимальную ширину вкладки в окне табуляции.
CMFCTabCtrl::StopResize Завершает текущую операцию изменения размера в элементе управления табуляции.
CMFCTabCtrl::SwapTabs Переключает пару вкладок. (Переопределяет CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar Рисует горизонтальную полосу прокрутки на элементе управления табуляции, где отображаются плоские вкладки.

Элементы данных

Имя Описание
CMFCTabCtrl::m_bEnableActivate Запрещает активное представление потерять фокус при вставке и включении новой вкладки.

Замечания

Класс поддерживает следующее CMFCTabCtrl :

  • Стили элементов управления tab, включающие трехмерный, плоский и плоский с общим горизонтальным полосой прокрутки.

  • Вкладки, расположенные в верхней или нижней части окна.

  • Вкладки, отображающие текст, изображения или изображения.

  • Вкладки, изменяющие цвет при активной вкладке.

  • Изменения размера границы для настраиваемых вкладок.

  • Отсоединяемые окна вкладок.

Класс CMFCTabCtrl можно использовать с диалоговым окном, но предназначен для приложений, использующих панели управления закреплением, такие как Microsoft Excel и Visual Studio. Дополнительные сведения см. в разделе CDockablePane "Класс".

Выполните следующие действия, чтобы добавить элемент управления табуляции с изменением размера в приложении:

  1. Создайте экземпляр CTabbedPane класса.

  2. Вызовите процедуру CDockablePane::Create.

  3. Используйте CBaseTabbedPane::AddTab или CMFCBaseTabCtrl::InsertTab добавьте новые вкладки.

  4. Вызовите CBasePane::EnableDocking , чтобы текущий элемент управления вкладки закрепления можно было закрепить в главном окне кадра.

  5. Вызов CFrameWndEx::DockPane для закрепления окна с вкладками в главном кадре.

Пример создания окна табуляции в качестве панели управления закреплением см. в разделе CTabbedPane "Класс". Чтобы использовать CMFCTabCtrl в качестве элемента управления, отличного от закрепления, создайте CMFCTabCtrl объект и вызовите CMFCTabCtrl::Create.

Иерархия наследования

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Пример

В следующем примере показано, как использовать различные методы в CMFCTabCtrl классе для настройки CMFCTabCtrl объекта. В примере объясняется, как добавить вкладку, отобразить кнопку "Закрыть" на активной вкладке, включить редактируемые метки вкладок и отобразить всплывающее меню меток окна с вкладками. Этот пример является частью примера коллекции состояний.

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

Требования

Заголовок: afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Отображает указанную вкладку текущего элемента управления вкладки и задает фокус на этой вкладке.

void ActivateMDITab(int nTab = -1);

Параметры

nTab
[in] Отсчитываемый от нуля индекс отображаемой вкладки или -1, чтобы указать текущую активную вкладку.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Дополнительные сведения см. в исходном коде, расположенном в папке mfc установки Visual Studio. Например, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Возвращаемое значение

ВсегдаTRUE.

Замечания

CMFCTabCtrl::AutoSizeWindow

Указывает, следует ли изменять размер клиентской области всех окон управления вкладками при изменении элемента пользовательского интерфейса элемента элемента управления вкладок.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Параметры

bAutoSize
[in] TRUE для автоматического изменения размера окон элементов управления вкладками; FALSEв противном случае . Значение по умолчанию — TRUE.

Замечания

CMFCTabCtrl::Create

Создает элемент управления tab и присоединяет его к объекту CMFCTabCtrl .

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

Параметры

style
[in] Стиль элемента управления tab. Дополнительные сведения см. в подразделе "Примечания".

rect
[in] Прямоугольник, ограничивающий элемент управления tab.

pParentWnd
[in] Указатель на родительское окно. Значение не должно быть равно NULL.

nID
[in] Идентификатор элемента управления tab.

location
[in] Расположение вкладок. Значение по умолчанию — LOCATION_BOTTOM. Дополнительные сведения см. в разделе Замечания.

bCloseBtn
[in] TRUE чтобы отобразить кнопку закрытия на вкладке; FALSEв противном случае . Значение по умолчанию — FALSE.

Возвращаемое значение

Значение TRUE при успешном завершении. В противном случае — значение FALSE.

Замечания

В следующей таблице описаны значения, которые можно указать для style параметра.

Стиль Description
STYLE_3D Создает элемент управления tab с трехмерным внешним видом.
STYLE_FLAT Создает элемент управления tab с неструктурированными вкладками.
STYLE_FLAT_SHARED_HORZ_SCROLL Создает элемент управления табуляции с неструктурированными вкладками и полосой прокрутки, которая может прокручивать вкладки, если они обрезаются родительским окном.
STYLE_3D_ONENOTE Создает элемент управления tab в стиле Microsoft OneNote.
STYLE_3D_VS2005 Создает элемент управления tab в стиле Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED Создает элемент управления tab с округленными вкладками в стиле Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL Создает элемент управления tab с округленными вкладками и кнопками прокрутки в стиле Microsoft Visual Studio 2005.

В следующей location таблице перечислены значения, которые можно указать для параметра.

Расположение Description
LOCATION_BOTTOM Вкладки расположены в нижней части элемента управления табуляции.
LOCATION_TOP Вкладки расположены в верхней части элемента управления табуляции.

Пример

В следующем примере показано, как использовать Create метод в CMFCTabCtrl классе. Этот пример является частью примера коллекции состояний.

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

Дефляции размера указанной области табуляции.

virtual void CalcRectEdit(CRect& rectEdit);

Параметры

rectEdit
[in] Прямоугольник, указывающий область вкладки.

Замечания

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

CMFCTabCtrl::EnableActiveTabCloseButton

Отображает или скрывает кнопку "Закрыть " ( X) на активной вкладке.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Параметры

bEnable
[in] TRUE Чтобы отобразить кнопку "Закрыть" на активной вкладке; FALSE чтобы отобразить кнопку "Закрыть" в правом верхнем углу области вкладки. Значение по умолчанию — TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Включает или отключает редактируемые метки вкладок.

virtual void EnableInPlaceEdit(BOOL bEnable);

Параметры

bEnable
[in] TRUE для включения редактируемых меток вкладок; FALSE чтобы отключить редактируемые метки вкладок.

Замечания

CMFCTabCtrl::EnableTabDocumentsMenu

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

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Параметры

bEnable
[in] TRUE для отображения всплывающего меню меток окна с вкладками; FALSE для отображения кнопок прокрутки вперед и назад. Значение по умолчанию — TRUE.

Замечания

Когда пользователь щелкает метку вкладки, платформа отображает соответствующее окно с вкладками. Если метка вкладки видна, окно с вкладками открывается, не изменяя его положение. Если пользователь выбирает документ из всплывающего меню, а соответствующее окно с вкладками находится вне экрана, окно с вкладками становится первой вкладкой.

CMFCTabCtrl::EnsureVisible

Гарантирует, что вкладка отображается.

virtual BOOL EnsureVisible(int iTab);

Параметры

iTab
[in] Отсчитываемый от нуля индекс вкладки.

Возвращаемое значение

TRUE Значение , если это успешно; FALSE Значение , iTab если индекс параметров недопустим.

Замечания

Используйте этот метод, чтобы гарантировать, что указанная вкладка видна. Если это необходимо, элемент управления вкладки будет прокручиваться.

CMFCTabCtrl::GetDocumentIcon

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

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Параметры

nCmdID
[in] Идентификатор команды вкладки во всплывающем меню окон с вкладками.

Возвращаемое значение

Дескриптор растрового изображения.

CMFCTabCtrl::GetFirstVisibleTabNum

Извлекает индекс первой вкладки, видимой в текущем элементе управления вкладки.

virtual int GetFirstVisibleTabNum() const;

Возвращаемое значение

Отсчитываемый от нуля индекс вкладки в элементе управления tab.

Замечания

Используйте этот метод, только если элемент управления вкладки отображается в стиле Microsoft OneNote. CMFCTabCtrl::IsOneNoteStyle Используйте метод для определения стиля.

CMFCTabCtrl::GetResizeMode

Извлекает значение, указывающее, как можно изменить размер текущего элемента управления вкладки.

ResizeMode GetResizeMode() const;

Возвращаемое значение

Одно из CMFCTabCtrl::ResizeMode значений перечисления, указывающее, как можно изменить размер элемента управления табуляции. Список возможных значений см. в разделе "Примечания" CMFCTabCtrl::SetResizeMode метода.

CMFCTabCtrl::GetScrollBar

Извлекает указатель на объект полосы прокрутки, связанный с элементом управления tab.

CScrollBar* GetScrollBar();

Возвращаемое значение

Указатель на объект полосы прокрутки или NULL элемент управления tab не был создан с помощью STYLE_FLAT_SHARED_HORZ_SCROLL стиля.

Замечания

Используйте этот метод для доступа к внедренной полосе прокрутки элемента управления tab. Объект полосы прокрутки создается только в том случае, если элемент управления tab имеет STYLE_FLAT_SHARED_HORZ_SCROLL стиль.

CMFCTabCtrl::GetTabArea

Извлекает ограничивающий прямоугольник области метки табуляции в верхней или нижней части элемента управления табуляции.

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

Параметры

rectTabAreaTop
[out] При возврате этого метода эта ссылка содержит прямоугольник, ограничивающий верхнюю область меток табуляции. Прямоугольник находится в координатах клиента. Эта ссылка пуста, если область меток вкладки не существует в верхней части элемента управления вкладки.

rectTabAreaBottom
[out] При возврате этого метода эта ссылка содержит прямоугольник, ограничивающий область метки нижней вкладки. Прямоугольник находится в координатах клиента. Эта ссылка пуста, если область меток вкладки отсутствует в нижней части элемента управления вкладки.

Замечания

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

CMFCTabCtrl::GetTabMaxWidth

Извлекает максимальную ширину вкладки.

int GetTabMaxWidth() const;

Возвращаемое значение

Максимальная ширина вкладки в пикселях. Если возвращаемое значение равно 0, ширина вкладки не ограничена.

Замечания

Используйте метод CMFCTabCtrl::SetTabMaxWidth, чтобы задать максимальную ширину табуляции.

CMFCTabCtrl::GetTabsHeight

Извлекает высоту области вкладок текущего элемента управления табуляции.

virtual int GetTabsHeight() const;

Возвращаемое значение

Высота области вкладок, если какая-либо вкладка видна, или ноль, если вкладка не отображается.

CMFCTabCtrl::GetTabsRect

Извлекает прямоугольник, ограничивающий область вкладок текущего элемента управления табуляции.

virtual void GetTabsRect(CRect& rect) const;

Параметры

rect
[out] При возврате rect этого метода параметр содержит прямоугольник, ограничивающий область вкладок.

CMFCTabCtrl::GetWndArea

Извлекает границу клиентской области текущего элемента управления tab.

void GetWndArea(CRect& rect) const;

Параметры

rect
[in, out] При возврате этого метода этот параметр содержит прямоугольник, ограничивающий текущий элемент управления tab.

Замечания

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Скрывает горизонтальную полосу прокрутки в активном окне.

void HideActiveWindowHorzScrollBar();

Замечания

Используйте этот метод, чтобы запретить элементу управления tab мигать, когда пользователь переключается между страницами элементов управления вкладками.

CMFCTabCtrl::HideInactiveWindow

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

void HideInactiveWindow(BOOL bHide = TRUE);

Параметры

bHide
[in] TRUE не отображать неактивное окно; FALSE для отображения неактивного окна. Значение по умолчанию — TRUE.

Замечания

CMFCTabCtrl::HideNoTabs

Включает или отключает рисование области вкладок, если видимые вкладки отсутствуют.

void HideNoTabs(BOOL bHide=TRUE);

Параметры

bHide
[in] TRUE для включения рисования области вкладок; FALSE , чтобы отключить рисование. Значение по умолчанию — TRUE.

Замечания

CMFCTabCtrl::HideSingleTab

Включает или отключает рисование вкладок, если есть одно окно с вкладками.

virtual void HideSingleTab(BOOL bHide=TRUE);

Параметры

bHide
[in] TRUE Чтобы не нарисовать вкладку для одного окна с вкладками; FALSE чтобы нарисовать одну вкладку. Значение по умолчанию — TRUE.

Замечания

CMFCTabCtrl::IsActiveInMDITabGroup

Указывает, является ли текущая вкладка элемента управления вкладкой активной в группе вкладок нескольких интерфейсов документов.

BOOL IsActiveInMDITabGroup() const;

Возвращаемое значение

TRUE Значение , если текущая вкладка элемента управления вкладкой является активной в группе вкладок MDI; FALSEв противном случае .

Замечания

Можно упорядочить несколько окон документов в вертикальные или горизонтальные группы вкладок и легко перемешивать документы из одной группы вкладок в другую.

CMFCTabCtrl::IsActiveTabBoldFont

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

BOOL IsActiveTabBoldFont() const;

Возвращаемое значение

TRUE Значение , если активная вкладка отображается с помощью полужирного шрифта; FALSEв противном случае .

Замечания

CMFCTabCtrl::SetActiveTabBoldFont Используйте метод для изменения активного шрифта табуляции.

CMFCTabCtrl::IsActiveTabCloseButton

Указывает, отображается ли кнопка "Закрыть " ( X) на активной вкладке или в правом верхнем углу области вкладок.

virtual BOOL IsActiveTabCloseButton() const;

Возвращаемое значение

TRUEЗначение , если кнопка "Закрыть" отображается на активной вкладке; FALSE если кнопка "Закрыть" отображается в правом верхнем углу области вкладок.

Замечания

CMFCTabCtrl::IsDrawFrame

Указывает, рисует ли окно табуляции прямоугольник кадра вокруг внедренных панелей.

BOOL IsDrawFrame() const;

Возвращаемое значение

TRUE Значение , если прямоугольник кадра рисуется; FALSEв противном случае .

Замечания

Используйте метод, чтобы включить или отключить рисование CMFCTabCtrl::SetDrawFrame прямоугольника кадра.

CMFCTabCtrl::IsFlatFrame

Указывает, является ли кадр вокруг области вкладок неструктурированным или трехмерным.

BOOL IsFlatFrame() const;

Возвращаемое значение

TRUE Значение ,если рамка вокруг области вкладок неструктурна; FALSE Значение ,если кадр является трехмерным.

Замечания

CMFCTabCtrl::SetFlatFrame Используйте метод, чтобы изменить способ рисования кадра.

CMFCTabCtrl::IsFlatTab

Указывает, является ли внешний вид вкладок в текущем элементе управления табуляции неструктурированным или нет.

virtual BOOL IsFlatTab() const;

Возвращаемое значение

TRUE Если внешний вид вкладок в текущем элементе управления вкладками неструктурен; FALSEв противном случае .

CMFCTabCtrl::IsLeftRightRounded

Указывает, округляется ли внешний вид левой и правой стороны вкладки в текущем элементе управления вкладки.

virtual BOOL IsLeftRightRounded() const;

Возвращаемое значение

TRUE Если стороны каждой вкладки округляются; FALSEв противном случае .

CMFCTabCtrl::IsMDITabGroup

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

virtual BOOL IsMDITabGroup() const;

Возвращаемое значение

TRUE Значение , если текущий элемент управления вкладкой находится в окне клиентской области MDI; FALSEв противном случае .

CMFCTabCtrl::IsOneNoteStyle

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

virtual BOOL IsOneNoteStyle() const;

Возвращаемое значение

TRUE Значение , если элемент управления вкладкой отображается в стиле Microsoft OneNote; FALSEв противном случае .

CMFCTabCtrl::IsSharedScroll

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

BOOL IsSharedScroll() const;

Возвращаемое значение

TRUE Значение , если элемент управления вкладки имеет общую полосу прокрутки; FALSEв противном случае .

Замечания

Этот метод возвращает значениеTRUE, если параметр CMFCTabCtrl::Create метода имеет значение STYLE_FLAT_SHARED_HORZ_SCROLLstyle .

CMFCTabCtrl::IsTabDocumentsMenu

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

BOOL IsTabDocumentsMenu() const;

Возвращаемое значение

TRUE Если окна с вкладками прокручиваются с помощью всплывающего меню меток с вкладками; FALSE Если окна с вкладками прокручиваются с помощью кнопок прокрутки вперед и назад.

Замечания

CMFCTabCtrl::EnableTabDocumentsMenu Используйте метод, чтобы указать метод прокрутки на вкладках окон.

CMFCTabCtrl::IsVS2005Style

Указывает, нарисуются ли вкладки с помощью стиля Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Возвращаемое значение

TRUE Значение , если вкладки рисуются с помощью стиля Visual Studio 2005; FALSEв противном случае .

Замечания

style Используйте параметр метода, чтобы указать способ рисования CMFCTabCtrl::Create вкладок.

CMFCTabCtrl::m_bEnableActivate

Запрещает активное представление потерять фокус при вставке и включении новой вкладки.

static BOOL m_bEnableActivate;

Замечания

Фокус обычно принимается новым окном табуляции, когда вкладка вставлена и активна. Задайте переменную-член, CMFCTabCtrl::m_bEnableActivate чтобы FALSE сохранить исходный фокус. Значение по умолчанию — TRUE.

CMFCTabCtrl::ModifyTabStyle

Указывает внешний вид вкладок в текущем элементе управления табуляции.

BOOL ModifyTabStyle(Style style);

Параметры

style
[in] Одно из значений перечисления, указывающее внешний вид элемента управления tab. Дополнительные сведения см. в таблице в примечаниях.

Возвращаемое значение

ВсегдаTRUE.

Замечания

Значение style параметра может быть одним из следующих CMFCTabCtrl::Style перечислений.

Имя Описание
STYLE_3D Отображает трехмерные прямоугольные вкладки с круглыми углами.
STYLE_3D_ONENOTE Отображает трехмерные вкладки с одной вертикальной стороной и одной косой стороной и с округленными углами.
STYLE_3D_ROUNDED Отображает трехмерные вкладки с косыми сторонами и скругленными углами.
STYLE_3D_ROUNDED_SCROLL Отображает трехмерные вкладки с косыми сторонами и скругленными углами. Если одновременно отображается больше вкладок, чем может отображаться, платформа отображает раскрывающийся список со стрелкой и меню вкладок, чтобы сделать активным.
STYLE_3D_SCROLLED Отображает трехмерные прямоугольные вкладки. Если одновременно отображается больше вкладок, чем может отображаться, платформа отображает раскрывающийся список со стрелкой и меню вкладок, чтобы сделать активным.
STYLE_3D_VS2005 Отображает трехмерные, округленные вкладки с одной косой стороной и одной вертикальной стороной.
STYLE_FLAT Отображает двухмерные вкладки с косыми левыми и правыми сторонами.
STYLE_FLAT_SHARED_HORZ_SCROLL Отображает двухмерные вкладки. Если одновременно отображается больше вкладок, чем может отображаться, платформа отображает стрелки прокрутки в концах области вкладок.

CMFCTabCtrl::OnDragEnter

Вызывается платформой во время операции перетаскивания при первом вводе курсора в окно текущего элемента управления табуляции.

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

Параметры

pDataObject
[in] Указывает на объект данных, содержащий данные, перетаскиваемые пользователем.

dwKeyState
[in] Содержит состояние ключей модификатора. Этот параметр представляет собой побитовое сочетание "or" (|) следующих значений: MK_CONTROL, MK_SHIFT, , MK_LBUTTONMK_ALT, MK_MBUTTONи MK_RBUTTON. Дополнительные сведения см. в разделе "Параметры сообщения" в разделе "Сведения о вводе мыши".

point
[in] Содержит текущее расположение курсора в координатах клиента.

Возвращаемое значение

Всегда DROPEFFECT_NONE, что означает, что целевой объект удаления не может принимать данные.

Замечания

Используйте этот метод для поддержки операции перетаскивания. Переопределите этот метод для реализации собственного пользовательского поведения.

По умолчанию этот метод вызывает CMFCTabCtrl::OnDragOverтолько вызовы, которые всегда возвращаются DROPEFFECT_NONE.

CMFCTabCtrl::OnDragOver

Вызывается платформой во время операции перетаскивания при перемещении мыши по окне целевого объекта удаления.

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

Параметры

pDataObject
[in] Указатель на COleDataObject объект, перетаскиваемый по целевому объекту перетаскивания.

dwKeyState
[in] Состояние клавиш модификатора, которое является побитовой комбинацией "или" (|) MK_CONTROLиз , , MK_SHIFT, MK_ALT, MK_MBUTTONMK_LBUTTONи MK_RBUTTON. Дополнительные сведения см. в разделе "Параметры сообщения" в разделе "Сведения о вводе мыши".

point
[in] Текущая позиция мыши.

Возвращаемое значение

ВсегдаDROPEFFECT_NONE.

Замечания

Переопределите этот метод с помощью пользовательской реализации. Дополнительные сведения см. в описании метода CView::OnDragOver.

CMFCTabCtrl::OnShowTabDocumentsMenu

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

virtual void OnShowTabDocumentsMenu(CPoint point);

Параметры

point
[in] Координаты того, где будет отображаться всплывающее меню.

Замечания

CMFCTabCtrl::SetActiveInMDITabGroup

Задает текущую вкладку элемента управления вкладки в качестве активной вкладки в группе вкладок нескольких интерфейсов документов.

void SetActiveInMDITabGroup(BOOL bActive);

Параметры

bActive
[in] TRUE Чтобы сделать текущую вкладку активной вкладкой; FALSE Чтобы сделать текущую вкладку неактивной.

Замечания

Можно упорядочить несколько окон документов в вертикальные или горизонтальные группы вкладок и легко перемешивать документы из одной группы вкладок в другую.

CMFCTabCtrl::SetActiveTab

Активирует вкладку.

virtual BOOL SetActiveTab(int iTab);

Параметры

iTab
[in] Указывает отсчитываемый от нуля индекс вкладки для активации.

Возвращаемое значение

TRUE Значение FALSE Значение указанного iTab параметра недопустимо.

Замечания

Это отправляет AFX_WM_CHANGE_ACTIVE_TAB уведомление в родительское окно и кадр родительского элемента управления вкладки.

Метод SetActiveTab автоматически вызывает CMFCTabCtrl::HideActiveWindowHorzScrollBar метод, чтобы предотвратить мигание экрана.

CMFCTabCtrl::SetActiveTabBoldFont

Включает или отключает использование полужирного шрифта на активных вкладках.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Параметры

bIsBold
[in] TRUE чтобы использовать полужирный шрифт для отображения метки активной вкладки; FALSE чтобы использовать стандартный шрифт для отображения метки. Значение по умолчанию — TRUE.

Замечания

CMFCTabCtrl::SetDrawFrame

Указывает, рисуется ли прямоугольник кадра вокруг встроенной панели.

void SetDrawFrame(BOOL bDraw=TRUE);

Параметры

bDraw
[in] TRUE для отображения прямоугольника кадра вокруг внедренной панели; FALSEв противном случае . Значение по умолчанию — TRUE.

Замечания

CMFCTabCtrl::SetFlatFrame

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

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

Параметры

bFlat
[in] TRUE чтобы нарисовать плоскую рамку (2D) вокруг области вкладок; FALSE для рисования трехмерного кадра. Значение по умолчанию — TRUE.

bRepaint
[in] TRUE для немедленного перерасхода окна; FALSEв противном случае . Значение по умолчанию — TRUE.

Замечания

CMFCTabCtrl::SetImageList

Указывает список изображений.

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

virtual BOOL SetImageList(HIMAGELIST hImageList);

Параметры

uiID
[in] Идентификатор ресурса растрового изображения, содержащего список изображений.

cx
[in] Ширина каждого изображения в пикселях. Значение по умолчанию ― 15.

clrTransp
[in] Цвет прозрачного изображения. Части изображения, которые являются этим цветом, будут прозрачными. Значением по умолчанию является цветная магента, RGB(255,0,255).

hImageList
[in] Дескриптор списка предварительно загруженных изображений.

Возвращаемое значение

TRUE Если этот метод выполнен успешно. FALSE Значение , если элемент управления табуляции создается с помощью неструктурированного стиля или если первая перегрузка метода не может загрузить растровое изображение, указанное параметром uiID .

Замечания

Используйте этот метод, чтобы задать список изображений для элемента управления tab. Изображения из списка изображений отображаются рядом с меткой вкладки. Этот метод пересчитывает высоту табуляции, чтобы вкладка была размером как изображения, так и текста.

CMFCBaseTabCtrl::AddTab Используйте метод, унаследованный элементом управления tab, чтобы указать индекс отображаемого изображения.

CMFCTabCtrl::SetResizeMode

Указывает, как можно изменить размер текущего элемента управления табуляции, а затем повторно воспроизвести элемент управления.

void SetResizeMode(ResizeMode resizeMode);

Параметры

resizeMode
[in] Одно из CMFCTabCtrl::ResizeMode значений перечисления, указывающее, как можно изменить размер элемента управления табуляции. Список возможных значений см. в таблице в примечаниях.

Замечания

Параметр resizeMode может быть одним из следующих ResizeMode значений перечисления.

Имя Описание
RESIZE_NO Элемент управления tab не может быть изменен.
RESIZE_VERT Элемент управления табуляции можно изменить по вертикали, но не горизонтально.
RESIZE_HORIZ Элемент управления табуляции можно изменить по горизонтали, но не по вертикали.

CMFCTabCtrl::SetTabMaxWidth

Указывает максимальную ширину вкладки в окне табуляции.

void SetTabMaxWidth(int nTabMaxWidth);

Параметры

nTabMaxWidth
[in] Максимальная ширина вкладки в пикселях.

Замечания

Используйте этот метод, чтобы ограничить ширину каждой вкладки в окне с вкладками. Этот метод полезен, если вкладки имеют очень длинные метки. Конструктор CMFCTabCtrl классов инициализирует максимальную ширину табуляции до 0, что фактически означает, что ширина не ограничена.

CMFCTabCtrl::StopResize

Завершает текущую операцию изменения размера в элементе управления табуляции.

void StopResize(BOOL bCancel);

Параметры

bCancel
[in] TRUE , чтобы отказаться от текущей операции изменения размера; FALSE для завершения текущей операции изменения размера. В любом случае платформа останавливает рисование прямоугольника изменения размера.

CMFCTabCtrl::SynchronizeScrollBar

Рисует горизонтальную полосу прокрутки на элементе управления табуляции, где отображаются плоские вкладки.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Параметры

pScrollInfo
[out] Указатель на структуру SCROLLINFO или NULL. Когда этот метод возвращается, и если этот параметр не NULLзадан, структура содержит все параметры полосы прокрутки. Значение по умолчанию — NULL.

Возвращаемое значение

TRUE Значение , если этот метод выполнен успешно; FALSEв противном случае .

Замечания

Этот метод влияет только на элемент управления табуляции, отображающий неструктурированные вкладки. Полоса прокрутки влияет на все вкладки одновременно.

См. также

Диаграмма иерархии
Классы
CDockablePane Класс
CMFCBaseTabCtrl Класс