CMFCRibbonSlider 類別

發行項
10/12/2023

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

共用方式為