update docs

docs/manual/asset_data_type_t.md

@@ -1,4 +1,3 @@
 ## asset\_data\_type\_t
 ### 概述
  字体资源类型定义。
-

docs/manual/asset_font_type_t.md

@@ -1,4 +1,3 @@
 ## asset\_font\_type\_t
 ### 概述
  字体资源类型定义。
-

docs/manual/asset_image_type_t.md

@@ -1,4 +1,3 @@
 ## asset\_image\_type\_t
 ### 概述
  图片资源类型定义。
-

docs/manual/asset_info_t.md

@@ -2,7 +2,6 @@
 ### 概述
  单个资源的描述信息。
 
-
 ----------------------------------
 ### 属性
 <p id="asset_info_t_properties">
@@ -20,7 +19,6 @@
 > <p id="asset_info_t_is_in_rom"> 资源是否在ROM中。
 
 
-
 * 类型：uint8\_t
 
 | 特性 | 是否支持 |
@@ -33,7 +31,6 @@
 > <p id="asset_info_t_name"> 名称。
 
 
-
 * 类型：char*
 
 | 特性 | 是否支持 |
@@ -47,7 +44,6 @@
  is\_in\_rom == FALSE时才有效。
 
 
-
 * 类型：uint32\_t
 
 | 特性 | 是否支持 |
@@ -60,7 +56,6 @@
 > <p id="asset_info_t_size"> 大小。
 
 
-
 * 类型：uint32\_t
 
 | 特性 | 是否支持 |
@@ -73,7 +68,6 @@
 > <p id="asset_info_t_subtype"> 子类型。
 
 
-
 * 类型：uint8\_t
 
 | 特性 | 是否支持 |
@@ -86,7 +80,6 @@
 > <p id="asset_info_t_type"> 类型。
 
 
-
 * 类型：uint16\_t
 
 | 特性 | 是否支持 |

docs/manual/asset_script_type_t.md

@@ -1,4 +1,3 @@
 ## asset\_script\_type\_t
 ### 概述
  脚本资源类型定义。
-

docs/manual/asset_type_t.md

@@ -1,7 +1,6 @@
 ## asset\_type\_t
 ### 概述
  资源类型常量定义。
-
 ### 常量
 <p id="asset_type_t_consts">
 

docs/manual/asset_ui_type_t.md

@@ -1,4 +1,3 @@
 ## asset\_ui\_type\_t
 ### 概述
  UI资源类型定义。
-

docs/manual/assets_manager_t.md

@@ -30,7 +30,6 @@
  ```
 
 
-
 ----------------------------------
 ### 函数
 <p id="assets_manager_t_methods">
@@ -62,7 +61,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -83,7 +81,6 @@ assets_manager_t* assets_manager ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -106,7 +103,6 @@ ret_t assets_manager_add (assets_manager_t* am, asset_info_t info);
 
 
 
-
 * 函数原型：
 
 ```
@@ -129,7 +125,6 @@ ret_t assets_manager_clear_cache (assets_manager_t* am, asset_type_t type);
 
 
 
-
 * 函数原型：
 
 ```
@@ -151,7 +146,6 @@ assets_manager_t* assets_manager_create (uint32_t init_nr);
 
 
 
-
 * 函数原型：
 
 ```
@@ -173,7 +167,6 @@ ret_t assets_manager_deinit (assets_manager_t* am);
 
 
 
-
 * 函数原型：
 
 ```
@@ -195,7 +188,6 @@ ret_t assets_manager_destroy (assets_manager_t* am);
 
 
 
-
 * 函数原型：
 
 ```
