滚动容器（ScrollView）

<p>[TOC]</p> <h3>创建滚动容器</h3> <pre><code>co.ScrollView:create(parent, id, x, y, width, height, direction)</code></pre> <pre><code>parent    父节点对象 id        唯一ID x         位置 横坐标 y         位置 纵坐标 width     宽度 height    高度 direction 方向 [.垂直; 2.水平]</code></pre> <h3>设置滚动容器滚动范围大小</h3> <pre><code>co.ScrollView:setInnerContainerSize(widget, value1, value2)</code></pre> <pre><code>widget 滚动容器对象 value1 宽度或尺寸(table{width = 宽度,height = 高度}) value2 高度 如果value1是尺寸,则可省略</code></pre> <h3>获取滚动容器滚动范围大小</h3> <pre><code>co.ScrollView:getInnerContainerSize(widget)</code></pre> <h3>获取容器内部滚动区域坐标 [3.40.3版本]</h3> <pre><code>co.ScrollView:getInnerContainerPosition(widget)</code></pre> <h3>设置组件在内部滚动区域坐标</h3> <pre><code>co.ScrollView:setInnerContainerPosition(widget,pos)</code></pre> <h3>设置滚动容器滚动方向</h3> <pre><code>co.ScrollView:setDirection(widget, dir)</code></pre> <pre><code>widget 滚动容器对象 dir    方向 [1.垂直; 2.水平]</code></pre> <h3>获取滚动容器滚动方向</h3> <pre><code>co.ScrollView:getDirection(widget)</code></pre> <pre><code>widget 滚动容器对象 dir    方向 [1.垂直; 2.水平]</code></pre> <h3>设置滚动容器是否有回弹</h3> <pre><code>co.ScrollView:setBounceEnabled(widget, bool)</code></pre> <pre><code>widget 滚动容器对象 bool   是否有回弹</code></pre> <h3>设置滚动容器是否有裁切</h3> <pre><code>co.ScrollView:setClippingEnabled(widget, bool)</code></pre> <pre><code>widget 滚动容器对象 bool   是否有裁切</code></pre> <h3>设置滚动容器背景颜色</h3> <pre><code>co.ScrollView:setBackGroundColor(widget, color)</code></pre> <pre><code>widget 滚动容器对象 color  色值(#000000) 渐变色需传参table{&amp;quot;#FF0000&amp;quot;, &amp;quot;#FFFFFF&amp;quot;}</code></pre> <h3>设置滚动容器背景颜色类型</h3> <pre><code>co.ScrollView:setBackGroundColorType(widget, type)</code></pre> <pre><code>widget 滚动容器对象 type   类型 [1.单色; 2.渐变色]</code></pre> <h3>设置滚动容器背景透明度</h3> <pre><code>co.ScrollView:setBackGroundColorOpacity(widget, value)</code></pre> <pre><code>widget 滚动容器对象 value  透明度(0-255)</code></pre> <h3>设置滚动容器背景图片</h3> <pre><code>co.ScrollView:setBackGroundImage(widget, filename)</code></pre> <pre><code>widget   滚动容器对象 filename 图片路径</code></pre> <h3>移除滚动容器背景图片设置 [3.40.5版本]</h3> <pre><code>co.ScrollView:removeBackGroundImage(widget)</code></pre> <h3>设置滚动器背景图片九宫格</h3> <pre><code>co.ScrollView:setBackGroundImageScale9Slice(widget, scale9l, scale9r, scale9t, scale9b)</code></pre> <pre><code>widget  滚动容器对象 scale9l 左边比例 scale9r 右边比例 scale9t 上边比例 scale9b 下边比例</code></pre> <h3>设置滚动容器滚动事件</h3> <pre><code>co.ScrollView:addScrollEventListener(widget, callback)</code></pre> <pre><code>widget   滚动容器对象 callback 回调函数</code></pre> <h3>滚动容器加载子节点</h3> <pre><code>co.ScrollView:addChild(widget, item)</code></pre> <pre><code>widget 滚动容器对象 item   子节点对象</code></pre> <h3>滚动容器删除所有子节点</h3> <pre><code>co.ScrollView:removeAllChildren(widget)</code></pre> <h3>滚动容器到顶部</h3> <pre><code>co.ScrollView:scrollToTop(widget, time, bool)</code></pre> <pre><code>widget 滚动容器对象 time   滚动时间 bool   是否衰减</code></pre> <h3>滚动容器到底部</h3> <pre><code>co.ScrollView:scrollToBottom(widget, time, bool)</code></pre> <pre><code>widget 滚动容器对象 time   滚动时间 bool   是否衰减</code></pre> <h3>滚动容器到左边</h3> <pre><code>co.ScrollView:scrollToLeft(widget, time, bool)</code></pre> <pre><code>widget 滚动容器对象 time   滚动时间 bool   是否衰减</code></pre> <h3>滚动容器到右边</h3> <pre><code>co.ScrollView:scrollToRight(widget, time, bool)</code></pre> <pre><code>widget 滚动容器对象 time   滚动时间 bool   是否衰减</code></pre> <h3>滚动容器到顶左</h3> <pre><code>co.ScrollView:scrollToTopLeft(widget, time, bool)</code></pre> <pre><code>widget 滚动容器对象 time   滚动时间 bool   是否衰减</code></pre> <h3>滚动容器到百分比(垂直方向)</h3> <pre><code>co.ScrollView: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.ScrollView:scrollToPercentVertical(widget, percent, time, bool)</code></pre> <pre><code>widget  滚动容器对象 percent 百分比(0-100) time    滚动时间 bool    是否衰减滚动速度</code></pre> <h3>滚动容器到百分比(水平方向)</h3> <pre><code>co.ScrollView:scrollToPercentHorizontal(widget, percent, time, bool)</code></pre> <pre><code>widget  滚动容器对象 percent 百分比(0-100) time    滚动时间 bool    是否衰减滚动速度</code></pre> <h3>滚动容器添加滚动条</h3> <pre><code>co.ScrollView:addScrollViewVerticalBar(widget, param)</code></pre> <pre><code>widget 滚动容器对象 param = { bgPic       背景图 barPic      滑动按钮图片 Arr1PicN    上（正常图） Arr1PicP    上（按下图）可不传 Arr2PicN    下（正常图） Arr2PicP    下（按下图）可不传 default     进度条值（默认是0） x           进度条坐标 x y           进度条坐标 y list        滚动的容器 list callFunc    容器滚动的回调函数 }</code></pre> <h3>设置项目列数,针对TableView调用</h3> <pre><code>co.ScrollView:setTableView(scroll,column,horizontal,vertical)</code></pre> <pre><code>scroll      ScrollView组件对象 column      列数 horizontal  水平间距 vertical    垂直间距</code></pre> <h3>设置容器项目间距</h3> <pre><code>co.ScrollView:setItemsMargin(scroll,margin)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>获取项目间距</h3> <pre><code>co.ScrollView:getItemsMargin(scroll)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>更新所有项目</h3> <pre><code>co.ScrollView:updateItems(scroll)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>通过节点标记更新项目</h3> <pre><code>co.ScrollView:updateItemByTag(scroll,tag)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>通过节点名称更新项目</h3> <pre><code>co.ScrollView:updateItemByName(scroll,name)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>通过索引更新项目数据</h3> <pre><code>co.ScrollView:updateItemByIndex(scroll,index)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>通过节点模型更新项目</h3> <pre><code>co.ScrollView:updateItemByItem(scroll,item)</code></pre> <pre><code>scroll ScrollView组件对象 item   子控件对象</code></pre> <h3>通过标记删除子控件</h3> <pre><code>co.ScrollView:deleteItemByTag(scroll,tag)</code></pre> <pre><code>scroll ScrollView组件对象 tag    子控件标记</code></pre> <h3>获取子项目控件列表</h3> <pre><code>co.ScrollView:getItems(scroll)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>获取子项目数量</h3> <pre><code>co.ScrollView:getItemCount(scroll)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>通过索引获取项目</h3> <pre><code>co.ScrollView:getChildByIndex(scroll,index)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>插入默认项目模型到尾部</h3> <pre><code>co.ScrollView:pushBackDefaultItem(scroll)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>插入默认项目模型到指定位置</h3> <pre><code>co.ScrollView:insertDefaultItem(scroll,index)</code></pre> <pre><code>scroll ScrollView组件对象 index  插入位置</code></pre> <h3>请求更新布局</h3> <pre><code>co.ScrollView:requestItemLayout(scroll)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>通过两个子项目标记交换位置</h3> <pre><code>co.ScrollView:convertItemByTag(scroll,tag1,tag2,style)</code></pre> <pre><code>scroll  ScrollView组件对象 tag1    子项目组件1标记 tag2    子项目组件2标记 style   交换动画风格(预留)</code></pre> <h3>通过两个子项目索引交换位置</h3> <pre><code>co.ScrollView:convertItemByIndex(scroll,index1,index2,style)</code></pre> <pre><code>scroll  ScrollView组件对象 index1  子项目组件1标记 index2  子项目组件2标记 style   交换动画风格(预留)</code></pre> <h3>通过两个子项目索引交换位置</h3> <pre><code>co.ScrollView:convertItemByName(scroll,name1,name2,style)</code></pre> <pre><code>scroll  ScrollView组件对象 name1   子项目组件1名称 name2   子项目组件2名称 style   交换动画风格(预留)</code></pre> <h3>通过子项目标记移动到指定位置</h3> <pre><code>co.ScrollView:moveItemByTag(scroll,tag,pos,style)</code></pre> <pre><code>scroll  ScrollView组件对象 tag     子项目组件标记 pos     移动的位置 style   动画风格(预留)</code></pre> <h3>通过子项目索引移动到指定位置</h3> <pre><code>co.ScrollView:moveItemByIndex(scroll,index,pos,style)</code></pre> <pre><code>scroll  ScrollView组件对象 index   子项目组件索引 pos     移动的位置 style   动画风格(预留)</code></pre> <h3>通过子项目名称移动到指定位置</h3> <pre><code>co.ScrollView:moveItemByName(scroll,name,pos,style)</code></pre> <pre><code>scroll  ScrollView组件对象 name    子项目组件名称 pos     移动的位置 style   动画风格(预留)</code></pre> <h3>通过子项目标记移动项目到尾部</h3> <pre><code>co.ScrollView:moveItemToBottomByTag(scroll,tag,style)</code></pre> <pre><code>scroll  ScrollView组件对象 tag     子项目组件标记 style   动画风格(预留)</code></pre> <h3>通过子项目索引移动项目到尾部</h3> <pre><code>co.ScrollView:moveItemToBottomByIndex(scroll,index,style)</code></pre> <pre><code>scroll  ScrollView组件对象 index   子项目组件索引 style   动画风格(预留)</code></pre> <h3>通过子项目名称移动项目到尾部</h3> <pre><code>co.ScrollView:moveItemToBottomByName(scroll,name,style)</code></pre> <pre><code>scroll ScrollView组件对象 name   子项目组件名称 style  动画风格(预留)</code></pre> <h3>移除所有子控件</h3> <pre><code>co.ScrollView:removeItems(scroll)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>设置自适应大小</h3> <pre><code>co.ScrollView:setAdaptSize(scroll)</code></pre> <pre><code>scroll ScrollView组件对象</code></pre> <h3>以列表形式重新加载项目</h3> <pre><code>co.ScrollView:reloadListView(scroll,count,callback,isInertia)</code></pre> <pre><code>scroll    ScrollView组件对象 count     加载项目数量 callback  回调函数,参数(子控件) isInertia 是否关闭惯性,默认是开启的</code></pre> <h3>以table列表形式重新加载项目</h3> <pre><code>co.ScrollView:reloadTableView(scroll,count,callback,isInertia)</code></pre> <pre><code>scroll    ScrollView组件对象 count     加载项目数量 callback  回调函数,参数(子控件) isInertia 是否关闭惯性,默认是开启的</code></pre> <h3>以itemshow列表形式重新加载</h3> <pre><code>co.ScrollView:reloadIconView(scroll,tab)</code></pre> <pre><code>tab.pos or 1       --居中位置,1.左对齐;2.居中;3.右对齐 tab.margin or 6    --间距 tab.nodeName       --自定义文本节点名称,物品数量显示在这个文本里,不走itemshow显示的数量 tab.isMoney        --是否以亿万模式显示数值 tab.scale or 1     --itemShow缩放比例 tab.data           --物品数据 tab.font           --物品数值文字大小 tab.dir            --方向 tab.checkArrow     --是否显示提升箭头 tab.animId         --对带有物品框的消耗风格增加额外的特效,可以是一个特效ID,可以是一个特效ID数组 tab.numx or 0      --道具数量x偏移 tab.numy or 0      --道具数量y偏移 tab.animX or 0     --特效偏移x tab.animY or 0     --特效偏移y tab.animScale or 1 --特效缩放</code></pre> <h3>获取scroll容器所有子节点</h3> <pre><code>ScrollView:getChildren(scroll)</code></pre> <h3>获取ScrollView内部容器</h3> <pre><code>co.ScrollView:getInnerContainer(scroll)</code></pre>