Класс CMFCOutlookBarTabCtrl
Элемент управления "вкладка", который имеет внешний вид раздела Область переходов в 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);
Иерархия наследования
Требования
Заголовок: 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.
Замечания
Элемент управления вкладки панели Outlook динамически добавляет или удаляет вкладки из дисплея в зависимости от того, сколько помещений доступно. Этот метод используется платформой для оказания помощи в этом процессе.
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
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по