# ListView 子控件的布局器 ## 一、语法 子控件布局器统一使用 children_layout 属性指定，其语法为： ``` ListView 子控件布局器 => list_view '(' PARAM_LIST ')' PARAM_LIST => PARAM | PARAM ',' PARAM_LIST ``` > ListView 子控件布局器只适用于 ListView 下的 ScrollView 控件，除非需要指定边距和间距，否则一般无需指定该参数。 示例： ``` ``` ## 二、参数 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 属性设置： ``` ``` > 在不同平台下，命令运行方式有细微差别，请自行调整。