spin_box_t

概述

image

spinbox控件。

一个特殊的数值编辑器,将edit_t和button_t进行组合,方便编辑数值。

点击向上的按钮将数值增加一个step,点击向下的按钮将数值减小一个step。
step的值可以通过step属性进行设置。

spin_box_t是edit_t的子类控件,edit_t的函数均适用于spin_box_t控件。

在xml中使用”spin_box”标签创建spinbox控件。如:

  1. <spin_box w="70%" input_type="int" min="-100" max="100" step="5">

>
更多用法请参考:spin_box.xml

在c代码中使用函数spin_box_create创建spinbox控件。如:

  1. widget_t* spin_box = spin_box_create(win, 10, 10, 128, 30);
  2. edit_set_input_type(spin_box, type);

创建之后:

可以用edit相关函数去设置它的各种属性。

完整示例请参考:spin_box
demo

可用通过style来设置控件的显示风格,如背景和边框等。如:

  1. <spin_box>
  2. <style name="default" border_color="#a0a0a0" text_color="black" text_align_h="left">
  3. <normal bg_color="#f0f0f0" />
  4. <focused bg_color="#f0f0f0" border_color="black"/>
  5. <disable bg_color="gray" text_color="#d0d0d0" />
  6. <error bg_color="#f0f0f0" text_color="red" />
  7. <empty bg_color="#f0f0f0" text_color="#a0a0a0" />
  8. </style>
  9. </spin_box>

更多用法请参考:theme
default


函数

函数名称 说明
spin_box_cast 转换为spin_box对象(供脚本语言使用)。
spin_box_create 创建spin_box对象

spin_box_cast 函数


  • 函数功能:

转换为spin_box对象(供脚本语言使用)。

  • 函数原型:
  1. widget_t* spin_box_cast (widget_t* widget);
  • 参数说明:
参数 类型 说明
返回值 widget_t* spin_box对象。
widget widget_t* spin_box对象。

spin_box_create 函数


  • 函数功能:

创建spin_box对象

  • 函数原型:
  1. widget_t* spin_box_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);
  • 参数说明:
参数 类型 说明
返回值 widget_t* 对象。
parent widget_t* 父控件
x xy_t x坐标
y xy_t y坐标
w wh_t 宽度
h wh_t 高度