style_t

概述

控件风格。

widget从style对象中,获取诸如字体、颜色和图片相关的参数,根据这些参数来绘制界面。

  1. style_t* style = widget->astyle;
  2. int32_t margin = style_get_int(style, STYLE_ID_MARGIN, 2);
  3. int32_t icon_at = style_get_int(style, STYLE_ID_ICON_AT, ICON_AT_AUTO);
  4. uint16_t font_size = style_get_int(style, STYLE_ID_FONT_SIZE, TK_DEFAULT_FONT_SIZE);

属性名称的请参考style_id


函数

函数名称 说明
style_destroy 销毁style对象
style_get_color 获取指定name的颜色值。
style_get_int 获取指定name的整数格式的值。
style_get_str 获取指定name的字符串格式的值。
style_is_valid 检查style对象是否有效
style_notify_widget_state_changed widget状态改变时,通知style更新数据。

style_destroy 函数


  • 函数功能:

销毁style对象

  • 函数原型:
  1. ret_t style_destroy (style_t* s);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
s style_t* style对象。

style_get_color 函数


  • 函数功能:

获取指定name的颜色值。

  • 函数原型:
  1. color_t style_get_color (style_t* s, const char* name, color_t defval);
  • 参数说明:
参数 类型 说明
返回值 color_t 返回颜色值。
s style_t* style对象。
name const char* 属性名。
defval color_t 缺省值。

style_get_int 函数


  • 函数功能:

获取指定name的整数格式的值。

  • 函数原型:
  1. int32_t style_get_int (style_t* s, const char* name, int32_t defval);
  • 参数说明:
参数 类型 说明
返回值 int32_t 返回整数格式的值。
s style_t* style对象。
name const char* 属性名。
defval int32_t 缺省值。

style_get_str 函数


  • 函数功能:

获取指定name的字符串格式的值。

  • 函数原型:
  1. const char* style_get_str (style_t* s, const char* name, const char* defval);
  • 参数说明:
参数 类型 说明
返回值 const char* 返回字符串格式的值。
s style_t* style对象。
name const char* 属性名。
defval const char* 缺省值。

style_is_valid 函数


  • 函数功能:

检查style对象是否有效

  • 函数原型:
  1. bool_t style_is_valid (style_t* s);
  • 参数说明:
参数 类型 说明
返回值 bool_t 返回是否有效。
s style_t* style对象。

style_notify_widget_state_changed 函数


  • 函数功能:

widget状态改变时,通知style更新数据。

  • 函数原型:
  1. ret_t style_notify_widget_state_changed (style_t* s, widget_t* widget);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
s style_t* style对象。
widget widget_t* 控件对象。