CSpinButtonCtrl

一个 “ 旋转按钮控件 ” （也称为上下控件）是一对箭头按钮，用户点击它们来增加或减小一个值，比如一个滚动位置或显示在相应控件中的一个数字。与一

个旋转按钮控件相联系的值被称为它的当前位置。一个旋转控件通常是与一个相伴的控件一起使用的，称为 “ 伙伴窗口 ” 。

CSpinButtonCtrl 类提供了 Windows 通用旋转按钮控件的功能。这个控件（也就是 CSpinButtonCtrl 类）只对运行在 Windows95 和 W indows NT3.51 或更高版本下的程序来说是可用的。

对用户来说，一个旋转按钮控件和它的伙伴窗口看起来通常就象一个单一的控件。你可以指定一个旋转按钮控件自动将它自己定位在它的伙伴窗口的旁边，并且它自动将它的伙伴窗口的标题设置为它的当前位置。可以将一个旋转按钮控件与一个编辑控件一起使用，以提示用户进行数字输入。

点击向上箭头使当前位置向最大值方向移动，而点击向下箭头使当前位置向最小值的方向移动。缺省的，最小值是 100 ，最大值是 0 。任何时候，最小值的设置都大于最大值（例如，当使用缺省值时），点击向上箭头减少位置值，而

点击向下箭头则增加它。

个没有伙伴窗口的旋转按钮控件就象简化了的滚动条
。例如，一个 tab 控件有时显示一个旋转按钮控件来使它的用户能够滚动其它的 tab 进入视。

有关使用 CSpinButtonCtrl 的更多信息，参见“ V isual C++ 程序员指南 ” 中的“ 控件主题 ” 和 “ 使用 CSpinButtonCtrl ” 。

#include <afxcmn.h>

请参阅 CSliderCtrl

CSpinButtonCtrl 类成员

Construction

CspinButtonCtrl 构造一个 CSpinButtonCtrl 对象

Create 创建一个旋转按钮控件并将它连接到一个

CSpinButtonCtrl 对象

Attribute s SetAccel 为一个旋转按钮控件设置加速

GetAccel 获取一个旋转按钮控件的加速信息

SetBase 为一个旋转按钮控件设置基数

GetBase 获取一个旋转按钮控件的当前基数

SetBuddy 为一个旋转按钮控件设置伙伴窗口

GetBuddy 获取指向当前伙伴窗口的指针

SetPos 设置控件的当前位置

GetPos 获取一个旋转按钮控件的当前位置

SetRange 设置一个旋转按钮控件的上限和下限（范围）

GetRange 获取一个旋转按钮控件的上限和下限（范围）

SetRange 32 设置旋转按钮控件的 32 位范围

G etRange 32 获取旋转按钮控件的 32 位范围

成员函数

CSpinButtonCtrl::Create

BOOL Create( DWORD dwStyle , const RECT& rect , CWnd* pParentWnd , UINT

nID );

返回值

如果初始化成功则返回非零值；否则返回 0 。

参数

dwStyle

指定旋转按钮控件的风格。可以将旋转控件风格的任何组合应用到这个控

件。

rect

指定旋转按钮控件的大小和位置。它可以是一个 CRect 对象或一个 RECT

结构。

pPrentWnd

一个指向旋转控件的父窗口的指针，该窗口通常是一个 CDialog 。它必须不是 NULL 。

nID

指定旋转控件的 ID 。

说明

构造一个 CSpinButtonCtrl 对象要分两步。首先调用构造函数，然后调用 Create ，该函数创建旋转按钮控件并将它与 CSpinButtonCtrl 对象连接。

可以指定下面的风格给旋转按钮控件：

UDS_HORZ 控件的箭头指向左和右，而不是指向上和下

。
UDS_WRAP 如果控件的增加或减小超过了结尾或开始，

使控件可以 “ 环绕 ” 。
UDS_ARROWKEYS 当按下向上和向下键时，使控件可以增加

或减小。
UDS_SETBUDDYINT 当位置改变时，使控件设置伙伴窗口的

文本（使用

WM_SETTEXT 消息）。文本是按十进制或十六进制格式化后的位置值。

UDS_NOTHOUSANDS 不要在每隔三个十进制数字的地方加千

分隔符。
UDS_AUTOBUDDY 自动选择一个 Z-order 中的前一个窗口作为

控件的伙伴窗口。
UDS_ALIGNRIGHT 将旋转按钮窗口定位在伙伴窗口的右边

。伙伴窗口的宽度被减小来适应此控件的宽度。
UDS_ALIGNLEFT 将旋转按钮窗口定位在伙伴窗口的右边。

伙伴窗口被

移动到右边，并且它的宽度被减小来适应此控件的宽度。

请参阅 CSpinButtonCtrl::CSpinButtonCtrl

CSpinButtonCtrl::CSpinButtonCtrl

CSpinButtonCtrl( );

说明

此成员函数用来构造一个 CSpinButtonCtrl 对象。

请参阅 CSpinButtonCtrl::Create

