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] 滑块 ID。
[in]. nWidth 滑块宽度（以像素为单位）。
备注
在添加滑块的面板类别中构造一个宽度为 nWidth 像素的功能区滑块。 默认情况下，滑块为水平滑块。
CMFCRibbonSlider::GetPos
返回滑块控件的当前位置。
int GetPos() const;
返回值
滑块控件的当前位置，它是相对于滑块开头的位置。
CMFCRibbonSlider::GetRangeMax
获取滑块可以在滑块控件上移动的最大滑块增量。
int GetRangeMax() const;
返回值
滑块可以在滑块控件上移动的最大滑块增量。
CMFCRibbonSlider::GetRangeMin
返回滑块可以在滑块控件上移动的最小增量。
int GetRangeMin() const;
返回值
滑块可以在滑块控件上移动的最小增量。
CMFCRibbonSlider::GetRegularSize
有关详细信息，请参阅所安装的 Visual Studio 的 C\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 的 C\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]. bSet 如果为 TRUE，则显示缩放按钮；如果为 FALSE，则隐藏它们。
CMFCRibbonSlider::SetZoomIncrement
设置滑块控件的缩放增量。
void SetZoomIncrement(int nZoomIncrement);
参数
nZoomIncrement
[in] 指定滑块控件的缩放增量。