微调控件(CSpinButtonCtrl)

微调控件(CSpinButtonCtrl)
旋转按钮控件

“旋转按钮控件”(也称为上下控件)是一对箭头按钮,用户点击它们来增加或减小某个值,比如一个滚动位置或显示在相应控件中的一个数字。一个旋转控件通常是与一个相伴的控件一起使用的,这个控件称为“伙伴窗口”。

一个旋转按钮控件可以自动定位在它的伙伴窗口的旁边,看起来就像一个单一的控件。通常,将一个旋转按钮控件与一个编辑控件一起使用,以提示用户进行数字输入。点击向上箭头使当前位置向最大值方向移动,而点击向下箭头使当前位置向最小值的方向移动。缺省时,最小值是100,最大值是0,当用户点击向上箭头则减少数值,而点击向下箭头则增加它,这看起来就像颠倒一样,因此我们还需使用成员函数CSpinButtonCtrl::SetRange来改变最大和最小值。

设置属性:


Auto Buddy         (自动取关联控件为TAB顺序前一个)
Set Buddy Interger      (使控件设置关联控件数值,这个值可以是十进制或十六进制)
Wrap            (数值超过范围时循环)
Arrow keys                         (当按下向上和向下方向键时,控件可以增加或减小)

(1)旋转按钮控件常用的风格

 旋转按钮控件常用的风格有:

 

UDS_HORZ

控件的箭头指向左和右,而不是指向上和下。

 

UDS_WRAP

若控件的增加或减小超过了结尾或开始,使数值可以“循环”。

 

UDS_ARROWKEYS

当按下向上和向下方向键时,控件可以增加或减小。

 

UDS_SETBUDDYINT

使控件设置伙伴窗口数值,这个值可以是十进制或十六进制。

 

UDS_NOTHOUSANDS

不在每隔三个十进制数字的地方加上千分隔符。

 

UDS_AUTOBUDDY

自动选择一个Z-order中的前一个窗口作为控件的伙伴窗口。

 

UDS_ALIGNRIGHT

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

 

UDS_ALIGNLEFT

将旋转按钮窗口定位在伙伴窗口的右边。伙伴窗口被移动到右边,并且它的宽度被减小来适应此控件的宽度。

这些风格也可通过旋转按钮控件属性对话框来设置,其Styles属性说明如下:

 

Orientation

控件放置方向:Vedical(垂直)、Hofizontal(水平,同UDS_HORZ)。

Alignment

控件在伙伴窗口的位置安排:Unattached(不相干)、Right(右边,同UDS_ALIGNRIGHT)、Left(左边, 同UDS_ALlGNLEFT)。

Auto buddy

同UDS_AUTOBUDDY。

 

Set buddy integer

同UDS_SETBUDDYINT。

No thousands

同UDS_NOTHOUSANDS。

Wrap

同UDS_WRAP。

Arrow keys

同UDS_ARROWKEYS。

Hot track

鼠标热点跟踪。

(2)旋转按钮控件的基本操作

基本操作包括基数、范围、位置设置和获取,分别说明如下:

基数的设置和获取

 成员函数SetBase是用来设置其基数的,其原型如下:

 int SetBase(int nBase);

 此成员函数用来设置一个旋转按钮控件的基数.这个基数值决定了伙伴窗口显示的数字是十进制的还是十六进制的.十六进制的数总是无符号的;十进制的数是有符号的.如果成功则返回先前的基数值,如果给出的是一个无效的基数则返回一个非零值。参数nBase表示控件的新的基数.

 与此函数相对应的是获取一个旋转按钮控件的基数的成员函数:UINT GetBase()const;

范围及当前位置的设定和获取

 成员函数SetPos、SetRange是用来设置一个旋转按钮控件的当前位置和范围,其原型如下:

int SetPos(int nPos);

 参数nPos表示控件的新位置.这个值必须在控件的上限和下限指定的范围之内.

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

参数nLower和nUpper表示控件的上限和下限.任何一个界限值都不能大于UD_MAXVAL或小于UD_MINVAL。另外,两个界限值之间的差值必须不超过UD_MAXVAL。成员函数SetRange32为此旋转按钮控件设置32位的范围。

与上述函数相对应的成员函数有:

 int GetPos()const;
DWORD GetRange()const;
void GetRange(int& lower,int& upper)const;
void GetRange32(int& lower,int& upper)const;

其他操作成员函数

 CWnd* SetBuddy(CWnd* pWndBuddy);

 此成员函数用来为一个旋转控件设置伙伴窗口。返回值一个指向先前的伙伴窗口的指针。参数pWndBuddy表示指向新的伙伴窗口的指针。

 BOOL SetAccel(int nAccel,UDACCEL* pAccel);

 此成员函数用来设置一个旋转按钮控件的加速。如果成功则返回非零值;否则返回0。参数nAccel表示由pAccel指定的UDACCEL结构的数目.pAccel指向一个UDACCEL结构数组的指针,该数组包含了加速信息,其结构如下:

typedef struct{
UINT nSec;//位置改变前所等待的秒数。
UINT nInc;//位置增量。
}UDACCEL,FAR* LPUDACCEL;

对应的成员函数为:

CWnd* GetBuddy()const;  

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

(3)旋转按钮控件的通知消息

旋转按钮控件的通知消息只有一个:UDN_DELTAPOS,它表示控件的位置将要改变。
用ClassWizard可以映射此消息,在此消息的处理函数中有个NM_UPDOWN结构需要进行

说明,其结构如下:

typedef struct _NM_UPDOWN{
NMHDR hdr;                   //通知代码的其他信息
int iPos;                         //当前位置
int iDelta;                      //位置的增减量,单击向上箭头此值为负数
}NMUPDOWN,FAR* LPNMUPDOWN;

实例代码如下:

CSpinButtonCtrl *pSBC;
pSBC = new CSpinButtonCtrl();
RECT rcEdit;
this->GetDlgItem(IDC_EDIT1)->GetWindowRect(&rcEdit);
pSBC->Create(UDS_WRAP | UDS_ALIGNRIGHT |UDS_SETBUDDYINT ,
rcEdit,
this,
IDC_SPIN_EDIT
);
pSBC->SetBuddy(this->GetDlgItem(IDC_EDIT1));
pSBC->SetRange32(0,100);
pSBC->SetBase(0);
pSBC->SetPos(1);
pSBC->ShowWindow(SW_NORMAL);
原文地址:https://www.cnblogs.com/zengcan/p/1655359.html