@@ -219,7 +211,6 @@ asset_info_t* assets_manager_find_in_cache (assets_manager_t* am, asset_type_t t
 
 
 
-
 * 函数原型：
 
 ```
@@ -242,7 +233,6 @@ assets_manager_t* assets_manager_init (assets_manager_t* am, uint32_t init_nr);
 
 
 
-
 * 函数原型：
 
 ```
@@ -266,7 +256,6 @@ asset_info_t* assets_manager_load (assets_manager_t* am, asset_type_t type, char
 
 
 
-
 * 函数原型：
 
 ```
@@ -290,7 +279,6 @@ ret_t assets_manager_preload (assets_manager_t* am, asset_type_t type, char* nam
 
 
 
-
 * 函数原型：
 
 ```
@@ -314,7 +302,6 @@ asset_info_t* assets_manager_ref (assets_manager_t* am, asset_type_t type, char*
 
 
 
-
 * 函数原型：
 
 ```
@@ -336,7 +323,6 @@ ret_t assets_manager_set (assets_manager_t* am);
 
 
 
-
 * 函数原型：
 
 ```
@@ -359,7 +345,6 @@ ret_t assets_manager_set_locale_info (assets_manager_t* am, locale_info_t* local
 
 
 
-
 * 函数原型：
 
 ```
@@ -382,7 +367,6 @@ ret_t assets_manager_set_res_root (assets_manager_t* am, const char* res_root);
 
 
 
-
 * 函数原型：
 
 ```
@@ -405,7 +389,6 @@ ret_t assets_manager_set_system_info (assets_manager_t* am, system_info_t* syste
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/bitmap_flag_t.md

@@ -1,7 +1,6 @@
 ## bitmap\_flag\_t
 ### 概述
  位图标志常量定义。
-
 ### 常量
 <p id="bitmap_flag_t_consts">
 

docs/manual/bitmap_format_t.md

@@ -1,7 +1,6 @@
 ## bitmap\_format\_t
 ### 概述
  位图格式常量定义。
-
 ### 常量
 <p id="bitmap_format_t_consts">
 

docs/manual/bitmap_t.md

@@ -2,7 +2,6 @@
 ### 概述
  位图。
 
-
 ----------------------------------
 ### 函数
 <p id="bitmap_t_methods">
@@ -38,7 +37,6 @@
 > <p id="bitmap_t_bitmap_create"> 创建图片对象(一般供脚本语言中使用)。
 
 
-
 * 函数原型：
 
 ```
@@ -59,7 +57,6 @@ bitmap_t* bitmap_create ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -83,7 +80,6 @@ bitmap_t* bitmap_create_ex (uint32_t w, uint32_t h, uint32_t line_length, bitmap
 > <p id="bitmap_t_bitmap_destroy"> 销毁图片。
 
 
-
 * 函数原型：
 
 ```
@@ -105,7 +101,6 @@ ret_t bitmap_destroy (bitmap_t* bitmap);
 
 
 
-
 * 函数原型：
 
 ```
@@ -127,7 +122,6 @@ uint32_t bitmap_get_bpp (bitmap_t* bitmap);
 
 
 
-
 * 函数原型：
 
 ```
@@ -149,7 +143,6 @@ ret_t bitmap_get_line_length (bitmap_t* bitmap);
 
 
 
-
 * 函数原型：
 
 ```
@@ -174,7 +167,6 @@ ret_t bitmap_get_pixel (bitmap_t* bitmap, uint32_t x, uint32_t y, rgba_t* rgba);
 
 
 
-
 * 函数原型：
 
 ```
@@ -201,7 +193,6 @@ ret_t bitmap_init (bitmap_t* bitmap, uint32_t w, uint32_t h, bitmap_format_t for
 
 
 
-
 * 函数原型：
 
 ```
@@ -228,7 +219,6 @@ ret_t bitmap_init_from_rgba (bitmap_t* bitmap, uint32_t w, uint32_t h, bitmap_fo
 
 
 
-
 * 函数原型：
 
 ```
@@ -247,7 +237,6 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_data"> 图片数据。
 
 
-
 * 类型：uint8\_t*
 
 | 特性 | 是否支持 |
@@ -259,7 +248,6 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_flags"> 标志。请参考{bitmap_flag_t}。
 
 
-
 * 类型：uint16\_t
 
 | 特性 | 是否支持 |
@@ -272,7 +260,6 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_format"> 格式。请参考{bitmap_format_t}。
 
 
-
 * 类型：uint16\_t
 
 | 特性 | 是否支持 |
@@ -285,7 +272,6 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_h"> 高度。
 
 
-
 * 类型：wh\_t
 
 | 特性 | 是否支持 |
@@ -298,7 +284,6 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_line_length"> 每一行实际占用的内存(也称为stride或pitch)，一般情况下为w*bpp。
 
 
-
 * 类型：uint32\_t
 
 | 特性 | 是否支持 |
@@ -311,7 +296,6 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_name"> 名称。
 
 
-
 * 类型：const char*
 
 | 特性 | 是否支持 |
@@ -324,7 +308,6 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_w"> 宽度。
 
 
-
 * 类型：wh\_t
 
 | 特性 | 是否支持 |

docs/manual/children_layouter_default_t.md

@@ -9,7 +9,6 @@
 https://github.com/zlgopen/awtk/blob/master/docs/children_layouter_default.md)
 
 
-
 ----------------------------------
 ### 函数
 <p id="children_layouter_default_t_methods">
@@ -29,7 +28,6 @@ https://github.com/zlgopen/awtk/blob/master/docs/children_layouter_default.md)
 
 
 
-
 * 函数原型：
 
 ```
@@ -50,7 +48,6 @@ children_layouter_t* children_layouter_default_create ();
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/children_layouter_factory_t.md

@@ -3,7 +3,6 @@
  子控件布局算法工厂。
 
 
-
 ----------------------------------
 ### 函数
 <p id="children_layouter_factory_t_methods">
@@ -24,7 +23,6 @@
 > <p id="children_layouter_factory_t_children_layouter_factory"> 获取缺省的子控件布局算法工厂对象。
 
 
-
 * 函数原型：
 
 ```
@@ -45,7 +43,6 @@ children_layouter_factory_t* children_layouter_factory ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -66,7 +63,6 @@ children_layouter_factory_t* children_layouter_factory_create ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -89,7 +85,6 @@ children_layouter_t* children_layouter_factory_create_layouter (children_layoute
 
 
 
-
 * 函数原型：
 
 ```
@@ -111,7 +106,6 @@ ret_t children_layouter_factory_destroy (children_layouter_factory_t* factory);
 
 
 
-
 * 函数原型：
 
 ```
@@ -135,7 +129,6 @@ ret_t children_layouter_factory_register (children_layouter_factory_t* factory,
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/children_layouter_list_view_t.md

@@ -9,7 +9,6 @@
 https://github.com/zlgopen/awtk/blob/master/docs/children_layouter_list_view.md)
 
 
-
 ----------------------------------
 ### 函数
 <p id="children_layouter_list_view_t_methods">
@@ -28,7 +27,6 @@ https://github.com/zlgopen/awtk/blob/master/docs/children_layouter_list_view.md)
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/children_layouter_t.md

@@ -5,7 +5,6 @@
  按特定算法对子控件进行排版布局，子类需要实现vtable中的函数。
 
 
-
 ----------------------------------
 ### 函数
 <p id="children_layouter_t_methods">
@@ -31,7 +30,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -54,7 +52,6 @@ children_layouter_t* children_layouter_create (const char* params);
 
 
 
-
 * 函数原型：
 
 ```
@@ -77,7 +74,6 @@ ret_t children_layouter_destroy (children_layouter_t* layouter);
 
 
 
-
 * 函数原型：
 
 ```
@@ -102,7 +98,6 @@ ret_t children_layouter_get_param (children_layouter_t* layouter, const char* na
 
 
 
-
 * 函数原型：
 
 ```
@@ -127,7 +122,6 @@ ret_t children_layouter_get_param_float (children_layouter_t* layouter, const ch
 
 
 
-
 * 函数原型：
 
 ```
@@ -152,7 +146,6 @@ ret_t children_layouter_get_param_int (children_layouter_t* layouter, const char
 
 
 
-
 * 函数原型：
 
 ```
@@ -175,7 +168,6 @@ bool_t children_layouter_is_valid (children_layouter_t* layouter);
 
 
 
-
 * 函数原型：
 
 ```
@@ -199,7 +191,6 @@ ret_t children_layouter_layout (children_layouter_t* layouter, widget_t* widget)
 
 
 
-
 * 函数原型：
 
 ```
@@ -224,7 +215,6 @@ ret_t children_layouter_set_param (children_layouter_t* layouter, const char* na
 
 
 
-
 * 函数原型：
 
 ```
@@ -248,7 +238,6 @@ ret_t children_layouter_set_param_str (children_layouter_t* layouter, const char
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/clip_board_data_type_t.md

@@ -1,7 +1,6 @@
 ## clip\_board\_data\_type\_t
 ### 概述
  剪切板数据类型定义。
-
 ### 常量
 <p id="clip_board_data_type_t_consts">
 

docs/manual/clip_board_t.md

@@ -2,7 +2,6 @@
 ### 概述
  剪切板接口。
 
-
 ----------------------------------
 ### 函数
 <p id="clip_board_t_methods">
@@ -26,7 +25,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -47,7 +45,6 @@ ret_t clip_board ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -69,7 +66,6 @@ ret_t clip_board_clear (clip_board_t* cl);
 
 
 
-
 * 函数原型：
 
 ```
@@ -91,7 +87,6 @@ ret_t clip_board_destroy (clip_board_t* cl);
 
 
 
-
 * 函数原型：
 
 ```
@@ -116,7 +111,6 @@ ret_t clip_board_get_data (clip_board_t* cl, clip_board_data_type_t* type, void*
 
 
 
-
 * 函数原型：
 
 ```
@@ -137,7 +131,6 @@ const char* clip_board_get_text ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -159,7 +152,6 @@ ret_t clip_board_set (clip_board_t* cl);
 
 
 
-
 * 函数原型：
 
 ```
@@ -184,7 +176,6 @@ ret_t clip_board_set_data (clip_board_t* cl, clip_board_data_type_t type, const
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/color_parser_t.md

@@ -13,7 +13,6 @@
  ```
 
 
-
 ----------------------------------
 ### 函数
 <p id="color_parser_t_methods">
@@ -38,7 +37,6 @@
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/color_t.md

@@ -3,7 +3,6 @@
  颜色。
 
 
-
 ----------------------------------
 ### 函数
 <p id="color_t_methods">
@@ -40,7 +39,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -67,7 +65,6 @@ uint8_t color_a (color_t* c);
 
 
 
-
 * 函数原型：
 
 ```
@@ -91,7 +88,6 @@ uint8_t color_b (color_t* c);
 
 
 
-
 * 函数原型：
 
 ```
@@ -116,7 +112,6 @@ color_t* color_cast (color_t* color);
 
 
 
-
 * 函数原型：
 
 ```
@@ -144,7 +139,6 @@ color_t* color_create (uint8_t r, uint8_t b, uint8_t g, uint8_t a);
 
 
 
-
 * 函数原型：
 
 ```
@@ -169,7 +163,6 @@ ret_t color_destroy (color_t* c);
 
 
 
-
 * 函数原型：
 
 ```
@@ -197,7 +190,6 @@ color_t* color_from_str (color_t* c, const char* str);
 
 
 
-
 * 函数原型：
 
 ```
@@ -219,7 +211,6 @@ uint8_t color_g (color_t* c);
 
 
 
-
 * 函数原型：
 
 ```
@@ -249,7 +240,6 @@ color_t color_init (uint8_t r, uint8_t g, uint8_t b, uint8_t a);
 
 
 
-
 * 函数原型：
 
 ```
@@ -267,7 +257,6 @@ uint8_t color_r (color_t* c);
 > <p id="color_t_color"> 颜色的数值。
 
 
-
 * 类型：uint32\_t
 
 | 特性 | 是否支持 |
@@ -280,7 +269,6 @@ uint8_t color_r (color_t* c);
 > <p id="color_t_rgba"> 颜色的RGBA值。
 
 
-
 * 类型：rgba\_t
 
 | 特性 | 是否支持 |

docs/manual/darray_t.md

@@ -20,7 +20,6 @@
  ```
 
 
-
 ----------------------------------
 ### 函数
 <p id="darray_t_methods">
@@ -62,7 +61,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -84,7 +82,6 @@ ret_t darray_clear (darray_t* darray);
 
 
 
-
 * 函数原型：
 
 ```
@@ -108,7 +105,6 @@ int32_t darray_count (darray_t* darray, void* ctx);
 
 
 
-
 * 函数原型：
 
 ```
@@ -132,7 +128,6 @@ darray_t* darray_create (uint32_t* capacity, tk_destroy_t destroy, tk_compare_t
 
 
 
-
 * 函数原型：
 
 ```
@@ -154,7 +149,6 @@ ret_t darray_deinit (darray_t* darray);
 
 
 
-
 * 函数原型：
 
 ```
@@ -176,7 +170,6 @@ ret_t darray_destroy (darray_t* darray);
 
 
 
-
 * 函数原型：
 
 ```
@@ -199,7 +192,6 @@ void* darray_find (darray_t* darray, void* ctx);
 
 
 
-
 * 函数原型：
 
 ```
@@ -222,7 +214,6 @@ int darray_find_index (darray_t* darray, void* ctx);
 
 
 
-
 * 函数原型：
 
 ```
@@ -246,7 +237,6 @@ ret_t darray_foreach (darray_t* darray, tk_visit_t visit, void* ctx);
 
 
 
-
 * 函数原型：
 
 ```
@@ -269,7 +259,6 @@ void* darray_head (darray_t* darray);
 
 
 
-
 * 函数原型：
 
 ```
@@ -294,7 +283,6 @@ darray_t* darray_init (darray_t* darray, uint32_t* capacity, tk_destroy_t destro
 
 
 
-
 * 函数原型：
 
 ```
@@ -316,7 +304,6 @@ void* darray_pop (darray_t* darray);
 
 
 
-
 * 函数原型：
 
 ```
@@ -339,7 +326,6 @@ ret_t darray_push (darray_t* darray, void* data);
 
 
 
-
 * 函数原型：
 
 ```
@@ -362,7 +348,6 @@ ret_t darray_remove (darray_t* darray, void* ctx);
 
 
 
-
 * 函数原型：
 
 ```
@@ -385,7 +370,6 @@ ret_t darray_remove_all (darray_t* darray, void* ctx);
 
 
 
-
 * 函数原型：
 
 ```
@@ -408,7 +392,6 @@ ret_t darray_remove_index (darray_t* darray, uint32_t index);
 
 
 
-
 * 函数原型：
 
 ```
@@ -426,7 +409,6 @@ void* darray_tail (darray_t* darray);
 > <p id="darray_t_capacity"> 数组的容量大小。
 
 
-
 * 类型：uint32\_t
 
 | 特性 | 是否支持 |
@@ -438,7 +420,6 @@ void* darray_tail (darray_t* darray);
 > <p id="darray_t_compare"> 元素比较函数。
 
 
-
 * 类型：tk\_compare\_t
 
 | 特性 | 是否支持 |
@@ -450,7 +431,6 @@ void* darray_tail (darray_t* darray);
 > <p id="darray_t_destroy"> 元素销毁函数。
 
 
-
 * 类型：tk\_destroy\_t
 
 | 特性 | 是否支持 |
@@ -462,7 +442,6 @@ void* darray_tail (darray_t* darray);
 > <p id="darray_t_elms"> 数组中的元素。
 
 
-
 * 类型：void**
 
 | 特性 | 是否支持 |
@@ -474,7 +453,6 @@ void* darray_tail (darray_t* darray);
 > <p id="darray_t_size"> 数组中元素的个数。
 
 
-
 * 类型：uint32\_t
 
 | 特性 | 是否支持 |

docs/manual/date_time_t.md

@@ -5,7 +5,6 @@
 > 在嵌入式平台中，在系统初始时，需要调用date\_time\_set\_impl设置实际获取系统时间的函数。
 
 
-
 ----------------------------------
 ### 函数
 <p id="date_time_t_methods">
@@ -37,7 +36,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -59,7 +57,6 @@ date_time_t* date_time_create ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -81,7 +78,6 @@ ret_t date_time_destroy (date_time_t* dt);
 
 
 
-
 * 函数原型：
 
 ```
@@ -106,7 +102,6 @@ date_time_t* date_time_init (date_time_t* dt);
 
 
 
-
 * 函数原型：
 
 ```
@@ -124,7 +119,6 @@ ret_t date_time_set_impl (date_time_get_now_t date_time_get_now);
 > <p id="date_time_t_day"> 日(1-31)。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -137,7 +131,6 @@ ret_t date_time_set_impl (date_time_get_now_t date_time_get_now);
 > <p id="date_time_t_hour"> 时(0 - 23)。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -150,7 +143,6 @@ ret_t date_time_set_impl (date_time_get_now_t date_time_get_now);
 > <p id="date_time_t_minute"> 分(0 - 59)。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -163,7 +155,6 @@ ret_t date_time_set_impl (date_time_get_now_t date_time_get_now);
 > <p id="date_time_t_month"> 月(1-12)。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -176,7 +167,6 @@ ret_t date_time_set_impl (date_time_get_now_t date_time_get_now);
 > <p id="date_time_t_second"> 秒(0 - 59)。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -189,7 +179,6 @@ ret_t date_time_set_impl (date_time_get_now_t date_time_get_now);
 > <p id="date_time_t_wday"> 星期几(0-6, Sunday = 0)。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -202,7 +191,6 @@ ret_t date_time_set_impl (date_time_get_now_t date_time_get_now);
 > <p id="date_time_t_year"> 年。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |

docs/manual/dialog_highlighter_default_t.md

@@ -6,7 +6,6 @@
 >对于性能不高的平台，建议将start\_alpha和end\_alpha设为相同。
 
 
-
 ----------------------------------
 ### 函数
 <p id="dialog_highlighter_default_t_methods">
@@ -30,7 +29,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -48,7 +46,6 @@ dialog_highlighter_t* dialog_highlighter_default_create (object_t* args);
 > <p id="dialog_highlighter_default_t_end_alpha"> 结束alpha，打开对话框的动画结束(直到对话框被关闭)时的alpha值。
 
 
-
 * 类型：uint8\_t
 
 #### start\_alpha 属性
@@ -56,6 +53,5 @@ dialog_highlighter_t* dialog_highlighter_default_create (object_t* args);
 > <p id="dialog_highlighter_default_t_start_alpha"> 起始alpha，打开对话框的动画开始时的alpha值。
 
 
-
 * 类型：uint8\_t
 

docs/manual/dialog_highlighter_factory_t.md

@@ -3,7 +3,6 @@
  对话框高亮策略工厂。
 
 
-
 ----------------------------------
 ### 函数
 <p id="dialog_highlighter_factory_t_methods">
@@ -24,7 +23,6 @@
 > <p id="dialog_highlighter_factory_t_dialog_highlighter_factory"> 获取缺省的对话框高亮策略工厂对象。
 
 
-
 * 函数原型：
 
 ```
@@ -45,7 +43,6 @@ dialog_highlighter_factory_t* dialog_highlighter_factory ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -66,7 +63,6 @@ dialog_highlighter_factory_t* dialog_highlighter_factory_create ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -90,7 +86,6 @@ dialog_highlighter_t* dialog_highlighter_factory_create_highlighter (dialog_high
 
 
 
-
 * 函数原型：
 
 ```
@@ -112,7 +107,6 @@ ret_t dialog_highlighter_factory_destroy (dialog_highlighter_factory_t* factory)
 
 
 
-
 * 函数原型：
 
 ```
@@ -136,7 +130,6 @@ ret_t dialog_highlighter_factory_register (dialog_highlighter_factory_t* factory
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/dialog_highlighter_t.md

@@ -5,7 +5,6 @@
 > 高亮策略的基本思路是对背景进行处理，比如将背景变暗或变模糊。
 
 
-
 ----------------------------------
 ### 函数
 <p id="dialog_highlighter_t_methods">
@@ -37,7 +36,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -59,7 +57,6 @@ dialog_highlighter_t* dialog_highlighter_create (const dialog_highlighter_vtable
 
 
 
-
 * 函数原型：
 
 ```
@@ -81,7 +78,6 @@ ret_t dialog_highlighter_destroy (dialog_highlighter_t* h);
 
 
 
-
 * 函数原型：
 
 ```
@@ -104,7 +100,6 @@ ret_t dialog_highlighter_draw (dialog_highlighter_t* h, float_t percent);
 
 
 
-
 * 函数原型：
 
 ```
@@ -126,7 +121,6 @@ bool_t dialog_highlighter_is_dynamic (dialog_highlighter_t* h);
 
 
 
-
 * 函数原型：
 
 ```
@@ -149,7 +143,6 @@ ret_t dialog_highlighter_prepare (dialog_highlighter_t* h, canvas_t* c);
 
 
 
-
 * 函数原型：
 
 ```
@@ -169,7 +162,6 @@ ret_t dialog_highlighter_set_bg (dialog_highlighter_t* h, bitmap_t* img, framebu
 > <p id="dialog_highlighter_t_canvas"> 画布。
 
 
-
 * 类型：canvas\_t*
 
 #### dialog 属性
@@ -177,7 +169,6 @@ ret_t dialog_highlighter_set_bg (dialog_highlighter_t* h, bitmap_t* img, framebu
 > <p id="dialog_highlighter_t_dialog"> 对应的对话框。
 
 
-
 * 类型：widget\_t*
 
 #### img 属性
@@ -185,6 +176,5 @@ ret_t dialog_highlighter_set_bg (dialog_highlighter_t* h, bitmap_t* img, framebu
 > <p id="dialog_highlighter_t_img"> 底层窗口的截图。
 
 
-
 * 类型：bitmap\_t
 

docs/manual/dialog_highlighter_type_t.md

@@ -2,7 +2,6 @@
 ### 概述
  @type string
  内置的对话框高亮策略。
-
 ### 常量
 <p id="dialog_highlighter_type_t_consts">
 

docs/manual/edit_t.md

@@ -76,6 +76,7 @@ default](https://github.com/zlgopen/awtk/blob/master/demos/assets/raw/styles/def
 | <a href="#edit_t_edit_set_input_type">edit\_set\_input\_type</a> | 设置编辑器的输入类型。 |
 | <a href="#edit_t_edit_set_int">edit\_set\_int</a> | 设置int类型的值。 |
 | <a href="#edit_t_edit_set_int_limit">edit\_set\_int\_limit</a> | 设置为整数输入及取值范围。 |
+| <a href="#edit_t_edit_set_is_valid_char">edit\_set\_is\_valid\_char</a> | 设置输入字符检查函数。 |
 | <a href="#edit_t_edit_set_password_visible">edit\_set\_password\_visible</a> | 当编辑器输入类型为密码时，设置密码是否可见。 |
 | <a href="#edit_t_edit_set_readonly">edit\_set\_readonly</a> | 设置编辑器是否为只读。 |
 | <a href="#edit_t_edit_set_text_limit">edit\_set\_text\_limit</a> | 设置为文本输入及其长度限制，不允许输入超过max个字符，少于min个字符时进入error状态。 |
@@ -281,7 +282,7 @@ ret_t edit_set_focus (widget_t* widget, bool_t focus);
 | -------- | ----- | --------- |
 | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
 | widget | widget\_t* | widget对象。 |
-| focus | bool\_t | 是否为焦点。。 |
+| focus | bool\_t | 是否为焦点。 |
 #### edit\_set\_input\_tips 函数
 -----------------------
 
@@ -372,6 +373,30 @@ ret_t edit_set_int_limit (widget_t* widget, int32_t min, int32_t max, int32_t st
 | min | int32\_t | 最小值。 |
 | max | int32\_t | 最大值。 |
 | step | int32\_t | 步长。 |
+#### edit\_set\_is\_valid\_char 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="edit_t_edit_set_is_valid_char"> 设置输入字符检查函数。
+> 如果内置检查函数不能满足需求时，可以设置自定义的检查函数。
+
+
+
+
+* 函数原型：
+
+```
+ret_t edit_set_is_valid_char (widget_t* widget, edit_is_valid_char_t is_valid_char);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | widget对象。 |
+| is\_valid\_char | edit\_is\_valid\_char\_t | 检查输入字符是否有效的回调函数。 |
 #### edit\_set\_password\_visible 函数
 -----------------------
 

docs/manual/emitter_t.md

@@ -3,7 +3,6 @@
 
  事件分发器, 用于实现观察者模式。
 
-
 ----------------------------------
 ### 函数
 <p id="emitter_t_methods">
@@ -43,7 +42,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -65,7 +63,6 @@ emitter_t* emitter_cast (emitter_t* emitter);
 
 
 
-
 * 函数原型：
 
 ```
@@ -87,7 +84,6 @@ emitter_t* emitter_create ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -110,7 +106,6 @@ ret_t emitter_deinit (emitter_t* emitter);
 
 
 
-
 * 函数原型：
 
 ```
@@ -135,7 +130,6 @@ ret_t emitter_destroy (emitter_t* emitter);
 
 
 
-
 * 函数原型：
 
 ```
@@ -158,7 +152,6 @@ ret_t emitter_disable (emitter_t* emitter);
   如果当前分发的回调函数返回RET_STOP，dispatch中断分发，并返回RET_STOP，否则返回RET_OK。
 
 
-
 * 函数原型：
 
 ```
@@ -182,7 +175,6 @@ ret_t emitter_dispatch (emitter_t* emitter, event_t* e);
   如果当前分发的回调函数返回RET_STOP，dispatch中断分发，并返回RET_STOP，否则返回RET_OK。
 
 
-
 * 函数原型：
 
 ```
@@ -205,7 +197,6 @@ ret_t emitter_dispatch_simple_event (emitter_t* emitter, uint32_t type);
 
 
 
-
 * 函数原型：
 
 ```
@@ -227,7 +218,6 @@ ret_t emitter_enable (emitter_t* emitter);
 
 
 
-
 * 函数原型：
 
 ```
@@ -250,7 +240,6 @@ ret_t emitter_find (emitter_t* emitter, uint32_t id);
 
 
 
-
 * 函数原型：
 
 ```
@@ -272,7 +261,6 @@ emitter_t* emitter_init (emitter_t* emitter);
 
 
 
-
 * 函数原型：
 
 ```
@@ -295,7 +283,6 @@ ret_t emitter_off (emitter_t* emitter, uint32_t id);
 
 
 
-
 * 函数原型：
 
 ```
@@ -318,7 +305,6 @@ ret_t emitter_off_by_ctx (emitter_t* emitter, void* ctx);
 
 
 
-
 * 函数原型：
 
 ```
@@ -343,7 +329,6 @@ ret_t emitter_off_by_func (emitter_t* emitter, uint32_t type, event_func_t on_ev
 
 
 
-
 * 函数原型：
 
 ```
@@ -368,7 +353,6 @@ uint32_t emitter_on (emitter_t* emitter, uint32_t type, event_func_t on_event, v
 
 
 
-
 * 函数原型：
 
 ```
@@ -393,7 +377,6 @@ ret_t emitter_set_on_destroy (emitter_t* emitter, uint32_t id, tk_destroy_t on_d
 
 
 
-
 * 函数原型：
 
 ```
@@ -411,7 +394,6 @@ uint32_t emitter_size (emitter_t* emitter);
 > <p id="emitter_t_enable"> 禁用标志。禁用时dispatch无效。
 
 
-
 * 类型：bool\_t
 
 | 特性 | 是否支持 |

docs/manual/event_base_type_t.md

@@ -1,7 +1,6 @@
 ## event\_base\_type\_t
 ### 概述
  类型常量定义。
-
 ### 常量
 <p id="event_base_type_t_consts">
 

docs/manual/event_t.md

@@ -2,7 +2,6 @@
 ### 概述
  事件基类。
 
-
 ----------------------------------
 ### 函数
 <p id="event_t_methods">
@@ -32,7 +31,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -56,7 +54,6 @@ event_t* event_cast (event_t* event);
 
 
 
-
 * 函数原型：
 
 ```
@@ -81,7 +78,6 @@ event_t* event_create (uint32_t type, void* target);
 
 
 
-
 * 函数原型：
 
 ```
@@ -103,7 +99,6 @@ ret_t event_destroy (event_t* event);
 
 
 
-
 * 函数原型：
 
 ```
@@ -122,7 +117,6 @@ event_t event_init (uint32_t type, void* target);
 > <p id="event_t_target"> 事件发生的目标对象。
 
 
-
 * 类型：void*
 
 | 特性 | 是否支持 |
@@ -135,7 +129,6 @@ event_t event_init (uint32_t type, void* target);
 > <p id="event_t_time"> 事件发生的时间。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -148,7 +141,6 @@ event_t event_init (uint32_t type, void* target);
 > <p id="event_t_type"> 类型。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |

docs/manual/event_type_t.md

@@ -1,7 +1,6 @@
 ## event\_type\_t
 ### 概述
  类型常量定义。
-
 ### 常量
 <p id="event_type_t_consts">
 

docs/manual/font_loader_bitmap_t.md

@@ -11,7 +11,6 @@
 
 
 
-
 ----------------------------------
 ### 函数
 <p id="font_loader_bitmap_t_methods">
@@ -29,7 +28,6 @@
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/font_loader_stb_t.md

@@ -8,7 +8,6 @@
 
 
 
-
 ----------------------------------
 ### 函数
 <p id="font_loader_stb_t_methods">
@@ -26,7 +25,6 @@
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/font_loader_t.md

@@ -2,7 +2,6 @@
 ### 概述
  字体加载接口。
 
-
 ----------------------------------
 ### 函数
 <p id="font_loader_t_methods">
@@ -20,7 +19,6 @@
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/font_manager_t.md

@@ -3,7 +3,6 @@
  字体管理器，负责字体的加载和缓存管理。
  (如果使用nanovg，字体由nanovg内部管理)
 
-
 ----------------------------------
 ### 函数
 <p id="font_manager_t_methods">
@@ -33,7 +32,6 @@
 > <p id="font_manager_t_font_manager"> 获取缺省的字体管理器。
 
 
-
 * 函数原型：
 
 ```
@@ -54,7 +52,6 @@ font_manager_t* font_manager ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -78,7 +75,6 @@ ret_t font_manager_add_font (font_manager_t* fm, char* name, font_t* font);
 
 
 
-
 * 函数原型：
 
 ```
@@ -100,7 +96,6 @@ font_manager_t* font_manager_create (font_loader_t* loader);
 
 
 
-
 * 函数原型：
 
 ```
@@ -122,7 +117,6 @@ ret_t font_manager_deinit (font_manager_t* fm);
 
 
 
-
 * 函数原型：
 
 ```
@@ -144,7 +138,6 @@ ret_t font_manager_destroy (font_manager_t* fm);
 
 
 
-
 * 函数原型：
 
 ```
@@ -168,7 +161,6 @@ font_t* font_manager_get_font (font_manager_t* fm, char* name, font_size_t size)
 
 
 
-
 * 函数原型：
 
 ```
@@ -191,7 +183,6 @@ font_manager_t* font_manager_init (font_manager_t* fm, font_loader_t* loader);
 
 
 
-
 * 函数原型：
 
 ```
@@ -221,7 +212,6 @@ ret_t font_manager_set (font_manager_t* fm);
 
 
 
-
 * 函数原型：
 
 ```
@@ -244,7 +234,6 @@ ret_t font_manager_set_assets_manager (font_manager_t* imm, assets_manager_t* as
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/font_t.md

@@ -3,7 +3,6 @@
  代表一种字体。
 
 
-
 ----------------------------------
 ### 函数
 <p id="font_t_methods">
@@ -23,7 +22,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -45,7 +43,6 @@ ret_t font_destroy (font_t* font);
 
 
 
-
 * 函数原型：
 
 ```
@@ -69,7 +66,6 @@ int32_t font_get_baseline (font_t* font, font_size_t font_size);
 
 
 
-
 * 函数原型：
 
 ```
@@ -95,7 +91,6 @@ ret_t font_get_glyph (font_t* font, wchar_t chr, font_size_t font_size, glyph_t*
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/func_call_parser_t.md

@@ -11,7 +11,6 @@
  如:move(x=10, y=20)
  如:rename(old_name=aa, new_name=bb)
 
-
 ----------------------------------
 ### 函数
 <p id="func_call_parser_t_methods">
@@ -31,7 +30,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -53,7 +51,6 @@ ret_t func_call_parser_deinit (func_call_parser_t* parser);
 
 
 
-
 * 函数原型：
 
 ```
@@ -77,7 +74,6 @@ func_call_parser_t* func_call_parser_init (func_call_parser_t* parser, const cha
 
 
 
-
 * 函数原型：
 
 ```
@@ -101,7 +97,6 @@ ret_t func_call_parser_parse (func_call_parser_t* parser);
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/global_t.md

@@ -2,17 +2,59 @@
 ### 概述
  TK全局对象。
 
-
 ----------------------------------
 ### 函数
 <p id="global_t_methods">
 
 | 函数名称 | 说明 | 
 | -------- | ------------ | 
+| <a href="#global_t_tk_get_pointer_x">tk\_get\_pointer\_x</a> | 获取全局指针的X坐标。 |
+| <a href="#global_t_tk_get_pointer_y">tk\_get\_pointer\_y</a> | 获取全局指针的Y坐标。 |
 | <a href="#global_t_tk_init">tk\_init</a> | 初始化TK。 |
+| <a href="#global_t_tk_is_pointer_pressed">tk\_is\_pointer\_pressed</a> | 获取全局指针是否按下。 |
 | <a href="#global_t_tk_quit">tk\_quit</a> | 退出TK事件主循环。 |
 | <a href="#global_t_tk_run">tk\_run</a> | 进入TK事件主循环。 |
 | <a href="#global_t_tk_set_lcd_orientation">tk\_set\_lcd\_orientation</a> | 设置屏幕的旋转方向(XXX:目前仅支持0度和90度)。 |
+#### tk\_get\_pointer\_x 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="global_t_tk_get_pointer_x"> 获取全局指针的X坐标。
+
+
+
+* 函数原型：
+
+```
+int32_t tk_get_pointer_x ();
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | int32\_t | 返回全局指针的X坐标。 |
+#### tk\_get\_pointer\_y 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="global_t_tk_get_pointer_y"> 获取全局指针的Y坐标。
+
+
+
+* 函数原型：
+
+```
+int32_t tk_get_pointer_y ();
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | int32\_t | 返回全局指针的X坐标。 |
 #### tk\_init 函数
 -----------------------
 
@@ -22,7 +64,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -39,6 +80,26 @@ ret_t tk_init (wh_t w, wh_t h, app_type_t app_type, const char* app_name, const
 | app\_type | app\_type\_t | 应用程序的类型。 |
 | app\_name | const char* | 应用程序的名称(必须为常量字符串)。 |
 | app\_root | const char* | 应用程序的根目录，用于定位资源文件(必须为常量字符串)。 |
+#### tk\_is\_pointer\_pressed 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="global_t_tk_is_pointer_pressed"> 获取全局指针是否按下。
+
+
+
+* 函数原型：
+
+```
+bool_t tk_is_pointer_pressed ();
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | bool\_t | 返回全局指针是否按下。 |
 #### tk\_quit 函数
 -----------------------
 
@@ -48,7 +109,6 @@ ret_t tk_init (wh_t w, wh_t h, app_type_t app_type, const char* app_name, const
 
 
 
-
 * 函数原型：
 
 ```
@@ -69,7 +129,6 @@ ret_t tk_quit ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -90,7 +149,6 @@ ret_t tk_run ();
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/glyph_t.md

@@ -3,7 +3,6 @@
  代表一个字符的字模。
 
 
-
 ----------------------------------
 ### 函数
 <p id="glyph_t_methods">
@@ -33,7 +32,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -54,7 +52,6 @@ glyph_t* glyph_clone ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -75,7 +72,6 @@ glyph_t* glyph_create ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -93,7 +89,6 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_advance"> 占位宽度。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -105,7 +100,6 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_data"> 数据。
 
 
-
 * 类型：const uint8\_t*
 
 | 特性 | 是否支持 |
@@ -117,7 +111,6 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_h"> 高度。
 
 
-
 * 类型：uint8\_t
 
 | 特性 | 是否支持 |
@@ -129,7 +122,6 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_w"> 宽度。
 
 
-
 * 类型：uint8\_t
 
 | 特性 | 是否支持 |
@@ -141,7 +133,6 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_x"> x坐标。
 
 
-
 * 类型：int8\_t
 
 | 特性 | 是否支持 |
@@ -153,7 +144,6 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_y"> y坐标。
 
 
-
 * 类型：int8\_t
 
 | 特性 | 是否支持 |

docs/manual/guage_pointer_t.md

@@ -30,7 +30,6 @@
 
 
 
-
 ----------------------------------
 ### 函数
 <p id="guage_pointer_t_methods">
@@ -60,7 +59,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -82,7 +80,6 @@ widget_t* guage_pointer_cast (widget_t* widget);
 
 
 
-
 * 函数原型：
 
 ```
@@ -108,7 +105,6 @@ widget_t* guage_pointer_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h
 
 
 
-
 * 函数原型：
 
 ```
@@ -132,7 +128,6 @@ ret_t guage_pointer_set_anchor (widget_t* widget, const char* anchor_x, const ch
 
 
 
-
 * 函数原型：
 
 ```
@@ -155,7 +150,6 @@ ret_t guage_pointer_set_angle (widget_t* widget, int32_t angle);
 
 
 
-
 * 函数原型：
 
 ```
@@ -174,7 +168,6 @@ ret_t guage_pointer_set_image (widget_t* widget, const char* image);
 > <p id="guage_pointer_t_anchor_x"> 旋转锚点x坐标。
 
 
-
 * 类型：float\_t
 
 | 特性 | 是否支持 |
@@ -192,7 +185,6 @@ ret_t guage_pointer_set_image (widget_t* widget, const char* image);
 > <p id="guage_pointer_t_anchor_y"> 旋转锚点y坐标。
 
 
-
 * 类型：float\_t
 
 | 特性 | 是否支持 |
@@ -210,7 +202,6 @@ ret_t guage_pointer_set_image (widget_t* widget, const char* image);
 > <p id="guage_pointer_t_angle"> 指针角度。12点钟方向为0度，顺时钟方向为正，单位为度。
 
 
-
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -231,7 +222,6 @@ ret_t guage_pointer_set_image (widget_t* widget, const char* image);
 
 
 
-
 * 类型：char*
 
 | 特性 | 是否支持 |

docs/manual/hscroll_label_t.md

@@ -0,0 +1,439 @@
+## hscroll\_label\_t
+### 概述
+![image](images/hscroll_label_t_0.png)
+
+
+ 可水平滚动的文本控件，方便实现长文本滚动。
+
+
+ hscroll\_label\_t是[widget\_t](widget_t.md)的子类控件，widget\_t的函数均适用于hscroll\_label\_t控件。
+
+ 在xml中使用"hscroll\_label"标签创建行号控件，一般配合mledit使用。如：
+
+ ```xml
+ ```
+
+ > 更多用法请参考：[mledit.xml](
+https://github.com/zlgopen/awtk/blob/master/demos/assets/raw/ui/mledit.xml)
+
+ 可用通过style来设置控件的显示风格，如字体的大小和颜色等等。如：
+
+ ```xml
+  <style name="default" text_color="black">
+    <normal   />
+    <focused  />
+  </style>
+ ```
+
+ > 更多用法请参考：
+ [theme default](
+https://github.com/zlgopen/awtk/blob/master/demos/assets/raw/styles/default.xml)
+
+
+----------------------------------
+### 函数
+<p id="hscroll_label_t_methods">
+
+| 函数名称 | 说明 | 
+| -------- | ------------ | 
+| <a href="#hscroll_label_t_hscroll_label_cast">hscroll\_label\_cast</a> | 转换为hscroll_label对象(供脚本语言使用)。 |
+| <a href="#hscroll_label_t_hscroll_label_create">hscroll\_label\_create</a> | 创建hscroll_label对象 |
+| <a href="#hscroll_label_t_hscroll_label_set_duration">hscroll\_label\_set\_duration</a> | 设置duration。 |
+| <a href="#hscroll_label_t_hscroll_label_set_ellipses">hscroll\_label\_set\_ellipses</a> | 设置ellipses。 |
+| <a href="#hscroll_label_t_hscroll_label_set_loop">hscroll\_label\_set\_loop</a> | 设置loop。 |
+| <a href="#hscroll_label_t_hscroll_label_set_lull">hscroll\_label\_set\_lull</a> | 设置lull。 |
+| <a href="#hscroll_label_t_hscroll_label_set_only_focus">hscroll\_label\_set\_only\_focus</a> | 设置only_focus。 |
+| <a href="#hscroll_label_t_hscroll_label_set_xoffset">hscroll\_label\_set\_xoffset</a> | 设置x偏移(一般无需用户调用)。。 |
+| <a href="#hscroll_label_t_hscroll_label_set_yoyo">hscroll\_label\_set\_yoyo</a> | 设置yoyo。 |
+| <a href="#hscroll_label_t_hscroll_label_start">hscroll\_label\_start</a> | 启动(一般无需用户调用)。 |
+| <a href="#hscroll_label_t_hscroll_label_stop">hscroll\_label\_stop</a> | 停止(一般无需用户调用)。 |
+### 属性
+<p id="hscroll_label_t_properties">
+
+| 属性名称 | 类型 | 说明 | 
+| -------- | ----- | ------------ | 
+| <a href="#hscroll_label_t_duration">duration</a> | int32\_t | 完整的滚动一次需要的时间(ms)，缺省5000ms。 |
+| <a href="#hscroll_label_t_ellipses">ellipses</a> | bool\_t |  |
+| <a href="#hscroll_label_t_loop">loop</a> | bool\_t |  |
+| <a href="#hscroll_label_t_lull">lull</a> | int32\_t |  |
+| <a href="#hscroll_label_t_only_focus">only\_focus</a> | bool\_t |  |
+| <a href="#hscroll_label_t_text_w">text\_w</a> | int32\_t | 文本的宽度。 |
+| <a href="#hscroll_label_t_xoffset">xoffset</a> | int32\_t | 偏移量。 |
+| <a href="#hscroll_label_t_yoyo">yoyo</a> | bool\_t |  |
+#### hscroll\_label\_cast 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_cast"> 转换为hscroll_label对象(供脚本语言使用)。
+
+
+
+* 函数原型：
+
+```
+widget_t* hscroll_label_cast (widget_t* widget);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | widget\_t* | hscroll\_label对象。 |
+| widget | widget\_t* | hscroll\_label对象。 |
+#### hscroll\_label\_create 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_create"> 创建hscroll_label对象
+
+
+
+* 函数原型：
+
+```
+widget_t* hscroll_label_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | widget\_t* | 对象。 |
+| parent | widget\_t* | 父控件 |
+| x | xy\_t | x坐标 |
+| y | xy\_t | y坐标 |
+| w | wh\_t | 宽度 |
+| h | wh\_t | 高度 |
+#### hscroll\_label\_set\_duration 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_set_duration"> 设置duration。
+
+
+
+* 函数原型：
+
+```
+ret_t hscroll_label_set_duration (widget_t* widget, int32_t duration);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | 控件对象。 |
+| duration | int32\_t | 滚动时间(ms)。 |
+#### hscroll\_label\_set\_ellipses 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_set_ellipses"> 设置ellipses。
+
+
+
+* 函数原型：
+
+```
+ret_t hscroll_label_set_ellipses (widget_t* widget, bool_t ellipses);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | 控件对象。 |
+| ellipses | bool\_t | 是否在文本超长时在行尾显示"..."。 |
+#### hscroll\_label\_set\_loop 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_set_loop"> 设置loop。
+
+
+
+* 函数原型：
+
+```
+ret_t hscroll_label_set_loop (widget_t* widget, bool_t loop);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | 控件对象。 |
+| loop | bool\_t | 是否循环滚动。 |
+#### hscroll\_label\_set\_lull 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_set_lull"> 设置lull。
+
+
+
+* 函数原型：
+
+```
+ret_t hscroll_label_set_lull (widget_t* widget, int32_t lull);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | 控件对象。 |
+| lull | int32\_t | 间歇时间(ms)。 |
+#### hscroll\_label\_set\_only\_focus 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_set_only_focus"> 设置only_focus。
+
+
+
+* 函数原型：
+
+```
+ret_t hscroll_label_set_only_focus (widget_t* widget, bool_t only_focus);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | 控件对象。 |
+| only\_focus | bool\_t | 是否只有处于focus时才滚动。 |
+#### hscroll\_label\_set\_xoffset 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_set_xoffset"> 设置x偏移(一般无需用户调用)。。
+
+
+
+* 函数原型：
+
+```
+ret_t hscroll_label_set_xoffset (widget_t* widget, int32_t xoffset);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | 控件对象。 |
+| xoffset | int32\_t | x偏移。 |
+#### hscroll\_label\_set\_yoyo 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_set_yoyo"> 设置yoyo。
+
+
+
+* 函数原型：
+
+```
+ret_t hscroll_label_set_yoyo (widget_t* widget, bool_t yoyo);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | 控件对象。 |
+| yoyo | bool\_t | 是否往返滚动。 |
+#### hscroll\_label\_start 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_start"> 启动(一般无需用户调用)。
+
+
+
+* 函数原型：
+
+```
+ret_t hscroll_label_start (widget_t* widget);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | 控件对象。 |
+#### hscroll\_label\_stop 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="hscroll_label_t_hscroll_label_stop"> 停止(一般无需用户调用)。
+
+
+
+* 函数原型：
+
+```
+ret_t hscroll_label_stop (widget_t* widget);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | 控件对象。 |
+#### duration 属性
+-----------------------
+> <p id="hscroll_label_t_duration"> 完整的滚动一次需要的时间(ms)，缺省5000ms。
+
+
+* 类型：int32\_t
+
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+| 可脚本化   | 是 |
+| 可在XML中设置 | 是 |
+| 可通过widget\_get\_prop读取 | 是 |
+| 可通过widget\_set\_prop修改 | 是 |
+#### ellipses 属性
+-----------------------
+> <p id="hscroll_label_t_ellipses">
+ 文本显示不下时，在行尾显示ellipses(缺省FALSE)。
+
+
+* 类型：bool\_t
+
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+| 可持久化   | 是 |
+| 可脚本化   | 是 |
+| 可在IDE中设置 | 是 |
+| 可在XML中设置 | 是 |
+| 可通过widget\_get\_prop读取 | 是 |
+| 可通过widget\_set\_prop修改 | 是 |
+#### loop 属性
+-----------------------
+> <p id="hscroll_label_t_loop">
+ loop是否循环滚动(缺省FALSE)。
+
+
+* 类型：bool\_t
+
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+| 可持久化   | 是 |
+| 可脚本化   | 是 |
+| 可在IDE中设置 | 是 |
+| 可在XML中设置 | 是 |
+| 可通过widget\_get\_prop读取 | 是 |
+| 可通过widget\_set\_prop修改 | 是 |
+#### lull 属性
+-----------------------
+> <p id="hscroll_label_t_lull">
+ 滚动之间的间歇时间(ms)，缺省3000ms。
+
+
+* 类型：int32\_t
+
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+| 可持久化   | 是 |
+| 可脚本化   | 是 |
+| 可在IDE中设置 | 是 |
+| 可在XML中设置 | 是 |
+| 可通过widget\_get\_prop读取 | 是 |
+| 可通过widget\_set\_prop修改 | 是 |
+#### only\_focus 属性
+-----------------------
+> <p id="hscroll_label_t_only_focus">
+ 只有处于focus时才滚动(缺省否)。
+
+
+* 类型：bool\_t
+
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+| 可持久化   | 是 |
+| 可脚本化   | 是 |
+| 可在IDE中设置 | 是 |
+| 可在XML中设置 | 是 |
+| 可通过widget\_get\_prop读取 | 是 |
+| 可通过widget\_set\_prop修改 | 是 |
+#### text\_w 属性
+-----------------------
+> <p id="hscroll_label_t_text_w"> 文本的宽度。
+
+
+* 类型：int32\_t
+
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+| 可脚本化   | 是 |
+| 可在XML中设置 | 是 |
+| 可通过widget\_get\_prop读取 | 是 |
+| 可通过widget\_set\_prop修改 | 是 |
+#### xoffset 属性
+-----------------------
+> <p id="hscroll_label_t_xoffset"> 偏移量。
+
+
+* 类型：int32\_t
+
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+| 可脚本化   | 是 |
+| 可在XML中设置 | 是 |
+| 可通过widget\_get\_prop读取 | 是 |
+| 可通过widget\_set\_prop修改 | 是 |
+#### yoyo 属性
+-----------------------
+> <p id="hscroll_label_t_yoyo">
+ 是否往返滚动(缺省FALSE)。
+
+
+* 类型：bool\_t
+
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+| 可持久化   | 是 |
+| 可脚本化   | 是 |
+| 可在IDE中设置 | 是 |
+| 可在XML中设置 | 是 |
+| 可通过widget\_get\_prop读取 | 是 |
+| 可通过widget\_set\_prop修改 | 是 |

docs/manual/hscrollable_t.md

@@ -2,5 +2,4 @@
 ### 概述
  帮助实现控件左右滚动的效果。
 
-
 ----------------------------------

docs/manual/idle_info_t.md

@@ -5,7 +5,6 @@
 
  单个idle的信息。
 
-
 ----------------------------------
 ### 函数
 <p id="idle_info_t_methods">
@@ -32,7 +31,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -50,7 +48,6 @@ idle_info_t* idle_info_cast (idle_info_t* idle);
 > <p id="idle_info_t_ctx"> idle回调函数上下文。
 
 
-
 * 类型：void*
 
 | 特性 | 是否支持 |
@@ -65,7 +62,6 @@ idle_info_t* idle_info_cast (idle_info_t* idle);
  > 为TK\_INVALID\_ID时表示无效idle。
 
 
-
 * 类型：uint32\_t
 
 | 特性 | 是否支持 |
@@ -78,7 +74,6 @@ idle_info_t* idle_info_cast (idle_info_t* idle);
 > <p id="idle_info_t_on_destroy"> idle销毁时的回调函数。
 
 
-
 * 类型：tk\_destroy\_t
 
 | 特性 | 是否支持 |
@@ -90,7 +85,6 @@ idle_info_t* idle_info_cast (idle_info_t* idle);
 > <p id="idle_info_t_on_destroy_ctx"> idle销毁时的回调函数的上下文。
 
 
-
 * 类型：tk\_destroy\_t
 
 | 特性 | 是否支持 |
@@ -102,7 +96,6 @@ idle_info_t* idle_info_cast (idle_info_t* idle);
 > <p id="idle_info_t_on_idle"> idle回调函数。
 
 
-
 * 类型：idle\_func\_t
 
 | 特性 | 是否支持 |

docs/manual/idle_t.md

@@ -24,7 +24,6 @@
  > 在非GUI线程请用idle\_queue。
 
 
-
 ----------------------------------
 ### 函数
 <p id="idle_t_methods">
@@ -45,7 +44,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -68,7 +66,6 @@ uint32_t idle_add (idle_func_t on_idle, void* ctx);
 
 
 
-
 * 函数原型：
 
 ```
@@ -89,7 +86,6 @@ uint32_t idle_count ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -112,7 +108,6 @@ ret_t idle_queue (idle_func_t on_idle, void* ctx);
 
 
 
-
 * 函数原型：
 
 ```
@@ -134,7 +129,6 @@ ret_t idle_remove (uint32_t idle_id);
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/im_action_button_info_event_t.md

@@ -4,7 +4,6 @@
 
  设置软键盘上的action按钮的信息事件。
 
-
 ----------------------------------
 ### 属性
 <p id="im_action_button_info_event_t_properties">
@@ -18,7 +17,6 @@
 > <p id="im_action_button_info_event_t_enable"> 软键盘上的action按钮启用。
 
 
-
 * 类型：bool\_t
 
 | 特性 | 是否支持 |
@@ -30,7 +28,6 @@
 > <p id="im_action_button_info_event_t_text"> 软键盘上的action按钮显示的文本。
 
 
-
 * 类型：char*
 
 | 特性 | 是否支持 |

docs/manual/im_candidates_event_t.md

@@ -4,7 +4,6 @@
 
  输入法请求显示候选字的事件。
 
-
 ----------------------------------
 ### 属性
 <p id="im_candidates_event_t_properties">
@@ -18,7 +17,6 @@
 > <p id="im_candidates_event_t_candidates"> 可选的文本，多个文本以\0分隔。如：里\0李\0力\0离\0
 
 
-
 * 类型：char*
 
 | 特性 | 是否支持 |
@@ -30,7 +28,6 @@
 > <p id="im_candidates_event_t_candidates_nr"> 可选的文本的个数。
 
 
-
 * 类型：uint32\_t
 
 | 特性 | 是否支持 |

docs/manual/im_commit_event_t.md

@@ -4,7 +4,6 @@
 
  输入法提交输入的文本事件。
 
-
 ----------------------------------
 ### 属性
 <p id="im_commit_event_t_properties">
@@ -18,7 +17,6 @@
 > <p id="im_commit_event_t_replace;"> 是否替换原来的文本。
 
 
-
 * 类型：bool\_t
 
 | 特性 | 是否支持 |
@@ -30,7 +28,6 @@
 > <p id="im_commit_event_t_text"> 提交的文本。
 
 
-
 * 类型：char*
 
 | 特性 | 是否支持 |

docs/manual/image_draw_type_t.md

@@ -1,7 +1,6 @@
 ## image\_draw\_type\_t
 ### 概述
  图片绘制方法常量定义。
-
 ### 常量
 <p id="image_draw_type_t_consts">
 

docs/manual/image_loader_stb_t.md

@@ -8,7 +8,6 @@
 
 
 
-
 ----------------------------------
 ### 函数
 <p id="image_loader_stb_t_methods">
@@ -26,7 +25,6 @@
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/image_loader_t.md

@@ -2,7 +2,6 @@
 ### 概述
  图片加载接口。
 
-
 ----------------------------------
 ### 函数
 <p id="image_loader_t_methods">
@@ -22,7 +21,6 @@
 
 
 
-
 * 函数原型：
 
 ```
@@ -47,7 +45,6 @@ ret_t image_loader_load (image_loader_t* loader, const asset_info_t* asset, bitm
 
 
 
-
 * 函数原型：
 
 ```
@@ -71,7 +68,6 @@ ret_t image_loader_load_image (const asset_info_t* asset, bitmap_t* bitmap);
 
 
 
-
 * 函数原型：
 
 ```
@@ -94,7 +90,6 @@ ret_t image_loader_register (image_loader_t* loader);
 
 
 
-
 * 函数原型：
 
 ```

docs/manual/image_manager_t.md

@@ -2,7 +2,6 @@
 ### 概述
  图片管理器。负责加载，解码和缓存图片。
 
-
 ----------------------------------
 ### 函数
 <p id="image_manager_t_methods">
@@ -33,7 +32,6 @@
 > <p id="image_manager_t_image_manager"> 获取缺省的图片管理器。
 
 
-
 * 函数原型：
 
 ```
@@ -54,7 +52,6 @@ image_manager_t* image_manager ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -75,7 +72,6 @@ image_manager_t* image_manager_create ();
 
 
 
-
 * 函数原型：
 
 ```
@@ -97,7 +93,6 @@ ret_t image_manager_deinit (image_manager_t* imm);
 
 
 
-
 * 函数原型：
 
 ```
@@ -121,7 +116,6 @@ ret_t image_manager_destroy (image_manager_t* imm);
 
 
 
-
 * 函数原型：
 
 ```
@@ -145,7 +139,6 @@ ret_t image_manager_get_bitmap (image_manager_t* imm, char* name, bitmap_t* imag
 
 
 
-
 * 函数原型：
 
 ```
@@ -167,7 +160,6 @@ image_manager_t* image_manager_init (image_manager_t* imm);
 
 
 
-
 * 函数原型：
 
 ```
@@ -198,7 +190,6 @@ ret_t image_manager_set (image_manager_t* imm);
 
 
 
-
 * 函数原型：
 
 ```
@@ -221,7 +212,6 @@ ret_t image_manager_set_assets_manager (image_manager_t* imm, assets_manager_t*
 
 
 
-
 * 函数原型：
 
 ```
@@ -244,7 +234,6 @@ ret_t image_manager_unload_bitmap (image_manager_t* imm, bitmap_t* image);
 
 
 
-
 * 函数原型：
 
 ```
@@ -267,7 +256,6 @@ ret_t image_manager_unload_unused (image_manager_t* imm, uint32_t time_delta_s);
 
 
 
-
 * 函数原型：
 
 ```