Класс CMFCRibbonStatusBarPane
Класс CMFCRibbonStatusBarPane реализует элемент ленты, который можно добавить в строку состояния ленты.
Синтаксис
class CMFCRibbonStatusBarPane : public CMFCRibbonButton
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane | Создает и инициализирует объект CMFCRibbonStatusBarPane. |
Открытые методы
| Имя | Описание |
|---|---|
| CMFCRibbonStatusBarPane::GetAlmostLargeText | Возвращает строку, которая определяет самую длинную текстовую строку, которую можно отобразить в области без усечения. |
| CMFCRibbonStatusBarPane::GetTextAlign | Возвращает текущий параметр выравнивания текста. |
| CMFCRibbonStatusBarPane::IsAnimation | Определяет, выполняется ли анимация. |
| CMFCRibbonStatusBarPane::IsExtended | Определяет, находится ли область в расширенной области строки состояния ленты. |
| CMFCRibbonStatusBarPane::OnDrawBorder | (Переопределения CMFCRibbonButton::OnDrawBorder.) |
| CMFCRibbonStatusBarPane::OnFillBackground | (Переопределения CMFCRibbonButton::OnFillBackground.) |
| CMFCRibbonStatusBarPane::SetAlmostLargeText | Определяет самую длинную текстовую строку, которую можно отобразить в области без усечения. |
| CMFCRibbonStatusBarPane::SetAnimationList | Назначает области список изображений, который можно использовать для анимации. |
| CMFCRibbonStatusBarPane::SetTextAlign | Задает выравнивание текста. |
| CMFCRibbonStatusBarPane::StartAnimation | Запускает анимацию, назначенную области. |
| CMFCRibbonStatusBarPane::StopAnimation | Останавливает анимацию, назначенную области. . |
Защищенные методы
| Имя | Описание |
|---|---|
| CMFCRibbonStatusBarPane::OnFinishAnimation | Вызывается платформой, когда анимация, назначенная области, останавливается. |
Пример
В следующем примере демонстрируется использование различных методов класса 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();
Иерархия наследования
Требования
Заголовок: 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 для бесконечного цикла.
Замечания
Перед вызовом StartAnimationSetAnimationListнеобходимо указать дескриптор списка изображений.
CMFCRibbonStatusBarPane::StopAnimation
Останавливает анимацию, назначенную панели состояния.
void StopAnimation();
См. также
Диаграмма иерархии
Классы
Класс CMFCRibbonButton
Класс CMFCRibbonStatusBar
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по