awtk/docs/manual/style_t.md

style_t

概述

控件风格。

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

style_t* style = widget->astyle;
int32_t margin = style_get_int(style, STYLE_ID_MARGIN, 2);
int32_t icon_at = style_get_int(style, STYLE_ID_ICON_AT, ICON_AT_AUTO);
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_mutable	检查style是否是mutable的。
style_is_valid	检查style对象是否有效
style_normalize_value	对值进行正规化。
style_notify_widget_state_changed	widget状态改变时，通知style更新数据。
style_set	设置指定状态的指定属性的值(仅仅对mutable的style有效)。

style_destroy 函数

---

• 函数功能：

销毁style对象

• 函数原型：

ret_t style_destroy (style_t* s);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
s	style_t*	style对象。

style_get_color 函数

---

• 函数功能：

获取指定name的颜色值。

• 函数原型：

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的整数格式的值。

• 函数原型：

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的字符串格式的值。

• 函数原型：

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_mutable 函数

---

• 函数功能：

检查style是否是mutable的。

• 函数原型：

bool_t style_is_mutable (style_t* s);

• 参数说明：

参数	类型	说明
返回值	bool_t	返回TRUE表示是，否则表示不是。
s	style_t*	style对象。

style_is_valid 函数

---

• 函数功能：

检查style对象是否有效

• 函数原型：

bool_t style_is_valid (style_t* s);

• 参数说明：

参数	类型	说明
返回值	bool_t	返回是否有效。
s	style_t*	style对象。

style_normalize_value 函数

---

• 函数功能：

对值进行正规化。

• 函数原型：

ret_t style_normalize_value (const char* name, const char* value, value_t* out);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
name	const char*	名称。
value	const char*	值。
out	value_t*	返回的值。

style_notify_widget_state_changed 函数

---

• 函数功能：

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

• 函数原型：

ret_t style_notify_widget_state_changed (style_t* s, widget_t* widget);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
s	style_t*	style对象。
widget	widget_t*	控件对象。

style_set 函数

---

• 函数功能：

设置指定状态的指定属性的值(仅仅对mutable的style有效)。

• 函数原型：

ret_t style_set (style_t* s, const char* state, const char* name, const value_t* value);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
s	style_t*	style对象。
state	const char*	状态。
name	const char*	属性名。
value	const value_t*	值。