awtk/docs/manual/theme_t.md
2019-01-15 14:34:05 +08:00

178 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## theme\_t
### 概述
主题。
负责管理缺省的主题数据方便实现style\_const。
----------------------------------
### 函数
<p id="theme_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
| <a href="#theme_t_theme">theme</a> | 获取缺省的主题对象。 |
| <a href="#theme_t_theme_create">theme\_create</a> | 创建主题对象。 |
| <a href="#theme_t_theme_deinit">theme\_deinit</a> | 析构主题对象。 |
| <a href="#theme_t_theme_destroy">theme\_destroy</a> | 析构并释放主题对象。 |
| <a href="#theme_t_theme_find_style">theme\_find\_style</a> | 查找满足条件的style。 |
| <a href="#theme_t_theme_init">theme\_init</a> | 初始化主题对象。 |
| <a href="#theme_t_theme_set">theme\_set</a> | 设置缺省的主题对象。 |
#### theme 函数
-----------------------
* 函数功能:
> <p id="theme_t_theme"> 获取缺省的主题对象。
* 函数原型:
```
theme_t* theme ();
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | theme\_t* | 返回主题对象。 |
#### theme\_create 函数
-----------------------
* 函数功能:
> <p id="theme_t_theme_create"> 创建主题对象。
* 函数原型:
```
theme_t* theme_create (const uint8_t* data);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | theme\_t* | 返回主题对象。 |
| data | const uint8\_t* | 主题数据。 |
#### theme\_deinit 函数
-----------------------
* 函数功能:
> <p id="theme_t_theme_deinit"> 析构主题对象。
* 函数原型:
```
ret_t theme_deinit (theme_t* theme);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| theme | theme\_t* | 主题对象。 |
#### theme\_destroy 函数
-----------------------
* 函数功能:
> <p id="theme_t_theme_destroy"> 析构并释放主题对象。
* 函数原型:
```
ret_t theme_destroy (theme_t* theme);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| theme | theme\_t* | 主题对象。 |
#### theme\_find\_style 函数
-----------------------
* 函数功能:
> <p id="theme_t_theme_find_style"> 查找满足条件的style。
* 函数原型:
```
theme_t* theme_find_style (theme_t* data, const char* widget_type, const char* name, const char* widget_state);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | theme\_t* | 返回主题对象。 |
| data | theme\_t* | 主题对象。 |
| widget\_type | const char* | 控件的类型名。 |
| name | const char* | style的名称。 |
| widget\_state | const char* | 控件的状态。 |
#### theme\_init 函数
-----------------------
* 函数功能:
> <p id="theme_t_theme_init"> 初始化主题对象。
* 函数原型:
```
theme_t* theme_init (theme_t* theme, const uint8_t* data);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | theme\_t* | 返回主题对象。 |
| theme | theme\_t* | 主题对象。 |
| data | const uint8\_t* | 主题数据。 |
#### theme\_set 函数
-----------------------
* 函数功能:
> <p id="theme_t_theme_set"> 设置缺省的主题对象。
* 函数原型:
```
ret_t theme_set (theme_t* theme);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| theme | theme\_t* | 主题对象。 |