Класс CMFCRibbonStatusBar
Класс 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] Текстовая метка элемента.
bIsVisible
[in] ЗНАЧЕНИЕ TRUE, если вы хотите добавить элемент как видимый, значение FALSE, если вы хотите добавить этот элемент как скрытый.
Замечания
Расширенная область находится в правой части элемента управления состоянием строки.
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
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по