scroll_view_t

概述

滚动视图。

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

在xml中使用”scroll_view”标签创建滚动视图控件。如：

 <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%">
     <list_item style="odd" children_layout="default(rows=1,cols=0)">
       <image draw_type="icon" w="30" image="earth"/>
       <label w="-30" text="1.Hello AWTK !">
         <switch x="r:10" y="m" w="60" h="20"/>
       </label>
     </list_item>
     ...
   </scroll_view>
  </list_view>

滚动视图一般作为列表视图的子控件使用。

更多用法请参考：list_view_m.xml

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

  widget_t* scroll_view = scroll_view_create(win, 0, 0, 0, 0);

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

函数

属性

scroll_view_cast 函数

• 函数功能：

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

• 函数原型：

widget_t* scroll_view_cast (widget_t* widget);

• 参数说明：

scroll_view_create 函数

• 函数功能：

创建scroll_view对象

• 函数原型：

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

• 参数说明：

scroll_view_scroll_to 函数

• 函数功能：

滚动到指定的偏移量。

• 函数原型：

ret_t scroll_view_scroll_to (widget_t* widget, int32_t xoffset_end, int32_t yoffset_end, int32_t duration);

• 参数说明：

scroll_view_set_offset 函数

• 函数功能：

设置偏移量。

• 函数原型：

ret_t scroll_view_set_offset (widget_t* widget, int32_t xoffset, int32_t yoffset);

• 参数说明：

scroll_view_set_virtual_h 函数

• 函数功能：

设置虚拟高度。

• 函数原型：

ret_t scroll_view_set_virtual_h (widget_t* widget, wh_t h);

• 参数说明：

scroll_view_set_virtual_w 函数

• 函数功能：

设置虚拟宽度。

• 函数原型：

ret_t scroll_view_set_virtual_w (widget_t* widget, wh_t w);

• 参数说明：

scroll_view_set_xslidable 函数

• 函数功能：

设置是否允许x方向滑动。

• 函数原型：

ret_t scroll_view_set_xslidable (widget_t* widget, bool_t xslidable);

• 参数说明：

scroll_view_set_yslidable 函数

• 函数功能：

设置是否允许y方向滑动。

• 函数原型：

ret_t scroll_view_set_yslidable (widget_t* widget, bool_t yslidable);

• 参数说明：

virtual_h 属性

虚拟高度。

• 类型：wh_t

virtual_w 属性

虚拟宽度。

• 类型：wh_t

xoffset 属性

x偏移量。

• 类型：int32_t

xslidable 属性

是否允许x方向滑动。

• 类型：bool_t

yoffset 属性

y偏移量。

• 类型：int32_t

yslidable 属性

是否允许y方向滑动。

• 类型：bool_t