配置数值控件<spinner>


如下图所示为一个数值控件:

IntegerUpDownControl

在配置文件中,每一个数值控件对应一个 <spinner>…</spinner> 标签,向界面中添加数值控件,只需添加 <spinner>…</spinner> 标签,并对标签的属性进行相应的设置 即可完成界面中数值控件的添加,要添加多个数值控件,就相应地添加多个 <spinner>…</spinner> 标签,下面详细介绍 <spinner>… 标签的各个属性的含义与作用:

<group id="FillStyle" index="12" label="填充风格" ......>
    ......
    <spinner index="0" name="透明度:" visible="true" onAction="CtrlActionFillOpaqueRate" minValue="0" maxValue="100" increment="1" />
</group>
  • index :用于数值控件排序,即当同一层次上存在多个数值控件时,每个数值控件将通过该属性的值来确定其排列次序。
  • name :数值控件的名称,必填参数。
  • minValue :指定数字显示框中数值的最小值,即数字显示框中输入的数值不能小于这个最小值。
  • maxValue :指定数字显示框中数值的最大值,即数字显示框中输入的数值不能超过这个最大值。
  • increment :设置点击数字显示框中的微调按钮(垂直风格)或者点击滑块的 ”+”/”-” 按钮(水平风格)时,数字显示框中的数值每次增减的步长。
  • onAction :当数字显示框中的数值改变时,会执行由该属性指定的内容,该属性可以指定为一个继承 CtrlAction 类或者实现了 ICtrlAction 接口的类。
  • visible :指定数值控件是否可见,该属性的值为 true 时,表示可见,false 为不可见。
  • value :指定数字显示框中当前显示的数值。
  • screenTip :指定鼠标停留在数值控件上时所显示的提示信息。
  • screenTipImage :鼠标停留在按钮控件上时将显示提示信息,该属性可以在提示信息中插入图片以辅助信息说明,该属性的值为图片的全路径。