列表容器（ListView）
<p>[TOC]</p>
<h3>创建列表容器</h3>
<pre><code>co.ListView:create(parent, id, x, y, width, height, direction)</code></pre>
<pre><code>parent 父节点对象
id 唯一ID
x 位置 横坐标
y 位置 纵坐标
width 宽度
height 高度
direction 方向 [1.垂直; 2.水平]</code></pre>
<h3>设置列表容器对齐方式</h3>
<pre><code>co.ListView:setAlignment(widget, type)</code></pre>
<pre><code>widget 列表容器对象
type 对齐方式 [0.左对齐; 1.右对齐; 2.水平居中; 3.顶对齐; 4.底对齐; 5.垂直居中]</code></pre>
<h3>设置列表容器滑动方向</h3>
<pre><code>co.ListView:setDirection(widget, dir)</code></pre>
<pre><code>widget 列表容器对象
dir 方向 [1.垂直; 2.水平]</code></pre>
<h3>获取列表容器滑动方向</h3>
<pre><code>co.ListView:getDirection(widget)</code></pre>
<pre><code>widget 列表容器对象
dir 方向 [1.垂直; 2.水平]</code></pre>
<h3>设置列表容器间隔</h3>
<pre><code>co.ListView:setItemsMargin(widget, margin)</code></pre>
<pre><code>widget 列表容器对象
margin 间隔大小(50像素)</code></pre>
<h3>获取列表容器间隔</h3>
<pre><code>co.ListView:getItemsMargin(widget)</code></pre>
<pre><code>widget 列表容器对象</code></pre>
<h3>设置列表容器是否有回弹</h3>
<pre><code>co.ListView:setBounceEnabled(widget, bool)</code></pre>
<pre><code>widget 列表容器对象
bool 是否有回弹</code></pre>
<h3>设置列表容器是否有裁切</h3>
<pre><code>co.ListView:setClippingEnabled(widget, bool)</code></pre>
<pre><code>widget 列表容器对象
bool 是否有裁剪</code></pre>
<h3>设置列表容器背景颜色</h3>
<pre><code>co.ListView:setBackGroundColor(widget, color)</code></pre>
<pre><code>widget 列表容器对象
color 色值(#000000) 渐变色需传参table{&quot;#FF0000&quot;, &quot;#FFFFFF&quot;}</code></pre>
<h3>设置列表容器背景透明度</h3>
<pre><code>co.ListView:setBackGroundColorOpacity(widget, value)</code></pre>
<pre><code>widget 列表容器对象
value 透明度(0-255)</code></pre>
<h3>设置列表容器背景图片</h3>
<pre><code>co.ListView:setBackGroundImage(widget, filename)</code></pre>
<pre><code>widget 列表容器对象
filename 图片路径</code></pre>
<h3>设置列表容器背景图片九宫格</h3>
<pre><code>co.ListView:setBackGroundImageScale9Slice(widget, scale9l, scale9r, scale9t, scale9b)</code></pre>
<pre><code>widget 列表容器对象
scale9l 左边比例
scale9r 右边比例
scale9t 上边比例
scale9b 下边比例</code></pre>
<h3>移除列表容器背景图片设置 [3.40.5版本]</h3>
<pre><code>co.ListView:removeBackGroundImage(widget)</code></pre>
<h3>插入自定义项目到列表容器末尾</h3>
<pre><code>co.ListView:pushBackCustomItem(widget, item)</code></pre>
<pre><code>widget 列表容器对象
item 子节点对象</code></pre>
<h3>插入自定义项目到列表容器指定位置</h3>
<pre><code>co.ListView:insertCustomItem(widget, item, index)</code></pre>
<pre><code>widget 列表容器对象
item 子节点对象
index 插入的位置</code></pre>
<h3>列表容器删除所有子节点</h3>
<pre><code>co.ListView:removeAllItems(widget)</code></pre>
<h3>通过序列号删除列表容器子节点</h3>
<pre><code>co.ListView:removeItemByIndex(widget, index)</code></pre>
<pre><code>widget 列表容器对象
index 要删除的节点序列号位置</code></pre>
<h3>列表容器删除子节点</h3>
<pre><code>co.ListView:removeChild(widget, item)</code></pre>
<pre><code>widget 列表容器对象
item 子节点对象</code></pre>
<h3>跳转到列表容器序列号节点位置</h3>
<pre><code>co.ListView:jumpToItem(widget, index)</code></pre>
<pre><code>widget 列表容器对象
index 子节点序列号位置</code></pre>
<h3>跳转到列表容器底部</h3>
<pre><code>co.ListView:jumpToBottom(widget)</code></pre>
<pre><code>widget 列表容器对象</code></pre>
<h3>滚动到列表容器顶部</h3>
<pre><code>co.ListView:scrollToTop(widget,time,bool)</code></pre>
<pre><code>widget 列表容器对象
time 滚动时间
bool 滑动速度是否减弱</code></pre>
<h3>滚动到列表容器底部</h3>
<pre><code>co.ListView:scrollToBottom(widget,time,bool)</code></pre>
<pre><code>widget 列表容器对象
time 滚动时间
bool 滑动速度是否减弱</code></pre>
<h3>获取列表容器最顶部可见范围子节点</h3>
<pre><code>co.ListView:getVisibleTopItem(widget)</code></pre>
<h3>获取列表容器最底部部可见范围子节点</h3>
<pre><code>co.ListView:getVisibleBottomItem(widget)</code></pre>
<h3>获取子节点序列号</h3>
<pre><code>co.ListView:getItemIndex(widget,item)</code></pre>
<pre><code>widget 列表容器对象
item 子节点对象</code></pre>
<h3>通过子节点序列号获取子节点对象</h3>
<pre><code>co.ListView:getItemByIndex(widget, index)</code></pre>
<pre><code>widget 列表容器对象
index 子节点序号</code></pre>
<h3>获取列表容器所有子节点对象</h3>
<pre><code>co.ListView:getItems(widget)</code></pre>
<pre><code>widget 列表容器对象</code></pre>
<h3>获取列表容器所有子节点数量</h3>
<pre><code>co.ListView:getItemCount(widget)</code></pre>
<h3>设置列表容器滚动事件</h3>
<pre><code>co.ListView:addScrollEventListener(widget, callback)</code></pre>
<pre><code>widget 列表容器对象
callback 回调函数</code></pre>
<h3>列表容器刷新</h3>
<pre><code>co.ListView:doLayout(widget)</code></pre>
<h3>列表容器刷新</h3>
<pre><code>co.ListView:requestDoLayout(widget)</code></pre>
<h3>列表容器可见区域绘制</h3>
<pre><code>co.ListView:paintItems(widget)</code></pre>
<h3>列表容器可见区域自动绘制</h3>
<pre><code>co.ListView:autoPaintItems(widget)</code></pre>
<h3>获取列表容器滚动范围大小</h3>
<pre><code>co.ListView:getInnerContainerSize(widget)</code></pre>
<h3>获取列表容器滚动范围大小</h3>
<pre><code>co.ListView:getInnerContainerSize(widget)</code></pre>
<h3>设置列表容器滚动到某百分比位置</h3>
<pre><code>co.ListView:scrollToPercent(widget, type, percent, time, bool)</code></pre>
<pre><code>widget 列表容器对象
type 方向 [1.垂直; 2.水平]
percent 百分比(0-100)
time 滚动时间
bool 是否衰减滚动速度</code></pre>
<h3>设置列表容器滚动到某百分比位置(垂直方向)</h3>
<pre><code>co.ListView:scrollToPercentVertical(widget, percent, time, bool)</code></pre>
<pre><code>widget 列表容器对象
percent 百分比(0-100)
time 滚动时间
bool 是否衰减滚动速度</code></pre>
<h3>设置列表容器滚动到某百分比位置(水平方向)</h3>
<pre><code>co.ListView:scrollToPercentHorizontal(widget, percent, time, bool)</code></pre>
<pre><code>widget 列表容器对象
percent 百分比(0-100)
time 滚动时间
bool 是否衰减滚动速度</code></pre>
<h3>添加鼠标滚轮滑动列表容器事件</h3>
<pre><code>co.ListView:addMouseScrollPercent(widget)</code></pre>
<h3>为listview设置一个项目模型</h3>
<pre><code>co.ListView:setItemModel(widget,parentNode)</code></pre>
<pre><code>widget ListView控件对象
model 项目模型</code></pre>
<h3>获取子项目模型(H5调用)</h3>
<pre><code>co.ListView:getItemModel(widget)</code></pre>
<pre><code>widget ListView控件对象</code></pre>
<h3>在listview的末尾插入一个默认项目(由克隆模型创建)</h3>
<pre><code>co.ListView:pushBackDefaultItem(widget)</code></pre>
<h3>重新加载列表数据,listView中需要一个子项目作为蓝图</h3>
<pre><code>co.ListView:reloadData(listView,len,callback,isAdapt,parent)</code></pre>
<pre><code>listView 列表容器对象
len 数据长度
callback 回调函数,参数(子项目)
isAdapt true ListView大小跟随子项目数量自适应大小
parent H5调用(将模型克隆到指定组件上作为蓝图,一般用于两个ListView嵌套同时调用reloadData方法,子控件ListView可将模型克隆到指定节点上)</code></pre>
<h3>更新ListView所有子节点</h3>
<pre><code>co.ListView:updateItems(listView)</code></pre>
<h3>通过子节点标记更新某个子项目</h3>
<pre><code>co.ListView:updateItemByTag(listView,tag)</code></pre>
<pre><code>listView 列表容器对象
tag 子节点标记</code></pre>
<h3>通过子节点名称更新某个子项目</h3>
<pre><code>co.ListView:updateItemByName(listView,name)</code></pre>
<pre><code>listView 列表容器对象
name 子节点名称</code></pre>
<h3>通过子控件对象更新控件信息</h3>
<pre><code>co.ListView:updateItemByWidget(listView,widget)</code></pre>
<pre><code>listView 列表容器对象
name 子节点名称</code></pre>
<h3>获取ListView容器内子节点数量</h3>
<pre><code>co.ListView:getChildrenCount(listView)</code></pre>
<h3>通过索引获取子项目</h3>
<pre><code>co.ListView:getChildByIndex(listView,index)</code></pre>
<pre><code>listView 列表容器对象
index 子项目索引</code></pre>