CMFCRibbonSlider 类

项目
10/18/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] 滑块 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] 指定滑块控件的缩放增量。

另请参阅

层次结构图
 类
 CMFCRibbonBaseElement 类

通过