update docs

docs/manual/asset_data_type_t.md

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

docs/manual/asset_font_type_t.md

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

docs/manual/asset_image_type_t.md

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

docs/manual/asset_info_t.md

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

docs/manual/asset_script_type_t.md

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

docs/manual/asset_type_t.md

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

docs/manual/asset_ui_type_t.md

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

docs/manual/assets_manager_t.md

@@ -24,12 +24,14 @@
     x1   普通密度屏幕的图片。
     x2   2倍密度屏幕的图片。
     x3   3倍密度屏幕的图片。
+    xx   密度无关的图片。
   strings 需要翻译的字符串。
   styles  主题数据。
   ui      UI描述数据。
  ```
 
 
+
 ----------------------------------
 ### 函数
 <p id="assets_manager_t_methods">
@@ -61,6 +63,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -81,6 +84,7 @@ assets_manager_t* assets_manager ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -103,6 +107,7 @@ ret_t assets_manager_add (assets_manager_t* am, asset_info_t info);
 
 
 
+
 * 函数原型：
 
 ```
@@ -125,6 +130,7 @@ ret_t assets_manager_clear_cache (assets_manager_t* am, asset_type_t type);
 
 
 
+
 * 函数原型：
 
 ```
@@ -146,6 +152,7 @@ assets_manager_t* assets_manager_create (uint32_t init_nr);
 
 
 
+
 * 函数原型：
 
 ```
@@ -167,6 +174,7 @@ ret_t assets_manager_deinit (assets_manager_t* am);
 
 
 
+
 * 函数原型：
 
 ```
@@ -188,6 +196,7 @@ ret_t assets_manager_destroy (assets_manager_t* am);
 
 
 
+
 * 函数原型：
 
 ```
