CMFCRibbonStatusBarPane 類別

發行項
08/04/2024

類別 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();

繼承階層架構

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonStatusBarPane

需求

標頭： afxribbonstatusbarpane.h

CMFCRibbonStatusBarPane：：CMFCRibbonStatusBarPane

在狀態列中建構 pane 物件。

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

如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。

virtual void OnDrawBorder(CDC*);

參數

[輸入] CDC*

備註

CMFCRibbonStatusBarPane：：OnFillBackground

如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。

virtual COLORREF OnFillBackground(CDC* pDC);

參數

[in] pDC

傳回值

備註

CMFCRibbonStatusBarPane：：OnFinishAnimation

當指派給窗格的動畫結束時，Framework 會呼叫這個方法。

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。

備註

您必須先指定影像清單的句柄，才能使用 SetAnimationList呼叫 StartAnimation 。

CMFCRibbonStatusBarPane：：StopAnimation

停止您指派給狀態列窗格的動畫。

void StopAnimation();

另請參閱

階層架構圖表
 類別
 CMFCRibbonButton 類別
 CMFCRibbonStatusBar 類別

共用方式為