Класс CMFCRibbonStatusBar

Статья
10/12/2023

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

Синтаксис

class CMFCRibbonStatusBar : public CMFCRibbonBar

Участники

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

Имя	Описание
CMFCRibbonStatusBar::AddDynamicElement	Добавляет динамический элемент в строку состояния ленты.
CMFCRibbonStatusBar::AddElement	Добавляет новый элемент ленты в строку состояния ленты.
CMFCRibbonStatusBar::AddExtendedElement	Добавляет элемент ленты в расширенную область строки состояния ленты.
CMFCRibbonStatusBar::AddSeparator	Добавляет разделитель в строку состояния ленты.
CMFCRibbonStatusBar::Create	Создает строку состояния ленты.
CMFCRibbonStatusBar::CreateEx	Создает строку состояния ленты с расширенным стилем.
CMFCRibbonStatusBar::FindByID
CMFCRibbonStatusBar::FindElement	Возвращает указатель на элемент с указанным идентификатором команды.
CMFCRibbonStatusBar::GetCount	Возвращает количество элементов, расположенных в главной области строки состояния ленты.
CMFCRibbonStatusBar::GetElement	Возвращает указатель на элемент, расположенный по указанному индексу.
CMFCRibbonStatusBar::GetExCount	Возвращает количество элементов, расположенных в расширенной области строки состояния ленты.
CMFCRibbonStatusBar::GetExElement	Возвращает указатель на элемент, расположенный по заданному индексу в расширенной области строки состояния ленты.
CMFCRibbonStatusBar::GetExtendedArea
CMFCRibbonStatusBar::GetSpace
CMFCRibbonStatusBar::IsBottomFrame
CMFCRibbonStatusBar::IsExtendedElement
CMFCRibbonStatusBar::IsInformationMode	Определяет, включен ли режим сведений для строки состояния ленты.
CMFCRibbonStatusBar::RecalcLayout	(Переопределения CMFCRibbonBar::RecalcLayout.)
CMFCRibbonStatusBar::RemoveAll	Удаляет все элементы из строки состояния ленты.
CMFCRibbonStatusBar::RemoveElement	Удаляет элемент с указанным идентификатором команды из строки состояния ленты.
CMFCRibbonStatusBar::SetInformation	Включает или отключает режим сведений для строки состояния ленты.

Защищенные методы

Имя	Описание
CMFCRibbonStatusBar::OnDrawInformation	Отображает строку сведений, которая отображается на строке состояния ленты при включении режима информации.

Замечания

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

Строка состояния ленты состоит из двух областей: основной области и расширенной области. Расширенная область отображается справа от строки состояния ленты и отображается в другом цвете, отличном от основной области.

Как правило, основная область строки состояния отображает уведомления о состоянии, а расширенная область отображает элементы управления представлением. Расширенная область остается видимой до тех пор, пока пользователь изменяет размер строки состояния ленты.

Пример

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

// CMFCRibbonStatusBar  m_wndStatusBar
m_wndStatusBar.AddElement(rsbp, strTitlePane1);
m_wndStatusBar.AddExtendedElement(new CMFCRibbonStatusBarPane(ID_STATUSBAR_PANE2, strTitlePane2, TRUE),
                                  strTitlePane2);

m_wndStatusBar.AddSeparator();
m_wndStatusBar.SetInformation(NULL);

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

Требования

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

CMFCRibbonStatusBar::AddDynamicElement

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

void AddDynamicElement(CMFCRibbonBaseElement* pElement);

Параметры

pElement
[in] Указатель на динамический элемент.

Замечания

В отличие от обычных элементов динамические элементы не настраиваются, а меню настройки строки состояния не отображает их.

CMFCRibbonStatusBar::AddElement

Добавляет новый элемент ленты в строку состояния ленты.

void AddElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

Параметры

pElement
[in] Указатель на добавленный элемент.

lpszLabel
[in] Текстовая метка элемента.