@@ -211,6 +220,7 @@ asset_info_t* assets_manager_find_in_cache (assets_manager_t* am, asset_type_t t
 
 
 
+
 * 函数原型：
 
 ```
@@ -233,6 +243,7 @@ assets_manager_t* assets_manager_init (assets_manager_t* am, uint32_t init_nr);
 
 
 
+
 * 函数原型：
 
 ```
@@ -256,6 +267,7 @@ asset_info_t* assets_manager_load (assets_manager_t* am, asset_type_t type, char
 
 
 
+
 * 函数原型：
 
 ```
@@ -279,6 +291,7 @@ ret_t assets_manager_preload (assets_manager_t* am, asset_type_t type, char* nam
 
 
 
+
 * 函数原型：
 
 ```
@@ -302,6 +315,7 @@ asset_info_t* assets_manager_ref (assets_manager_t* am, asset_type_t type, char*
 
 
 
+
 * 函数原型：
 
 ```
@@ -323,6 +337,7 @@ ret_t assets_manager_set (assets_manager_t* am);
 
 
 
+
 * 函数原型：
 
 ```
@@ -345,6 +360,7 @@ ret_t assets_manager_set_locale_info (assets_manager_t* am, locale_info_t* local
 
 
 
+
 * 函数原型：
 
 ```
@@ -367,6 +383,7 @@ ret_t assets_manager_set_res_root (assets_manager_t* am, const char* res_root);
 
 
 
+
 * 函数原型：
 
 ```
@@ -389,6 +406,7 @@ ret_t assets_manager_set_system_info (assets_manager_t* am, system_info_t* syste
 
 
 
+
 * 函数原型：
 
 ```

docs/manual/bitmap_flag_t.md

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

docs/manual/bitmap_format_t.md

@@ -1,6 +1,7 @@
 ## bitmap\_format\_t
 ### 概述
  位图格式常量定义。
+
 ### 常量
 <p id="bitmap_format_t_consts">
 
@@ -15,3 +16,5 @@
 | BITMAP\_FMT\_BGR565 | 一个像素占用2个字节，BGR分别占用5,6,5位, 按内存地址递增。 |
 | BITMAP\_FMT\_RGB888 | 一个像素占用3个字节，RGB占一个字节，按内存地址递增。 |
 | BITMAP\_FMT\_BGR888 | 一个像素占用3个字节，RGB占一个字节，按内存地址递增。 |
+| BITMAP\_FMT\_GRAY | 一个像素占用1个字节。 |
+| BITMAP\_FMT\_MONO | 一个像素占用1比特。 |

docs/manual/bitmap_t.md

@@ -2,6 +2,7 @@
 ### 概述
  位图。
 
+
 ----------------------------------
 ### 函数
 <p id="bitmap_t_methods">
@@ -37,6 +38,7 @@
 > <p id="bitmap_t_bitmap_create"> 创建图片对象(一般供脚本语言中使用)。
 
 
+
 * 函数原型：
 
 ```
@@ -57,6 +59,7 @@ bitmap_t* bitmap_create ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -80,6 +83,7 @@ bitmap_t* bitmap_create_ex (uint32_t w, uint32_t h, uint32_t line_length, bitmap
 > <p id="bitmap_t_bitmap_destroy"> 销毁图片。
 
 
+
 * 函数原型：
 
 ```
@@ -101,6 +105,7 @@ ret_t bitmap_destroy (bitmap_t* bitmap);
 
 
 
+
 * 函数原型：
 
 ```
@@ -122,6 +127,7 @@ uint32_t bitmap_get_bpp (bitmap_t* bitmap);
 
 
 
+
 * 函数原型：
 
 ```
@@ -143,6 +149,7 @@ ret_t bitmap_get_line_length (bitmap_t* bitmap);
 
 
 
+
 * 函数原型：
 
 ```
@@ -167,6 +174,7 @@ ret_t bitmap_get_pixel (bitmap_t* bitmap, uint32_t x, uint32_t y, rgba_t* rgba);
 
 
 
+
 * 函数原型：
 
 ```
@@ -193,6 +201,7 @@ ret_t bitmap_init (bitmap_t* bitmap, uint32_t w, uint32_t h, bitmap_format_t for
 
 
 
+
 * 函数原型：
 
 ```
@@ -219,6 +228,7 @@ ret_t bitmap_init_from_rgba (bitmap_t* bitmap, uint32_t w, uint32_t h, bitmap_fo
 
 
 
+
 * 函数原型：
 
 ```
@@ -237,6 +247,7 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_data"> 图片数据。
 
 
+
 * 类型：uint8\_t*
 
 | 特性 | 是否支持 |
@@ -248,6 +259,7 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_flags"> 标志。请参考{bitmap_flag_t}。
 
 
+
 * 类型：uint16\_t
 
 | 特性 | 是否支持 |
@@ -260,6 +272,7 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_format"> 格式。请参考{bitmap_format_t}。
 
 
+
 * 类型：uint16\_t
 
 | 特性 | 是否支持 |
@@ -272,6 +285,7 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_h"> 高度。
 
 
+
 * 类型：wh\_t
 
 | 特性 | 是否支持 |
@@ -284,6 +298,7 @@ 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
 
 | 特性 | 是否支持 |
@@ -296,6 +311,7 @@ ret_t bitmap_set_line_length (bitmap_t* bitmap, uint32_t line_length);
 > <p id="bitmap_t_name"> 名称。
 
 
+
 * 类型：const char*
 
 | 特性 | 是否支持 |
@@ -308,6 +324,7 @@ 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,6 +9,7 @@
 https://github.com/zlgopen/awtk/blob/master/docs/children_layouter_default.md)
 
 
+
 ----------------------------------
 ### 函数
 <p id="children_layouter_default_t_methods">
@@ -28,6 +29,7 @@ https://github.com/zlgopen/awtk/blob/master/docs/children_layouter_default.md)
 
 
 
+
 * 函数原型：
 
 ```
@@ -48,6 +50,7 @@ children_layouter_t* children_layouter_default_create ();
 
 
 
+
 * 函数原型：
 
 ```

docs/manual/children_layouter_factory_t.md

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

docs/manual/children_layouter_list_view_t.md

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

docs/manual/children_layouter_t.md

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

docs/manual/clip_board_data_type_t.md

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

docs/manual/clip_board_t.md

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

docs/manual/color_parser_t.md

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

docs/manual/color_t.md

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

docs/manual/combo_box_ex_t.md

@@ -0,0 +1,41 @@
+## combo\_box\_ex\_t
+### 概述
+![image](images/combo_box_ex_t_0.png)
+
+ 可滚动的combo_box控件。
+
+
+
+----------------------------------
+### 函数
+<p id="combo_box_ex_t_methods">
+
+| 函数名称 | 说明 | 
+| -------- | ------------ | 
+| <a href="#combo_box_ex_t_combo_box_ex_create">combo\_box\_ex\_create</a> | 创建combo_box_ex对象 |
+#### combo\_box\_ex\_create 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="combo_box_ex_t_combo_box_ex_create"> 创建combo_box_ex对象
+
+
+
+
+* 函数原型：
+
+```
+widget_t* combo_box_ex_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 | 高度 |

docs/manual/combo_box_t.md

@@ -89,6 +89,7 @@ default](https://github.com/zlgopen/awtk/blob/master/demos/assets/raw/styles/def
 | <a href="#combo_box_t_combo_box_get_text">combo\_box\_get\_text</a> | 获取combo_box的文本。 |
 | <a href="#combo_box_t_combo_box_get_value">combo\_box\_get\_value</a> | 获取combo_box的值。 |
 | <a href="#combo_box_t_combo_box_reset_options">combo\_box\_reset\_options</a> | 重置所有选项。 |
+| <a href="#combo_box_t_combo_box_set_custom_open_popup">combo\_box\_set\_custom\_open\_popup</a> | 设置自定义的打开弹出窗口的函数。 |
 | <a href="#combo_box_t_combo_box_set_open_window">combo\_box\_set\_open\_window</a> | 点击按钮时可以打开popup窗口，本函数可设置窗口的名称。 |
 | <a href="#combo_box_t_combo_box_set_options">combo\_box\_set\_options</a> | 设置选项。 |
 | <a href="#combo_box_t_combo_box_set_selected_index">combo\_box\_set\_selected\_index</a> | 设置第index个选项为当前选中的选项。 |
@@ -284,6 +285,28 @@ ret_t combo_box_reset_options (widget_t* widget);
 | -------- | ----- | --------- |
 | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
 | widget | widget\_t* | combo\_box对象。 |
+#### combo\_box\_set\_custom\_open\_popup 函数
+-----------------------
+
+* 函数功能：
+
+> <p id="combo_box_t_combo_box_set_custom_open_popup"> 设置自定义的打开弹出窗口的函数。
+
+
+
+* 函数原型：
+
+```
+ret_t combo_box_set_custom_open_popup (widget_t* widget, combo_box_custom_open_popup_t open_popup);
+```
+
+* 参数说明：
+
+| 参数 | 类型 | 说明 |
+| -------- | ----- | --------- |
+| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
+| widget | widget\_t* | combo\_box对象。 |
+| open\_popup | combo\_box\_custom\_open\_popup\_t | 回调函数。 |
 #### combo\_box\_set\_open\_window 函数
 -----------------------
 

docs/manual/darray_t.md

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

docs/manual/date_time_t.md

@@ -5,6 +5,7 @@
 > 在嵌入式平台中，在系统初始时，需要调用date\_time\_set\_impl设置实际获取系统时间的函数。
 
 
+
 ----------------------------------
 ### 函数
 <p id="date_time_t_methods">
@@ -36,6 +37,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -57,6 +59,7 @@ date_time_t* date_time_create ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -78,6 +81,7 @@ ret_t date_time_destroy (date_time_t* dt);
 
 
 
+
 * 函数原型：
 
 ```
@@ -102,6 +106,7 @@ date_time_t* date_time_init (date_time_t* dt);
 
 
 
+
 * 函数原型：
 
 ```
@@ -119,6 +124,7 @@ 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
 
 | 特性 | 是否支持 |
@@ -131,6 +137,7 @@ 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
 
 | 特性 | 是否支持 |
@@ -143,6 +150,7 @@ 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
 
 | 特性 | 是否支持 |
@@ -155,6 +163,7 @@ 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
 
 | 特性 | 是否支持 |
@@ -167,6 +176,7 @@ 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
 
 | 特性 | 是否支持 |
@@ -179,6 +189,7 @@ 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
 
 | 特性 | 是否支持 |
@@ -191,6 +202,7 @@ 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,6 +6,7 @@
 >对于性能不高的平台，建议将start\_alpha和end\_alpha设为相同。
 
 
+
 ----------------------------------
 ### 函数
 <p id="dialog_highlighter_default_t_methods">
@@ -29,6 +30,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -46,6 +48,7 @@ dialog_highlighter_t* dialog_highlighter_default_create (object_t* args);
 > <p id="dialog_highlighter_default_t_end_alpha"> 结束alpha，打开对话框的动画结束(直到对话框被关闭)时的alpha值。
 
 
+
 * 类型：uint8\_t
 
 #### start\_alpha 属性
@@ -53,5 +56,6 @@ 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,6 +3,7 @@
  对话框高亮策略工厂。
 
 
+
 ----------------------------------
 ### 函数
 <p id="dialog_highlighter_factory_t_methods">
@@ -23,6 +24,7 @@
 > <p id="dialog_highlighter_factory_t_dialog_highlighter_factory"> 获取缺省的对话框高亮策略工厂对象。
 
 
+
 * 函数原型：
 
 ```
@@ -43,6 +45,7 @@ dialog_highlighter_factory_t* dialog_highlighter_factory ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -63,6 +66,7 @@ dialog_highlighter_factory_t* dialog_highlighter_factory_create ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -86,6 +90,7 @@ dialog_highlighter_t* dialog_highlighter_factory_create_highlighter (dialog_high
 
 
 
+
 * 函数原型：
 
 ```
@@ -107,6 +112,7 @@ ret_t dialog_highlighter_factory_destroy (dialog_highlighter_factory_t* factory)
 
 
 
+
 * 函数原型：
 
 ```
@@ -130,6 +136,7 @@ ret_t dialog_highlighter_factory_register (dialog_highlighter_factory_t* factory
 
 
 
+
 * 函数原型：
 
 ```

docs/manual/dialog_highlighter_t.md

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

docs/manual/dialog_t.md

@@ -99,6 +99,7 @@
  (https://github.com/zlgopen/awtk/blob/master/demos/assets/raw/styles/default.xml#L324)
 
 
+
 ----------------------------------
 ### 函数
 <p id="dialog_t_methods">
@@ -135,6 +136,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -159,6 +161,7 @@ widget_t* dialog_cast (widget_t* widget);
 
 
 
+
 * 函数原型：
 
 ```
@@ -181,6 +184,7 @@ ret_t dialog_confirm (const char* title, const char* text);
 
 
 
+
 * 函数原型：
 
 ```
@@ -206,6 +210,7 @@ widget_t* dialog_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);
 
 
 
+
 * 函数原型：
 
 ```
@@ -231,6 +236,7 @@ widget_t* dialog_create_simple (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h
 
 
 
+
 * 函数原型：
 
 ```
@@ -252,6 +258,7 @@ widget_t* dialog_get_client (widget_t* widget);
 
 
 
+
 * 函数原型：
 
 ```
@@ -276,6 +283,7 @@ widget_t* dialog_get_title (widget_t* widget);
 
 
 
+
 * 函数原型：
 
 ```
@@ -299,6 +307,7 @@ ret_t dialog_info (const char* title, const char* text);
 
 
 
+
 * 函数原型：
 
 ```
@@ -321,6 +330,7 @@ bool_t dialog_is_modal (widget_t* widget);
 
 
 
+
 * 函数原型：
 
 ```
@@ -344,6 +354,7 @@ bool_t dialog_is_quited (widget_t* widget);
 
 
 
+
 * 函数原型：
 
 ```
@@ -367,6 +378,7 @@ ret_t dialog_modal (widget_t* widget);
 
 
 
+
 * 函数原型：
 
 ```
@@ -391,6 +403,7 @@ widget_t* dialog_open (const char* name);
 
 
 
+
 * 函数原型：
 
 ```
@@ -413,6 +426,7 @@ ret_t dialog_quit (widget_t* widget, uint32_t code);
 
 
 
+
 * 函数原型：
 
 ```
@@ -438,6 +452,7 @@ ret_t dialog_set_title (widget_t* widget, char* title);
 
 
 
+
 * 函数原型：
 
 ```
@@ -463,6 +478,7 @@ ret_t dialog_toast (const char* text, uint32_t duration);
 
 
 
+
 * 函数原型：
 
 ```
@@ -481,6 +497,7 @@ ret_t dialog_warn (const char* title, const char* text);
 > <p id="dialog_t_highlight"> 对话框高亮策略。
 
 
+
 * 类型：const char*
 
 | 特性 | 是否支持 |

docs/manual/edit_t.md

@@ -87,7 +87,6 @@ default](https://github.com/zlgopen/awtk/blob/master/demos/assets/raw/styles/def
 | -------- | ----- | ------------ | 
 | <a href="#edit_t_auto_fix">auto\_fix</a> | bool\_t | 输入无效时，是否自动改正。 |
 | <a href="#edit_t_bottom_margin">bottom\_margin</a> | uint8\_t | 下边距。 |
-| <a href="#edit_t_focus">focus</a> | bool\_t | 设置为焦点(通常用于在XML中缺省设置为焦点控件)。 |
 | <a href="#edit_t_input_type">input\_type</a> | input\_type\_t | 输入类型。 |
 | <a href="#edit_t_left_margin">left\_margin</a> | uint8\_t | 左边距。 |
 | <a href="#edit_t_max">max</a> | float\_t | 最大值或最大长度。 |
@@ -488,23 +487,6 @@ ret_t edit_set_text_limit (widget_t* widget, uint32_t min, uint32_t max);
 
 * 类型：uint8\_t
 
-| 特性 | 是否支持 |
-| -------- | ----- |
-| 可直接读取 | 是 |
-| 可直接修改 | 否 |
-| 可持久化   | 是 |
-| 可脚本化   | 是 |
-| 可在IDE中设置 | 是 |
-| 可在XML中设置 | 是 |
-| 可通过widget\_get\_prop读取 | 是 |
-| 可通过widget\_set\_prop修改 | 是 |
-#### focus 属性
------------------------
-> <p id="edit_t_focus"> 设置为焦点(通常用于在XML中缺省设置为焦点控件)。
-
-
-* 类型：bool\_t
-
 | 特性 | 是否支持 |
 | -------- | ----- |
 | 可直接读取 | 是 |

docs/manual/emitter_t.md

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

docs/manual/event_base_type_t.md

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

docs/manual/event_t.md

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

docs/manual/event_type_t.md

@@ -1,6 +1,7 @@
 ## event\_type\_t
 ### 概述
  类型常量定义。
+
 ### 常量
 <p id="event_type_t_consts">
 
@@ -67,5 +68,8 @@
 | EVT\_SCREEN\_SAVER | 在指定的时间内(WITH\_SCREEN\_SAVER\_TIME)，没有用户输入事件，由窗口管理器触发。 |
 | EVT\_LOW\_MEMORY | 内存不足。 |
 | EVT\_OUT\_OF\_MEMORY | 内存耗尽。 |
+| EVT\_ORIENTATION\_WILL\_CHANGED | 屏幕即将旋转。 |
+| EVT\_ORIENTATION\_CHANGED | 屏幕旋转。 |
+| EVT\_WIDGET\_CREATED | 控件创建事件。 |
 | EVT\_REQ\_START | event queue其它请求编号起始值。 |
 | EVT\_USER\_START | 用户定义事件起始值。 |

docs/manual/font_loader_bitmap_t.md

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

docs/manual/font_loader_stb_t.md

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

docs/manual/font_loader_t.md

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

docs/manual/font_manager_t.md

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

docs/manual/font_t.md

@@ -3,6 +3,7 @@
  代表一种字体。
 
 
+
 ----------------------------------
 ### 函数
 <p id="font_t_methods">
@@ -22,6 +23,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -43,6 +45,7 @@ ret_t font_destroy (font_t* font);
 
 
 
+
 * 函数原型：
 
 ```
@@ -66,6 +69,7 @@ int32_t font_get_baseline (font_t* font, font_size_t font_size);
 
 
 
+
 * 函数原型：
 
 ```
@@ -91,6 +95,7 @@ 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,6 +11,7 @@
  如:move(x=10, y=20)
  如:rename(old_name=aa, new_name=bb)
 
+
 ----------------------------------
 ### 函数
 <p id="func_call_parser_t_methods">
@@ -30,6 +31,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -51,6 +53,7 @@ ret_t func_call_parser_deinit (func_call_parser_t* parser);
 
 
 
+
 * 函数原型：
 
 ```
@@ -74,6 +77,7 @@ func_call_parser_t* func_call_parser_init (func_call_parser_t* parser, const cha
 
 
 
+
 * 函数原型：
 
 ```
@@ -97,6 +101,7 @@ ret_t func_call_parser_parse (func_call_parser_t* parser);
 
 
 
+
 * 函数原型：
 
 ```

docs/manual/global_t.md

@@ -2,6 +2,7 @@
 ### 概述
  TK全局对象。
 
+
 ----------------------------------
 ### 函数
 <p id="global_t_methods">
@@ -24,6 +25,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -44,6 +46,7 @@ int32_t tk_get_pointer_x ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -64,6 +67,7 @@ int32_t tk_get_pointer_y ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -89,6 +93,7 @@ ret_t tk_init (wh_t w, wh_t h, app_type_t app_type, const char* app_name, const
 
 
 
+
 * 函数原型：
 
 ```
@@ -109,6 +114,7 @@ bool_t tk_is_pointer_pressed ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -129,6 +135,7 @@ ret_t tk_quit ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -149,6 +156,7 @@ ret_t tk_run ();
 
 
 
+
 * 函数原型：
 
 ```

docs/manual/glyph_format_t.md

@@ -0,0 +1,12 @@
+## glyph\_format\_t
+### 概述
+ 字模格式常量定义。
+
+### 常量
+<p id="glyph_format_t_consts">
+
+| 名称 | 说明 | 
+| -------- | ------- | 
+| GLYPH\_FMT\_ALPHA | 每个像素占用1个字节(缺省)。 |
+| GLYPH\_FMT\_MONO | 每个像素占用1个比特。 |
+| GLYPH\_FMT\_RGBA | 每个像素占用4个字节。 |

docs/manual/glyph_t.md

@@ -3,6 +3,7 @@
  代表一个字符的字模。
 
 
+
 ----------------------------------
 ### 函数
 <p id="glyph_t_methods">
@@ -17,9 +18,11 @@
 
 | 属性名称 | 类型 | 说明 | 
 | -------- | ----- | ------------ | 
-| <a href="#glyph_t_advance">advance</a> | int32\_t | 占位宽度。 |
+| <a href="#glyph_t_advance">advance</a> | uint16\_t | 占位宽度。 |
 | <a href="#glyph_t_data">data</a> | const uint8\_t* | 数据。 |
+| <a href="#glyph_t_format">format</a> | uint8\_t | 格式。 |
 | <a href="#glyph_t_h">h</a> | uint8\_t | 高度。 |
+| <a href="#glyph_t_pitch">pitch</a> | uint8\_t | pitch。 |
 | <a href="#glyph_t_w">w</a> | uint8\_t | 宽度。 |
 | <a href="#glyph_t_x">x</a> | int8\_t | x坐标。 |
 | <a href="#glyph_t_y">y</a> | int8\_t | y坐标。 |
@@ -32,6 +35,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -52,6 +56,7 @@ glyph_t* glyph_clone ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -72,6 +77,7 @@ glyph_t* glyph_create ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -89,7 +95,8 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_advance"> 占位宽度。
 
 
-* 类型：int32\_t
+
+* 类型：uint16\_t
 
 | 特性 | 是否支持 |
 | -------- | ----- |
@@ -100,8 +107,21 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_data"> 数据。
 
 
+
 * 类型：const uint8\_t*
 
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+#### format 属性
+-----------------------
+> <p id="glyph_t_format"> 格式。
+
+
+
+* 类型：uint8\_t
+
 | 特性 | 是否支持 |
 | -------- | ----- |
 | 可直接读取 | 是 |
@@ -111,6 +131,19 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_h"> 高度。
 
 
+
+* 类型：uint8\_t
+
+| 特性 | 是否支持 |
+| -------- | ----- |
+| 可直接读取 | 是 |
+| 可直接修改 | 否 |
+#### pitch 属性
+-----------------------
+> <p id="glyph_t_pitch"> pitch。
+
+
+
 * 类型：uint8\_t
 
 | 特性 | 是否支持 |
@@ -122,6 +155,7 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_w"> 宽度。
 
 
+
 * 类型：uint8\_t
 
 | 特性 | 是否支持 |
@@ -133,6 +167,7 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_x"> x坐标。
 
 
+
 * 类型：int8\_t
 
 | 特性 | 是否支持 |
@@ -144,6 +179,7 @@ ret_t glyph_destroy (glyph_t* glyph);
 > <p id="glyph_t_y"> y坐标。
 
 
+
 * 类型：int8\_t
 
 | 特性 | 是否支持 |

docs/manual/guage_pointer_t.md

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

docs/manual/hscroll_label_t.md

@@ -30,6 +30,7 @@ https://github.com/zlgopen/awtk/blob/master/demos/assets/raw/ui/mledit.xml)
 https://github.com/zlgopen/awtk/blob/master/demos/assets/raw/styles/default.xml)
 
 
+
 ----------------------------------
 ### 函数
 <p id="hscroll_label_t_methods">
@@ -69,6 +70,7 @@ https://github.com/zlgopen/awtk/blob/master/demos/assets/raw/styles/default.xml)
 
 
 
+
 * 函数原型：
 
 ```
@@ -90,6 +92,7 @@ widget_t* hscroll_label_cast (widget_t* widget);
 
 
 
+
 * 函数原型：
 
 ```
@@ -115,6 +118,7 @@ widget_t* hscroll_label_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h
 
 
 
+
 * 函数原型：
 
 ```
@@ -137,6 +141,7 @@ ret_t hscroll_label_set_duration (widget_t* widget, int32_t duration);
 
 
 
+
 * 函数原型：
 
 ```
@@ -159,6 +164,7 @@ ret_t hscroll_label_set_ellipses (widget_t* widget, bool_t ellipses);
 
 
 
+
 * 函数原型：
 
 ```
@@ -181,6 +187,7 @@ ret_t hscroll_label_set_loop (widget_t* widget, bool_t loop);
 
 
 
+
 * 函数原型：
 
 ```
@@ -203,6 +210,7 @@ ret_t hscroll_label_set_lull (widget_t* widget, int32_t lull);
 
 
 
+
 * 函数原型：
 
 ```
@@ -225,6 +233,7 @@ ret_t hscroll_label_set_only_focus (widget_t* widget, bool_t only_focus);
 
 
 
+
 * 函数原型：
 
 ```
@@ -247,6 +256,7 @@ ret_t hscroll_label_set_xoffset (widget_t* widget, int32_t xoffset);
 
 
 
+
 * 函数原型：
 
 ```
@@ -269,6 +279,7 @@ ret_t hscroll_label_set_yoyo (widget_t* widget, bool_t yoyo);
 
 
 
+
 * 函数原型：
 
 ```
@@ -290,6 +301,7 @@ ret_t hscroll_label_start (widget_t* widget);
 
 
 
+
 * 函数原型：
 
 ```
@@ -307,6 +319,7 @@ ret_t hscroll_label_stop (widget_t* widget);
 > <p id="hscroll_label_t_duration"> 完整的滚动一次需要的时间(ms)，缺省5000ms。
 
 
+
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -323,6 +336,7 @@ ret_t hscroll_label_stop (widget_t* widget);
  文本显示不下时，在行尾显示ellipses(缺省FALSE)。
 
 
+
 * 类型：bool\_t
 
 | 特性 | 是否支持 |
@@ -341,6 +355,7 @@ ret_t hscroll_label_stop (widget_t* widget);
  loop是否循环滚动(缺省FALSE)。
 
 
+
 * 类型：bool\_t
 
 | 特性 | 是否支持 |
@@ -359,6 +374,7 @@ ret_t hscroll_label_stop (widget_t* widget);
  滚动之间的间歇时间(ms)，缺省3000ms。
 
 
+
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -377,6 +393,7 @@ ret_t hscroll_label_stop (widget_t* widget);
  只有处于focus时才滚动(缺省否)。
 
 
+
 * 类型：bool\_t
 
 | 特性 | 是否支持 |
@@ -394,6 +411,7 @@ ret_t hscroll_label_stop (widget_t* widget);
 > <p id="hscroll_label_t_text_w"> 文本的宽度。
 
 
+
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -409,6 +427,7 @@ ret_t hscroll_label_stop (widget_t* widget);
 > <p id="hscroll_label_t_xoffset"> 偏移量。
 
 
+
 * 类型：int32\_t
 
 | 特性 | 是否支持 |
@@ -425,6 +444,7 @@ ret_t hscroll_label_stop (widget_t* widget);
  是否往返滚动(缺省FALSE)。
 
 
+
 * 类型：bool\_t
 
 | 特性 | 是否支持 |

docs/manual/hscrollable_t.md

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

docs/manual/idle_info_t.md

@@ -5,6 +5,7 @@
 
  单个idle的信息。
 
+
 ----------------------------------
 ### 函数
 <p id="idle_info_t_methods">
@@ -31,6 +32,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -48,6 +50,7 @@ idle_info_t* idle_info_cast (idle_info_t* idle);
 > <p id="idle_info_t_ctx"> idle回调函数上下文。
 
 
+
 * 类型：void*
 
 | 特性 | 是否支持 |
@@ -62,6 +65,7 @@ idle_info_t* idle_info_cast (idle_info_t* idle);
  > 为TK\_INVALID\_ID时表示无效idle。
 
 
+
 * 类型：uint32\_t
 
 | 特性 | 是否支持 |
@@ -74,6 +78,7 @@ idle_info_t* idle_info_cast (idle_info_t* idle);
 > <p id="idle_info_t_on_destroy"> idle销毁时的回调函数。
 
 
+
 * 类型：tk\_destroy\_t
 
 | 特性 | 是否支持 |
@@ -85,6 +90,7 @@ idle_info_t* idle_info_cast (idle_info_t* idle);
 > <p id="idle_info_t_on_destroy_ctx"> idle销毁时的回调函数的上下文。
 
 
+
 * 类型：tk\_destroy\_t
 
 | 特性 | 是否支持 |
@@ -96,6 +102,7 @@ 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,6 +24,7 @@
  > 在非GUI线程请用idle\_queue。
 
 
+
 ----------------------------------
 ### 函数
 <p id="idle_t_methods">
@@ -44,6 +45,7 @@
 
 
 
+
 * 函数原型：
 
 ```
@@ -66,6 +68,7 @@ uint32_t idle_add (idle_func_t on_idle, void* ctx);
 
 
 
+
 * 函数原型：
 
 ```
@@ -86,6 +89,7 @@ uint32_t idle_count ();
 
 
 
+
 * 函数原型：
 
 ```
@@ -108,6 +112,7 @@ ret_t idle_queue (idle_func_t on_idle, void* ctx);
 
 
 
+
 * 函数原型：
 
 ```
@@ -129,6 +134,7 @@ ret_t idle_remove (uint32_t idle_id);
 
 
 
+
 * 函数原型：
 
 ```

docs/manual/im_action_button_info_event_t.md

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

docs/manual/im_candidates_event_t.md

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

docs/manual/im_commit_event_t.md

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

docs/manual/image_draw_type_t.md

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

docs/manual/image_loader_stb_t.md

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

docs/manual/image_loader_t.md

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

docs/manual/image_manager_t.md

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