CSpinButtonCtrl::GetAccel

UINT GetAccel( int nAccel , UDACCEL* pAccel ) const;

返回值

返回所获取的加速器结构的数目。

参数

nAccel

由 pAccel 指定的数组中的元素数目。

pAccel

指向一个 UDACCEL 结构数组的指针，该数组用来接收加速信息。

说明

此成员函数用来获取一个旋转按钮控件的加速信息。

请参阅 CSpinButtonCtrl::SetAccel

CSpinButtonCtrl::GetBase

UINT GetBase( ) const;

返回值

返回当前的基数值。

说明

此成员函数用来获取一个旋转按钮控件的当前基数值。

请参阅 CSpinButtonCtrl::SetBase

CSpinButtonCtrl::GetBuddy

CWnd* GetBuddy( ) const;

返回一个指向当前伙伴窗口的指针。

说明

此成员函数用来获取一个指向当前伙伴窗口的指针。

请参阅 CSpinButtonCtrl::SetBuddy

CSpinButtonCtrl::GetPos

int GetPos( ) const;

返回值

返回值的低位字中是当前位置。如果发生了一个错误，则高位字是非零值。

此成员函数用来获取一个旋转按钮控件的当前位置。控件根据伙伴窗口的标题来更新它的当前位置，获得要返回的值。如果没有伙伴窗口或者如果标题指示的是一个无效或超出范围的值，则返回一个错误信息。

请参阅 CSpinButtonCtrl::SetPos

C SpinButtonCtrl::GetRange

DWORD GetRange( ) const;

void GetRange( int & lowe r, int& upper ) const; void GetRange32( int & lowe r, int& upper ) const;

返回值

第一个版本返回一个 32 位的值，包含了上限和下限值。低位字是控件的上限，

高位字是控件的下限。

参数

lower

对一个用来接收控件的下限的整数的引用。

upper

对一个用来接收控件的上限的整数的引用。

说明

此成员函数用来获取一个旋转按钮控件的上限和下限（范围）。

成员函数 GetRange32 获取此旋转按钮控件的用一个 32 位的整数表示的范围。

请参阅 CSpinButtonCtrl::SetRange

CSpinButtonCtrl::SetAccel

BOOL SetAccel( int nAcce l, UDACCEL* pAccel );

返回值

如果成功则返回非零值；否则返回 0 。

参数

nAccel

由 pAccel 指定的 UDACCEL 结构的数目。

pAccel

指向一个 UDACCEL 结构数组的指针，该数组包含了加速信息。元素根据 nSec 成员按升序保存。

说明

此成员函数用来设置一个旋转按钮控件的加速。

请参阅 CSpinButtonCtrl::GetAccel

CSpinButtonCtrl::SetBase

int SetBase( int nBase );

返回值

如果成功则返回先前的基数值，如果给出的是一个无效的基数则返回一个非零值。

参数

nBase

控件的新的基数。

说明

此成员函数用来设置一个旋转按钮控件的基数。这个基数值决定了伙伴窗口显示的数字是十进制的还是十六进制的。十六进制的数总是无符号的；十进制的数是有符号的。

请参阅 CSpinButtonCtrl::GetBase

CSpinButtonCtrl::SetBuddy

CWnd* SetBuddy( CWnd* pWndBuddy );

返回值

一个指向先前的伙伴窗口的指针。

pWndBuddy

指向新的伙伴窗口的指针。

说明

此成员函数用来为一个旋转控件设置伙伴窗口。

请参阅 CSpinButtonCtrl::GetBuddy

CSpinButtonCtrl::SetPos

int SetPos( int nPos );

返回值

返回原来的位置。

nPos

控件的新位置。这个值必须在控件的上限和下限指定的范围之内。

说明

此成员函数用来设置一个旋转按钮控件的当前位置。

请参阅 CSpinButtonCtrl::SetRange, CSpinButtonCtrl::GetPos

CSpinButtonCtrl::SetRange

void SetRange( int nLower , int nUpper ); void SetRange32( int nLower , int nUpper );

参数

nLower and nUpper

控件的上限和下限。任何一个界限值都不能大于 UD_MAXVAL 或小于

UD_ MINVA L 。另外，两个界限值之间的差值必须不超过 UD_MAXVAL 。

说明

此成员函数用来设置一个旋转按钮控件的上限和下限（范围）。成员函数 SetRange32 为此旋转按钮控件设置 32 位的范围。

注意旋转按钮控件的缺省范围将最大值设置为零（ 0 ），而最小值设置为 100 。由于最大值小于最小值，所以点击向上箭头将减小位置值，而点击向下箭头则增加位置值。使用 CSpinButtonCtrl::SetRange 来调整这些值。

请参阅 CSpinButtonCtrl::GetRange, CSpinButtonCtrl::GetPos, Using CSpinButtonCtrl

CSpinButtonCtrl

CSpinButtonCtrl

CSpinButtonCtrl 类 成 员

成 员 函 数

CSpinButtonCtrl 类成员

成员函数