bIsVisible
[in] ЗНАЧЕНИЕ TRUE, если вы хотите добавить элемент как видимый, значение FALSE, если вы хотите добавить этот элемент как скрытый.

CMFCRibbonStatusBar::AddExtendedElement

Добавляет элемент ленты в расширенную область строки состояния ленты.

void AddExtendedElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

Параметры

pElement
[in] Указатель на добавленный элемент.

lpszLabel
[in] Текстовая метка элемента.

Замечания

Расширенная область находится в правой части элемента управления состоянием строки.

CMFCRibbonStatusBar::AddSeparator

Добавляет разделитель в строку состояния ленты.

void AddSeparator();

Замечания

Платформа добавляет разделитель после метода CMFCRibbonStatusBar::AddElement. вставляет последний элемент.

CMFCRibbonStatusBar::Create

Создает строку состояния ленты.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
    UINT nID=AFX_IDW_STATUS_BAR);

Параметры

pParentWnd
[in] Указатель на родительское окно.

dwStyle
[in] Логическое или сочетание стилей элементов управления.

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

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

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

CMFCRibbonStatusBar::CreateEx

Создает строку состояния ленты с расширенным стилем.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=0,
    DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
    UINT nID=AFX_IDW_STATUS_BAR);

Параметры

pParentWnd
Указатель на родительское окно.

dwCtrlStyle
Логическое СОЧЕТАНИЕ ИЛИ дополнительных стилей для создания объекта строки состояния.

dwStyle
Стиль элемента управления строки состояния.

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

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

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

CMFCRibbonStatusBar::FindByID

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);

Параметры

[in] uiCmdID
[in] BOOL

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

Замечания

CMFCRibbonStatusBar::FindElement

Возвращает указатель на элемент с указанным идентификатором команды.

CMFCRibbonBaseElement* FindElement(UINT uiID);

Параметры

uiID
[in] Идентификатор элемента.

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

Указатель на элемент с указанным идентификатором команды. ЗНАЧЕНИЕ NULL, если такого элемента нет.

CMFCRibbonStatusBar::GetCount

Возвращает количество элементов, расположенных в главной области строки состояния ленты.

int GetCount() const;

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

Количество элементов, расположенных в главной области строки состояния ленты.

CMFCRibbonStatusBar::GetElement

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

CMFCRibbonBaseElement* GetElement(int nIndex);

Параметры

nIndex
[in] Указывает отсчитываемый от нуля индекс элемента, расположенного в главной области элемента управления строкой состояния.

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

Указатель на элемент, расположенный по указанному индексу. ЗНАЧЕНИЕ NULL, если индекс отрицательный или превышает количество элементов в строке состояния.

Замечания

CMFCRibbonStatusBar::GetExCount

Возвращает количество элементов, расположенных в расширенной области строки состояния ленты.

int GetExCount() const;

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

Количество элементов, расположенных в расширенной области строки состояния ленты.

CMFCRibbonStatusBar::GetExElement

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

CMFCRibbonBaseElement* GetExElement(int nIndex);

Параметры

nIndex
[in] Указывает отсчитываемый от нуля индекс элемента, расположенного в расширенной области элемента управления строкой состояния.

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

Указатель на элемент, расположенный по заданному индексу в расширенной области строки состояния ленты. ЗНАЧЕНИЕ NULL, если nIndex является отрицательным или превышает количество элементов в расширенной области строки состояния ленты.

Замечания

CMFCRibbonStatusBar::GetExtendedArea

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

virtual BOOL GetExtendedArea(CRect& rect) const;

Параметры

[in] rect

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

Замечания

CMFCRibbonStatusBar::GetSpace

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

int GetSpace() const;

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

Замечания

CMFCRibbonStatusBar::IsBottomFrame

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

BOOL IsBottomFrame() const;

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

Замечания

CMFCRibbonStatusBar::IsExtendedElement

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;

