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);
繼承階層架構
需求
標頭: 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]指定滑桿控制件的縮放增量。