mirror of
https://gitee.com/zlgopen/awtk.git
synced 2024-12-09 15:37:49 +08:00
2.4 KiB
2.4 KiB
ListView 子控件的布局器
一、语法
子控件布局器统一使用 children_layout 属性指定,其语法为:
ListView 子控件布局器 => list_view '(' PARAM_LIST ')'
PARAM_LIST => PARAM | PARAM ',' PARAM_LIST
ListView 子控件布局器只适用于 ListView 下的 ScrollView 控件,除非需要指定边距和间距,否则一般无需指定该参数。
示例:
<list_view x="0" y="30" w="100%" h="-80" item_height="60">
<scroll_view name="view" x="0" y="0" w="100%" h="100%" children_layout="list_view(m=10,s=15)">
二、参数
ListView 子控件的布局器提供了下列参数:
参数 | 简写 | 说明 |
---|---|---|
item_height | i | 行高(作用与 listview 的 item_height 属性相同) |
default_item_height | d | 缺省行高(作用与 listview 的 default_item_height 属性相同) |
margin | m | 边距 |
x_margin | xm | 水平方向的边距 |
y_margin | ym | 垂直方向的边距 |
spacing | s | 子控件之间的间距 |
keep_invisible | ki | 是否给不可见的控件留位置(缺省否) |
keep_disable | kd | 是否给不用的控件留位置(缺省是) |
在代码中,可以通过 widget_set_children_layout 函数启用子控件布局器:
/**
* @method widget_set_children_layout
* 设置子控件的布局参数。
* @annotation ["scriptable"]
* @param {widget_t*} widget 控件对象。
* @param {const char*} params 布局参数。
*
* @return {ret_t} 返回 RET_OK 表示成功,否则表示失败。
*/
ret_t widget_set_children_layout(widget_t* widget, const char* params);
示例:
widget_set_children_layout(w, "list_view(m=10,s=15)");
在 XML 中,可以通过 children_layout 属性设置:
<list_view x="0" y="30" w="100%" h="-80" item_height="60">
<scroll_view name="view" x="0" y="0" w="100%" h="100%" children_layout="list_view(m=10,s=15)">
在不同平台下,命令运行方式有细微差别,请自行调整。