Параметры

[in] pElement

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

Замечания

CMFCRibbonStatusBar::IsInformationMode

Определяет, включен ли режим сведений для строки состояния ленты.

BOOL IsInformationMode() const;

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

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

Замечания

В информационном режиме строка состояния скрывает все обычные панели и отображает строку сообщения.

CMFCRibbonStatusBar::OnDrawInformation

Отображает строку, которая отображается на строке состояния ленты при включении режима информации.

virtual void OnDrawInformation(
    CDC* pDC,
    CString& strInfo,
    CRect rectInfo);

Параметры

pDC
[in] Указатель на контекст устройства.

strInfo
[in] Строка сведений.

rectInfo
[in] Ограничивающий прямоугольник.

Замечания

Переопределите этот метод в производном классе, если вы хотите настроить внешний вид строки сведений в строке состояния. Используйте метод CMFCRibbonStatusBar::SetInformation, чтобы поместить строку состояния в информационный режим. В этом режиме строка состояния скрывает все панели и отображает строку сведений, указанную strInfo.

CMFCRibbonStatusBar::RecalcLayout

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

virtual void RecalcLayout();

Замечания

CMFCRibbonStatusBar::RemoveAll

Удаляет все элементы из строки состояния ленты.

void RemoveAll();

CMFCRibbonStatusBar::RemoveElement

Удаляет элемент с указанным идентификатором команды из строки состояния ленты.

BOOL RemoveElement(UINT uiID);

Параметры

uiID
[in] Идентификатор элемента, который нужно удалить из строки состояния.

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

ЗНАЧЕНИЕ TRUE, если элемент с указанным uiID удаляется. Значение FALSE в противном случае.

CMFCRibbonStatusBar::SetInformation

Включает или отключает режим сведений для строки состояния ленты.

void SetInformation(LPCTSTR lpszInfo);

Параметры

lpszInfo
[in] Строка сведений.

Замечания

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

Если значение lpszInfo равно NULL, строка состояния возвращается в обычный режим.

См. также

Диаграмма иерархии
Классы
Класс CMFCRibbonBar
Класс CMFCRibbonBaseElement
Класс CMFCRibbonBar

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

Класс CMFCRibbonStatusBar

Синтаксис

Участники

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

Защищенные методы

Замечания

Пример

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

Требования

CMFCRibbonStatusBar::AddDynamicElement

Параметры

Замечания

CMFCRibbonStatusBar::AddElement

Параметры

CMFCRibbonStatusBar::AddExtendedElement

Параметры

Замечания

CMFCRibbonStatusBar::AddSeparator

Замечания

CMFCRibbonStatusBar::Create

Параметры

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

CMFCRibbonStatusBar::CreateEx

Параметры

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

CMFCRibbonStatusBar::FindByID

Параметры

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

Замечания

CMFCRibbonStatusBar::FindElement

Параметры

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

CMFCRibbonStatusBar::GetCount

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

CMFCRibbonStatusBar::GetElement

Параметры

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

Замечания

CMFCRibbonStatusBar::GetExCount

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

CMFCRibbonStatusBar::GetExElement

Параметры

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

Замечания

CMFCRibbonStatusBar::GetExtendedArea

Параметры

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

Замечания

CMFCRibbonStatusBar::GetSpace

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

Замечания

CMFCRibbonStatusBar::IsBottomFrame

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

Замечания

CMFCRibbonStatusBar::IsExtendedElement

Параметры

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

Замечания

CMFCRibbonStatusBar::IsInformationMode

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

Замечания

CMFCRibbonStatusBar::OnDrawInformation

Параметры

Замечания

CMFCRibbonStatusBar::RecalcLayout

Замечания

CMFCRibbonStatusBar::RemoveAll

CMFCRibbonStatusBar::RemoveElement

Параметры

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

CMFCRibbonStatusBar::SetInformation

Параметры

Замечания

См. также

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

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