awtk开发实践——学习篇29： image_value（图片值控件）

本文链接：https://blog.csdn.net/weixin_42645653/article/details/120879065

说明：
本文章旨在总结备份、方便以后查询，由于是个人总结，如有不对，欢迎指正；另外，内容大部分来自网络、书籍、和各类手册，如若侵权请告知，马上删帖致歉。
QQ 群号：513683159 【相互学习】
内容来源：
官方的手册（免费获取）Pxx=该手册的对应页码xx
github-awtk

控件说明

关于 image_value控件（图片值控件） 介绍，对应书 P167。(书中还有更详细内容).
①可以用图片来表示如电池电量、WIFI 信号强度和其它各种数值的值。
②image_value_t是 widget_t的子类控件，widget_t的函数均适用于 image_value_t控件。
其原理如下：
1. 把 value 以 format 为格式转换成字符串
2. 把每个字符与 image（图片文件名前缀）映射成一个图片名。
3. 最后把这些图片显示出来。

image_value.c

#include "awtk.h"

static ret_t on_timer_update(const timer_info_t* timer) {
  widget_t* win = WIDGET(timer->ctx);
  widget_t* image_value = widget_lookup(win, "image_value01", TRUE);	//查找指定名称的子控件(返回第一个)。
  image_value_set_value(image_value, IMAGE_VALUE(image_value)->value + 1);//设置值。

  return RET_REPEAT;
}

ret_t application_init() {
  widget_t* image_value = NULL;
  widget_t* win = window_create(NULL, 0, 0, 0, 0);				//创建window对象

  image_value = image_value_create(win, 10, 10, 200, 200);		//创建image_value对象

  widget_set_name(image_value, "image_value01");				//设置控件的名称。
  image_value_set_image(image_value, "num_");					//设置图片前缀
  image_value_set_value(image_value, 100);						//设置值

  widget_add_timer(win, on_timer_update, 1000);					//创建定时器。该定时器在控件销毁时自动销毁，timer_info_t的ctx为widget。如果定时器的生命周期与控件无关，请直接调用timer_add，以避免不必要的内存开销。

  return RET_OK;
}