分享方式:


CMFCRibbonSlider 類別

類別 CMFCRibbonSlider 會實作滑桿控件,您可以新增至功能區列或功能區狀態列。 功能區滑桿控制項類似出現在 Office 2007 應用程式中的縮放滑桿。

語法

class CMFCRibbonSlider : public CMFCRibbonBaseElement

成員

公用建構函式

名稱 描述
CMFCRibbonSlider::CMFCRibbonSlider 建構和初始化功能區滑桿控件。

公用方法

名稱 描述
CMFCRibbonSlider::GetPos 傳回滑桿控件的目前位置。
CMFCRibbonSlider::GetRangeMax 傳回滑桿的最大值。
CMFCRibbonSlider::GetRangeMin 傳回滑桿的最小值。
CMFCRibbonSlider::GetRegularSize 傳回功能區項目的一般大小。 (覆寫 CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonSlider::GetZoomIncrement 傳回滑桿控件縮放增量的大小。
CMFCRibbonSlider::HasZoomButtons 指定滑桿是否具有縮放按鈕。
CMFCRibbonSlider::OnDraw 由架構呼叫以繪製功能區項目。 (覆寫 CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonSlider::SetPos 設定滑桿控制件的目前位置。
CMFCRibbonSlider::SetRange 藉由設定最小值和最大值,指定滑桿控件的範圍。
CMFCRibbonSlider::SetZoomButtons 顯示或隱藏縮放按鈕。
CMFCRibbonSlider::SetZoomIncrement 設定滑桿控件縮放遞增的大小。

備註

您可以使用 SetRange 方法來設定滑桿的縮放增量範圍。 您可以使用 方法來設定滑桿 SetPos 的目前位置。

您可以使用 方法,在滑桿控件 SetZoomButtons 的左側和右側顯示圓形縮放按鈕。 根據預設,滑桿為水準,左縮放按鈕會顯示減號,而右縮放按鈕會顯示加號。

方法 SetZoomIncrement 會定義當使用者按兩下縮放按鈕時,要加入或減去目前位置的遞增。

範例

下列範例示範如何使用 類別中的 CMFCRibbonSlider 各種方法來設定滑桿的屬性。 此範例示範如何建構 CMFCRibbonSlider 對象、顯示縮放按鈕、設定滑桿控件的目前位置,以及設定滑桿控件的值範圍。

// Create a ribbon slider.
CMFCRibbonSlider *ribbonSlider = new CMFCRibbonSlider();
// Set the various properties of the slider.
ribbonSlider->SetZoomButtons(true);
ribbonSlider->SetPos(50, TRUE);
ribbonSlider->SetRange(0, 100);
// Add the ribbon slider to the Favorites panel.
// CMFCRibbonPanel* pPanelFavorites
pPanelFavorites->Add(ribbonSlider);

繼承階層架構

CObject

CMFCRibbonBaseElement

CMFCRibbonSlider

需求

標頭: afxribbonslider.h

CMFCRibbonSlider::CMFCRibbonSlider

建構功能區滑桿。

CMFCRibbonSlider(
    UINT nID,
    int nWidth=100);

參數

nID
[in]滑桿標識碼。

[in]。 nWidth 滑桿寬度以像素為單位。

備註

在新增滑桿的面板類別中,建構 nWidth 像素寬的功能區滑桿。 根據預設,滑桿是水準滑桿。

CMFCRibbonSlider::GetPos

傳回滑桿控件的目前位置。

int GetPos() const;

傳回值

滑桿控件的目前位置,這是相對於滑桿開頭的位置。

CMFCRibbonSlider::GetRangeMax

取得滑桿可在滑桿控件上移動的最大增量。

int GetRangeMax() const;

傳回值

滑桿可在滑桿控件上移動的最大增量。

CMFCRibbonSlider::GetRangeMin

傳回滑桿可以在滑桿控件上移動的最小增量。

int GetRangeMin() const;

傳回值

滑桿可以在滑桿控件上移動的最小增量。

CMFCRibbonSlider::GetRegularSize

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

virtual CSize GetRegularSize(CDC* pDC);

參數

[in] pDC

傳回值

備註

CMFCRibbonSlider::GetZoomIncrement

取得滑桿控件的縮放增量。

int GetZoomIncrement() const;

傳回值

滑桿控件的縮放遞增。

CMFCRibbonSlider::HasZoomButtons

指定滑桿是否具有縮放按鈕。

BOOL HasZoomButtons() const;

傳回值

如果滑桿有縮放按鈕,則為TRUE;否則為 FALSE。

CMFCRibbonSlider::OnDraw

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

virtual void OnDraw(CDC* pDC);

參數

[in] pDC

備註

CMFCRibbonSlider::SetPos

設定滑桿控制件的目前位置。

void SetPos(
    int nPos,
    BOOL bRedraw=TRUE);

參數

nPos
[in]指定要為滑桿設定的位置。 位置相對於滑桿的開頭。

bRedraw
[in]如果為TRUE,滑桿將會重新繪製。

CMFCRibbonSlider::SetRange

設定滑桿控件的值範圍。

void SetRange(
    int nMin,
    int nMax);

參數

nMin
[in]指定滑桿控制件的最小值。

nMax
[in]指定滑桿控制件的最大值。

備註

藉由設定最小值和最大值,指定滑桿控件的值範圍。

CMFCRibbonSlider::SetZoomButtons

顯示或隱藏縮放按鈕。

void SetZoomButtons(BOOL bSet=TRUE);

參數

[in]。 b 設定 TRUE 以顯示縮放按鈕;FALSE 隱藏它們。

CMFCRibbonSlider::SetZoomIncrement

設定滑桿控件的縮放增量。

void SetZoomIncrement(int nZoomIncrement);

參數

nZoomIncrement
[in]指定滑桿控制件的縮放增量。

另請參閱

階層架構圖表
類別
CMFCRibbonBaseElement 類別