list_view_h_t

概述

水平列表视图控件。

list_view_h_t是widget_t的子类控件，widget_t的函数均适用于list_view_h_t控件。

在xml中使用”list_view_h”标签创建水平列表视图控件。如：

 <list_view_h x="center"  y="10" w="90%" h="100" item_width="200" spacing="5">
   <scroll_view name="view" w="100%" h="100%">
     <image style="border" draw_type="auto" image="1" text="1"/>
     ...
   </scroll_view>
 </list_view_h>

注意：列表项不是作为列表视图控件的直接子控件，而是作为滚动视图的子控件。

更多用法请参考：list_view_h.xml

在c代码中使用函数list_view_h_create创建水平列表视图控件。如：

  widget_t* list_view = list_view_h_create(win, 0, 0, 0, 0);

用代码构造列表视图是比较繁琐的事情，最好用XML来构造。
如果需要动态修改，可以使用widget_clone来增加列表项，使用widget_remove_child来移出列表项。

可用通过style来设置控件的显示风格，如背景颜色和边框颜色等(一般情况不需要)。

函数

属性

list_view_h_cast 函数

• 函数功能：

转换为list_view_h对象(供脚本语言使用)。

• 函数原型：

widget_t* list_view_h_cast (widget_t* widget);

• 参数说明：

list_view_h_create 函数

• 函数功能：

创建list_view_h对象

• 函数原型：

widget_t* list_view_h_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);

• 参数说明：

list_view_h_set_item_width 函数

• 函数功能：

设置列表项的宽度。

• 函数原型：

ret_t list_view_h_set_item_width (widget_t* widget, int32_t item_width);

• 参数说明：

list_view_h_set_spacing 函数

• 函数功能：

设置列表项的间距。

• 函数原型：

ret_t list_view_h_set_spacing (widget_t* widget, int32_t spacing);

• 参数说明：

item_width 属性

列表项的宽度。

• 类型：int32_t

spacing 属性

间距。

• 类型：int32_t