image_value_t

概述

图片值控件。

可以用图片来表示如电池电量、WIFI信号强度和其它各种数值的值。

其原理如下：

• 1.把value以format为格式转换成字符串。
• 2.把每个字符与image(图片文件名前缀)映射成一个图片名。
• 3.最后把这些图片显示出来。

image_value_t是widget_t的子类控件，widget_t的函数均适用于image_value_t控件。

在xml中使用”image_value”标签创建图片值控件。如：

 <image_value  value="0" image="num_" />

更多用法请参考：
image_value

在c代码中使用函数image_value_create创建图片值控件。如：

 image_value = image_value_create(win, 10, 10, 200, 200);
 image_value_set_image(image_value, "num_");
 image_value_set_value(image_value, 100);

完整示例请参考：
image_value demo

可用通过style来设置控件的显示风格，如背景颜色和边框等等，不过一般情况并不需要。

函数

属性

image_value_cast 函数

• 函数功能：

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

• 函数原型：

widget_t* image_value_cast (widget_t* widget);

• 参数说明：

image_value_create 函数

• 函数功能：

创建image_value对象

• 函数原型：

widget_t* image_value_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);

• 参数说明：

image_value_set_format 函数

• 函数功能：

设置格式。

• 函数原型：

ret_t image_value_set_format (widget_t* widget, const char* format);

• 参数说明：

image_value_set_image 函数

• 函数功能：

设置图片前缀。

• 函数原型：

ret_t image_value_set_image (widget_t* widget, const char* image);

• 参数说明：

image_value_set_value 函数

• 函数功能：

设置值。

• 函数原型：

ret_t image_value_set_value (widget_t* widget, float_t value);

• 参数说明：

format 属性

数值到字符串转换时的格式，缺省为”%d”。

• 类型：char*

image 属性

图片名称的前缀。

• 类型：char*

value 属性

值。

• 类型：float_t