Класс CMFCOutlookBarTabCtrl

Статья
10/12/2023

Элемент управления "вкладка", который имеет внешний вид раздела Область переходов в Microsoft Outlook. Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

Синтаксис

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Участники

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

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

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

Имя	Описание
CMFCOutlookBarTabCtrl::AddControl	Добавляет элемент управления Windows в виде новой вкладки на панели Outlook.
`CMFCOutlookBarTabCtrl::CalcRectEdit`	Вызывается платформой для определения измерений поля редактирования, которое отображается при переименовании пользователем вкладки. (Переопределяет `CMFCBaseTabCtrl::CalcRectEdit`.)
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons	Вызывается платформой во время операций изменения размера, чтобы определить, может ли отображаться меньше кнопок вкладки панели Outlook, чем в данный момент.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons	Вызывается платформой во время операций изменения размера, чтобы определить, можно ли отображать больше кнопок вкладки панели Outlook, чем в данный момент.
CMFCOutlookBarTabCtrl::Create	Создает элемент управления вкладки панели Outlook.
`CMFCOutlookBarTabCtrl::CreateObject`	Используется платформой для создания динамического экземпляра этого типа класса.
CMFCOutlookBarTabCtrl::EnableAnimation	Указывает, включена ли анимация, возникающая во время переключения между активными вкладками.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit	Указывает, может ли пользователь изменять текстовые метки на кнопках вкладок панели Outlook. (Переопределения CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCOutlookBarTabCtrl::EnableScrollButtons	Вызывается платформой, чтобы включить кнопки, позволяющие пользователю прокручивать кнопки на панели панели Outlook.
`CMFCOutlookBarTabCtrl::FindTargetWnd`	Определяет область, которая содержит указанную точку. (Переопределения CMFCBaseTabCtrl::FindTargetWnd.)
CMFCOutlookBarTabCtrl::GetBorderSize	Возвращает размер границы элемента управления вкладки Outlook.
`CMFCOutlookBarTabCtrl::GetTabArea`	Извлекает размер и положение области вкладки набора вкладок. (Переопределения CMFCBaseTabCtrl::GetTabArea.)
`CMFCOutlookBarTabCtrl::GetThisClass`	Используется платформой для получения указателя на объект CRuntimeClass , связанный с этим типом класса.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation	Определяет, включена ли анимация, возникающая во время переключения между активными вкладками.
CMFCOutlookBarTabCtrl::IsMode2003	Определяет, находится ли элемент управления вкладки панели Outlook в режиме, который эмулирует Microsoft Outlook 2003.
`CMFCOutlookBarTabCtrl::IsPtInTabArea`	Определяет, находится ли точка внутри области вкладок. (Переопределения CMFCBaseTabCtrl::IsPtInTabArea.)
`CMFCOutlookBarTabCtrl::IsTabDetachable`	Указывает, является ли вкладка отделяемой. (Переопределения CMFCBaseTabCtrl::IsTabDetachable.)
`CMFCOutlookBarTabCtrl::OnChangeTabs`	Вызывается платформой при вставке или удалении вкладки. (Переопределяет `CMFCBaseTabCtrl::OnChangeTabs`.)
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons	Вызывается платформой, чтобы уменьшить количество видимых кнопок страницы вкладок.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons	Вызывается платформой для увеличения количества кнопок страницы вкладок, видимых.
CMFCOutlookBarTabCtrl::OnShowOptions	Отображает диалоговое окно "Параметры области навигации ".
`CMFCOutlookBarTabCtrl::RecalcLayout`	Повторно вычисляет внутренний макет набора вкладок. (Переопределения CMFCBaseTabCtrl::RecalcLayout.)
CMFCOutlookBarTabCtrl::SetActiveTab	Задает активную вкладку. (Переопределяет CMFCBaseTabCtrl::SetActiveTab.)
CMFCOutlookBarTabCtrl::SetBorderSize	Задает размер границы элемента управления вкладки Outlook.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign	Задает выравнивание текстовых меток на кнопках вкладок панели Outlook.
CMFCOutlookBarTabCtrl::SetToolbarImageList	Задает растровое изображение, содержащее значки, отображаемые в нижней части панели Outlook в режиме Outlook 2003 (см . класс CMFCOutlookBar).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Замечания

Чтобы создать панель Outlook с поддержкой закрепления, используйте CMFCOutlookBar объект для размещения элемента управления вкладки панели Outlook. Дополнительные сведения см. в разделе "Класс CMFCOutlookBar".

Пример

В следующем примере показано, как инициализировать CMFCOutlookBarTabCtrl объект и использовать различные методы в CMFCOutlookBarTabCtrl классе. В примере показано, как включить редактирование на месте текстовой метки на кнопках страницы вкладок панели Outlook, включить анимацию, включить маркеры прокрутки, позволяющие пользователю прокручивать кнопки на панели панели Outlook, задавать размер границы элемента управления вкладки Outlook и устанавливать выравнивание текстовых меток на вкладках на вкладках панели Outlook. Этот фрагмент кода является частью примера демонстрации Outlook.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();

pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

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

CMFCOutlookBarTabCtrl

Требования

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

CMFCOutlookBarTabCtrl::AddControl

Добавляет элемент управления Windows в виде новой вкладки на панели Outlook.

void AddControl(
    CWnd* pWndCtrl,
    LPCTSTR lpszName,
    int nImageID=-1,
    BOOL bDetachable=TRUE,
    DWORD dwControlBarStyle=AFX_CBRS_FLOAT |  AFX_CBRS_CLOSE | AFX_CBRS_RESIZE |  CBRS_AFX_AUTOHIDE);

Параметры

pWndCtrl
[in] Указатель на добавленный элемент управления.

lpszName
[in] Указывает имя вкладки.

bDetachable
[in] Если значение TRUE, страница будет создана как отсоединяемая.

nImageID
[in] Индекс изображения в списке внутренних образов для отображения изображения на новой вкладке.

dwControlBarStyle
[in] Задает стиль AFX_ CBRS_* для завернутых панелей док-станции.

Замечания

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

Эта функция внутренне вызывается в CMFCBaseTabCtrl::AddTab.

Если для bDetachable задано значение TRUE, AddControl внутренне создает CDockablePaneAdapter объект и упаковывает добавленный элемент управления. Он автоматически задает класс среды выполнения окна табуляции классу CMFCOutlookBar среды выполнения и классу среды выполнения с плавающей рамкой CMultiPaneFrameWnd.

Пример

В следующем примере показано, как использовать AddControl метод в CMFCOutlookBarTabCtrl классе. Этот фрагмент кода является частью примера демонстрации Outlook.

// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

Вызывается платформой во время операций изменения размера, чтобы определить, может ли отображаться меньше кнопок вкладки панели Outlook, чем в данный момент.

virtual BOOL CanShowFewerPageButtons() const;

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

ЗНАЧЕНИЕ TRUE, если существует несколько кнопк; в противном случае ЗНАЧЕНИЕ FALSE.

Замечания

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

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Вызывается платформой во время операций изменения размера, чтобы определить, можно ли отображать больше кнопок вкладки панели Outlook, чем в данный момент.

virtual BOOL CanShowMorePageButtons() const;

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

ЗНАЧЕНИЕ TRUE, если есть кнопки, которые в настоящее время не отображаются; в противном случае ЗНАЧЕНИЕ FALSE.

Замечания

CMFCOutlookBarTabCtrl::Create

Создает элемент управления вкладки панели Outlook.

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

Параметры

rect
[in] Указывает начальный размер и позицию в пикселях.

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

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

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

Ненулевое значение, если элемент управления был создан успешно; в противном случае — 0.

Замечания

Как правило, элементы управления вкладкой панели outlook создаются, когда класс CMFCOutlookBar управляет WM_CREATE сообщением процесса.

CMFCOutlookBarTabCtrl::EnableAnimation

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

static void EnableAnimation(BOOL bEnable=TRUE);

Параметры

bEnable
[in] Указывает, должна ли анимация быть включена или отключена.

Замечания

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

По умолчанию анимация включена.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

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

virtual void EnableInPlaceEdit(BOOL bEnable);

Параметры

bEnable
Если значение TRUE, включите редактирование на месте текстовой метки. Если значение FALSE, отключите редактирование на месте.

Замечания

Вызовите эту функцию, чтобы включить или отключить редактирование текстовых меток на кнопках страницы вкладок. По умолчанию редактирование на месте отключено.

CMFCOutlookBarTabCtrl::EnableScrollButtons

Вызывается платформой для включения дескрипторов прокрутки, позволяющих пользователю прокручивать кнопки на панели панели Outlook.

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

Параметры

bEnable
[in] Определяет, отображаются ли кнопки прокрутки.

bIsUp
[in] Определяет, отображается ли верхняя полоса прокрутки.

bIsDown
[in] Определяет, отображается ли нижняя полоса прокрутки.

Замечания

Включает отображение кнопок прокрутки. Этот метод вызывается платформой при изменении активной вкладки для восстановления кнопок прокрутки.

CMFCOutlookBarTabCtrl::GetBorderSize

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

int GetBorderSize() const;

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

Размер границы в пикселях.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

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

Замечания

CMFCOutlookBarTabCtrl::IsAnimation

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

static BOOL IsAnimation();

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

Ненулевое значение, если анимация включена; в противном случае — 0.

Замечания

Вызовите функцию CMFCOutlookBarTabCtrl::EnableAnimation, чтобы включить или отключить анимацию.

CMFCOutlookBarTabCtrl::IsMode2003

Определяет, находится ли элемент управления вкладки "Панель Outlook" в режиме, который эмулирует Microsoft Outlook 2003.

BOOL IsMode2003() const;

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

ЗНАЧЕНИЕ TRUE, если элемент управления вкладкой "Панель Outlook" находится в режиме Outlook 2003; в противном случае значение FALSE;

Замечания

Это значение задается CMFCOutlookBar::SetMode2003.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

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

virtual void OnShowFewerPageButtons();

Замечания

Этот метод настраивает количество видимых кнопок вкладки страницы при изменении размера элемента управления.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Вызывается платформой для увеличения количества кнопок страницы вкладок, видимых.

virtual void OnShowMorePageButtons();

Замечания

Этот метод настраивает количество кнопок страницы вкладок, видимых при изменении размера элемента управления.

CMFCOutlookBarTabCtrl::OnShowOptions

Отображает диалоговое окно "Параметры области навигации".

virtual void OnShowOptions();

Замечания

Диалоговое окно "Параметры области навигации" позволяет пользователю выбрать, какие кнопки страницы вкладок должны отображаться, а также порядок отображения.

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

CMFCOutlookBarTabCtrl::SetActiveTab

Задает активную вкладку. Активная вкладка — это открытая вкладка с видимым содержимым.

virtual BOOL SetActiveTab(int iTab);

Параметры

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

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

Ненулевое значение, если указанная вкладка была успешно открыта; в противном случае — 0.

Замечания

Визуальный эффект настройки активной вкладки зависит от того, включена ли анимация. Дополнительные сведения см. в разделе CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Задает размер границы элемента управления вкладки Outlook.

void SetBorderSize(int nBorderSize);

Параметры

nBorderSize
[in] Задает новый размер границы в пикселях.

Замечания

Задает новый размер границы и пересчитывает макет окна Outlook.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Задает выравнивание текстовых меток на кнопках вкладок панели Outlook.

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

Параметры

uiAlign
[in] Указывает выравнивание текста.

bRedraw
[in] Если значение TRUE, окно outlook будет перезабрано.

Замечания

Эта функция позволяет изменить выравнивание текста для кнопок страницы.

uiAlign может быть одним из следующих значений:

Константа	Значение
TA_LEFT	Выравнивание по левому краю
TA_CENTER	Выравнивание по центру
TA_RIGHT	Выравнивание по правому краю

Значение по умолчанию — TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Задает растровое изображение, содержащее значки, отображаемые в нижней части панели Outlook в режиме Outlook 2003.

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

Параметры

uiID
[in] Указывает идентификатор ресурса загружаемого образа.

cx
[in] Задает ширину изображения в списке изображений в пикселях.

clrTransp
[in] Значение RGB, указывающее прозрачный цвет.

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

Возвращает значение TRUE в случае успешного выполнения; в противном случае возвращает значение FALSE.

Замечания

Используйте эту функцию для присоединения списка изображений, изображения которых будут отображаться на кнопках панели инструментов в режиме Microsoft Office 2003. Индексы изображений должны соответствовать индексам страниц.

Этот метод не следует вызывать, если не в режиме Microsoft Office 2003. Дополнительные сведения см. в разделе "Класс CMFCOutlookBar".

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Параметры

[in] nVisiblePageButtons

Замечания

См. также

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

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

Класс CMFCOutlookBarTabCtrl

Синтаксис

Участники

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

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

Замечания

Пример

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

Требования

CMFCOutlookBarTabCtrl::AddControl

Параметры

Замечания

Пример

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

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

Замечания

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

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

Замечания

CMFCOutlookBarTabCtrl::Create

Параметры

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

Замечания

CMFCOutlookBarTabCtrl::EnableAnimation

Параметры

Замечания

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Параметры

Замечания

CMFCOutlookBarTabCtrl::EnableScrollButtons

Параметры

Замечания

CMFCOutlookBarTabCtrl::GetBorderSize

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

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

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

Замечания

CMFCOutlookBarTabCtrl::IsAnimation

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

Замечания

CMFCOutlookBarTabCtrl::IsMode2003

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

Замечания

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Замечания

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Замечания

CMFCOutlookBarTabCtrl::OnShowOptions

Замечания

CMFCOutlookBarTabCtrl::SetActiveTab

Параметры

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

Замечания

CMFCOutlookBarTabCtrl::SetBorderSize

Параметры

Замечания

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Параметры

Замечания

CMFCOutlookBarTabCtrl::SetToolbarImageList

Параметры

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

Замечания

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Параметры

Замечания

См. также

Обратная связь

Дополнительные ресурсы