Класс CMFCRibbonStatusBarPane

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

Синтаксис

class CMFCRibbonStatusBarPane : public CMFCRibbonButton

Участники

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

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

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

Пример

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

CString strTitlePane1;
CString strTitlePane2;
strTitlePane1.LoadString(IDS_STATUS_PANE1);
strTitlePane2.LoadString(IDS_STATUS_PANE2);

CMFCRibbonStatusBarPane* rsbp = new CMFCRibbonStatusBarPane( ID_STATUSBAR_PANE1, strTitlePane1, TRUE );
rsbp->SetTextAlign( TA_CENTER );
rsbp->SetAlmostLargeText( _T( "Status bar" ) );
CBitmap bitmap;
bitmap.LoadBitmapW( IDB_FILESMALL );
rsbp->SetAnimationList( (HBITMAP)bitmap );
rsbp->StartAnimation();

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

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonStatusBarPane

Требования

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

CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane

Создайте объект области в строке состояния.

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    BOOL bIsStatic=FALSE,
    HICON hIcon=NULL,
    LPCTSTR lpszAlmostLargeText=NULL);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192,192 1,192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192, 192 1, 192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

Параметры

nCmdID
[in] Указывает идентификатор команды панели.

lpszText
[in] Указывает текстовую строку, отображаемую на панели.

bIsStatic
[in] Если значение TRUE, область состояния не может быть выделена или выбрана, щелкнув ее.

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

lpszAlmostLargeText
[in] Указывает самую длинную текстовую строку, которую можно отобразить на панели.

hBmpAnimationList
[in] Задает дескриптор списка изображений, который используется для анимации.

cxAnimation
[in] Задает ширину в пикселях значка в списке изображений, который используется для анимации.

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

uiAnimationListResID
[in] Указывает идентификатор ресурса списка изображений, который используется для анимации.

CMFCRibbonStatusBarPane::GetAlmostLargeText

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

LPCTSTR GetAlmostLargeText() const;

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

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

CMFCRibbonStatusBarPane::GetTextAlign

Возвращает текущий параметр выравнивания текста метки панели состояния.

int GetTextAlign() const;

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

Текущее выравнивание текста, которое может быть одним из следующих элементов:

• TA_LEFT

• TA_CENTER

• TA_RIGHT.

CMFCRibbonStatusBarPane::IsAnimation

Определяет, выполняется ли анимация.

BOOL IsAnimation() const;

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

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

CMFCRibbonStatusBarPane::IsExtended

Определите, находится ли область в расширенной области строки состояния ленты.

BOOL IsExtended() const;

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

ЗНАЧЕНИЕ TRUE, если область находится в расширенной области строки состояния. Значение FALSE в противном случае.

CMFCRibbonStatusBarPane::OnDrawBorder

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

virtual void OnDrawBorder(CDC*);

Параметры

[входной] CDC*

Замечания

CMFCRibbonStatusBarPane::OnFillBackground

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

virtual COLORREF OnFillBackground(CDC* pDC);

Параметры

[in] PDC

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

Замечания

CMFCRibbonStatusBarPane::OnFinishAnimation

Платформа вызывает этот метод, когда анимация, назначенная области.

virtual void OnFinishAnimation();

Замечания

StopAnimation метод вызывает OnFinishAnimation метод, который можно использовать для очистки данных при завершении анимации.

CMFCRibbonStatusBarPane::SetAlmostLargeText

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

void SetAlmostLargeText(LPCTSTR lpszAlmostLargeText);

Параметры

lpszAlmostLargeText
[in] Указывает самую длинную строку, которую можно отобразить на панели состояния без усечения.

Замечания

Библиотека вычисляет размер текста, который lpszAlmostLargeText указывает и изменяет размер области соответствующим образом. Текст будет усечен, если он по-прежнему не помещается в область.

CMFCRibbonStatusBarPane::SetAnimationList

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

void SetAnimationList(
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

BOOL SetAnimationList(
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

Параметры

hBmpAnimationList
[in] Задает дескриптор списка изображений.

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

clrTransp
[in] Указывает прозрачный цвет списка изображений.

uiAnimationListResID
[in] Указывает идентификатор ресурса списка изображений.

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

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

CMFCRibbonStatusBarPane::SetTextAlign

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

void SetTextAlign(int nAlign);

Параметры

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

Замечания

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

• TA_LEFT: выравнивание по левому краю

• TA_CENTER: выравнивание по центру

• TA_RIGHT: выравнивание по правому краю

CMFCRibbonStatusBarPane::StartAnimation

Запускает анимацию, которую вы назначаете области.

void StartAnimation(
    UINT nFrameDelay=500,
    UINT nDuration=-1);

Параметры

nFrameDelay
[in] Задает частоту кадров анимации в миллисекундах.

nDuration
[in] Указывает время воспроизведения анимации в миллисекундах. Используйте -1 для бесконечного цикла.

Замечания

Перед вызовом StartAnimation SetAnimationListнеобходимо указать дескриптор списка изображений.

CMFCRibbonStatusBarPane::StopAnimation

Останавливает анимацию, назначенную панели состояния.

void StopAnimation();

См. также

Диаграмма иерархии
Классы
Класс CMFCRibbonButton
Класс CMFCRibbonStatusBar