# SpinButton 数值调节按钮

用于增加及减少数值。

  • 单击数值调节钮只会更改数值调节钮的值。可以编写代码来用数值调节钮更新其他控件的显示值。例如,可用数值调节钮更改显示在日期中的年、月或日。也可用数值调节钮在某个取值范围或项目列表中滚动,或更改文本框中显示的值。

  • 若要显示通过数值调节钮更新的值,必须将数值调节钮的值赋给某个控件的显示部分,例如标签控件的 Caption 属性或文本框的 Text 属性。若要创建横向或纵向的数值调节钮,请在窗体中沿横向或纵向拖动数值调节钮的尺寸控点。

  • 数值调节钮的默认属性是 Value 属性。

  • 数值调节钮的默认事件是 Change 事件。

属性
属性 说明
BackColor 规定对象的背景色。
BoundValue 控件接受焦点时,包含控件的值。
ControlSource 标识用于设置或储存控件中 Value 属性的数据位置。ControlSource 属性可接受 Microsoft Excel 工作表区域。
ControlTipText 指定当用户将鼠标指针放在控件上但未按下时所显示的文本。
Delay 指定数值调节钮或滚动条上的 SpinUp、 SpinDown 和 Change 事件的延迟。
Enabled 指定一个控件能否接受焦点和响应用户产生的事件。
ForeColor 指定对象的前景色。
Height、Width 对象的高度和宽度,以磅为单位。
HelpContextID HelpContextID 属性将一个自定义 Microsoft Windows 帮助文件中的特定主题与一个指定的控件相关联。
LayoutEffect 指定在改变布局期间控件是否移动。
Left、Top 控件与所在窗体的左边或顶边之间的距离。
Max、Min 规定滚动条或数值调节钮的 Value 属性可接收的最大值和最小值。
MouseIcon 为对象指定一个自定义的图标。
MousePointer 指定当用户把鼠标放到特定对象上时,所显示鼠标指针的类型。
Name 指定一个控件或对象的名称或与 Font 对象相关的字体的名称。
Object 当新控件具有与标准属性或方法同名的属性或方法时,则覆盖相应的标准属性或方法。
OldHeight、OldWidth 返回控件先前的高度或宽度,以磅为单位。
OldLeft、OldTop 返回控件先前位置与所在窗体的左边或顶边之间的距离,以磅为单位。
Orientation 规定数值调节钮或滚动条是垂直方向还是水平方向。
Parent 返回包含指定控件、对象或集合的窗体、对象或集合的名字。
SmallChange 规定当用户单击滚动条或数值调节钮中的滚动箭头时发生的位移量。
TabIndex 指定单个对象在窗体 Tab 键顺序中的位置。
TabStop 指定当用户跳格到一个对象时,该对象能否获得焦点 。
Tag 存储对象的附加信息。
Value 定义某给定的控件的状态或内容。
Visible 定义一个对象是可视的还是被隐藏的。
方法
方法 说明
Move 移动一个窗体或控件,或者移动 Controls 集合中的所有控件。
SetFocus 将焦点移动到对象的实例中。
ZOrder 将对象放在 Z-顺序的前面或后面。
事件
事件 说明
AfterUpdate 在通过用户界面更改了控件中的数据后,此事件发生。
BeforeDragOver 当拖放操作正在进行时该事件发生。
BeforeUpdate 控件中的数据被改变之前该事件发生。
Change 当 Value 属性改变时该事件发生。
Enter、Exit 一个控件从同一窗体的另一个控件实际接收到焦点之前,Enter 事件发生。同一窗体中的一个控件即将把焦点转移到另一个控件之前,Exit 事件发生。
Error 当控件检测到一个错误,并且不能将该错误信息返回调用程序时该事件发生。
KeyDown、KeyUp 按下和释放某键时这两个事件依次发生。按下键时发生 KeyDown 事件,而释放键时发生 KeyUp 事件。
KeyPress 当用户按下一个 ANSI 键时该事件发生。
SpinDown、SpinUp 用户单击数值调节钮的向下或向左键时发生 SpinDown 事件。用户单击数值调节钮的向上或向向右键时发生 SpinUp 事件。
示例