共用方式為


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

繼承階層架構

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 類別