概述
标签按钮控件。
标签按钮有点类似单选按钮,但点击标签按钮之后会自动切换当前的标签页。
tab_button_t是widget_t的子类控件,widget_t的函数均适用于tab_button_t控件。
在xml中使用”tab_button”标签创建标签按钮控件。如:
<tab_button_group x="c" y="bottom:10" w="90%" h="30" compact="true" >
<tab_button text="General"/>
<tab_button text="Network" value="true" />
<tab_button text="Security"/>
</tab_button_group>
标签按钮一般放在标签按钮分组中,布局由标签按钮分组控件决定,不需要指定自己的布局参数和坐标。
更多用法请参考:
tab control
可用通过style来设置控件的显示风格,如字体的大小和颜色等等。如:
<tab_button>
<style name="default" border_color="#a0a0a0" text_color="black">
<normal bg_color="#d0d0d0" />
<pressed bg_color="#f0f0f0" />
<over bg_color="#e0e0e0" />
<normal_of_active bg_color="#f0f0f0" />
<pressed_of_active bg_color="#f0f0f0" />
<over_of_active bg_color="#f0f0f0" />
</style>
</tab_button>
函数
属性
事件
事件名称 |
类型 |
说明 |
EVT_VALUE_WILL_CHANGE |
event_t |
值(激活状态)即将改变事件。 |
EVT_VALUE_CHANGED |
event_t |
值(激活状态)改变事件。 |
转换tab_button对象(供脚本语言使用)。
widget_t* tab_button_cast (widget_t* widget);
参数 |
类型 |
说明 |
返回值 |
widget_t* |
tab_button对象。 |
widget |
widget_t* |
tab_button对象。 |
创建tab_button对象
widget_t* tab_button_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 |
高度 |
设置控件的active图标。
ret_t tab_button_set_active_icon (widget_t* widget, char* name);
参数 |
类型 |
说明 |
返回值 |
ret_t |
返回RET_OK表示成功,否则表示失败。 |
widget |
widget_t* |
tab_button对象。 |
name |
char* |
当前项的图标。 |
设置控件的图标。
ret_t tab_button_set_icon (widget_t* widget, char* name);
参数 |
类型 |
说明 |
返回值 |
ret_t |
返回RET_OK表示成功,否则表示失败。 |
widget |
widget_t* |
tab_button对象。 |
name |
char* |
当前项的图标。 |
设置控件的值。
ret_t tab_button_set_value (widget_t* widget, uint32_t value);
参数 |
类型 |
说明 |
返回值 |
ret_t |
返回RET_OK表示成功,否则表示失败。 |
widget |
widget_t* |
tab_button对象。 |
value |
uint32_t |
值 |
active_icon 属性
当前项的图标的名称。
特性 |
是否支持 |
可直接读取 |
是 |
可直接修改 |
否 |
可持久化 |
是 |
可脚本化 |
是 |
可在IDE中设置 |
是 |
可在XML中设置 |
是 |
可通过widget_get_prop读取 |
是 |
可通过widget_set_prop修改 |
是 |
icon 属性
非当前项的图标的名称。
特性 |
是否支持 |
可直接读取 |
是 |
可直接修改 |
否 |
可持久化 |
是 |
可脚本化 |
是 |
可在IDE中设置 |
是 |
可在XML中设置 |
是 |
可通过widget_get_prop读取 |
是 |
可通过widget_set_prop修改 |
是 |
value 属性
值。
特性 |
是否支持 |
可直接读取 |
是 |
可直接修改 |
否 |
可持久化 |
是 |
可脚本化 |
是 |
可在IDE中设置 |
是 |
可在XML中设置 |
是 |
可通过widget_get_prop读取 |
是 |
可通过widget_set_prop修改 |
是 |