马上加入TC
您需要 登录 才可以下载或查看,没有帐号?立即注册
x
本帖最后由 apq0001 于 2015-4-29 11:11 编辑
TC5.0表格新增API使用说明:
主要更新变化:
1.插入行列支持数组插入一行/列数据 2.新增表格列文本对齐API
1.gridsetshowpagemode(id,n,parentID="")
说明:
设置表格为分页显示模式,使用此API设定表格模式后数据操作依据于分页模式下的操作规则
表格处于非分页模式下时,使用此API 将会使用当前的表格数据作为分页展示的数据源
表格处于分页模式下时,使用此API 将会使用原有的数据源重新分页展示
表格处于分页模式下时,可以使用 gridfillarraydata 更新数据源,或者使用 gridcancelshowpagemode 退出分页模式
分页模式下禁止的操作有:插入/删除固定行 ,修改表格固定行数,修改表格显示行数(修改显示行数在分页模式下应使用gridsetshowpagemode 来完成)
表格通用规则:在固定行/列里不允许插入行/列,删除不受影响,非固定行列无此限制
2.gridfillarraydata(Control_ID,arraydata,parentID="")
说明:使用二维数组一次性插入大量数据
在分页模式下,如果存在固定行,则固定行的第1行展示列头,即一维数组“id”=“值”的id部分,从第2行第1列开始展示有效数据, 展示行数为API:gridsetshowpagemode(id,n,parentID="") 设置的行数;
如果不存在固定行,则不展示列头,数据行从第1行开始展示
非分页模式下,存在固定行,则固定行的第1行展示列头,从第二行开始展示数据,将二维数组的内容全部展示出来;没有固定行的情况下,仅展示数据
3.gridshowprevpagedata(id,parentID="")
说明:分页模式下显示上一分页数据
4.gridshownextpagedata(id,parentID="")
说明:分页模式下显示下一分页数据
5.gridshowcustompagedata(id,n,parentID="")
说明:分页模式下显示自定义分页数据,参数n必须是有效分页,索引从0开始
6.gridgetpagearraydata(id,n=-1,parentID="")
说明:
第二个参数n默认值=-1表示当前页面
第二个参数n不填写的话则自动获取当前页数据的二维数组,即非分页表格模式下获取整个表格数据,分页表格模式下获取当前页面数据
第二个参数n填写的话只能获取分页模式下表格第n页数据的二维数组,没有则返回空字符串
7.gridgetarraydata(id,parentID="")
说明:获取表格所有数据的二维数组,返回数组形式的字符串,不论是分页还是非分页模式,都是获取表格所有数据的二维数组
8.gridgetallpagecount(id,parentID="")
说明:获取表格所有分页数量,分页模式下为分页数量,非分页模式下永远为1
9.gridgetcurpageindex(id,parentID="")
说明:获取表格当前分页的索引,分页模式下为当前分页索引号,非分页模式下永远为0
10.gridsetcolalign(id,nCol,nAlign,parentID="")
说明:设置表格列为nCol的所有单元格的文本对齐方式,nAlign:(0:居左,1:居中,2:居右)
备注:
分页模式下插入/删除数据行列的规则:
1. 插入数据起始索引为表格的显示索引(即从左上角坐标(0,0)算起),固定行内不能插入/删除行,插入行并不会增加表格视觉上的行数,而是增加了数据源里的数据,同理,删除行也不是删除了表格视觉上的一行,而是删除了数据源里的数据,插入列/删除列和非分页模式下一样
2. 修改数据起始索引为表格上的显示索引,修改数据后会把此索引转换为数据源里的实际索引进行修改,用户感官上和操作非分页模式下的表格数据是一样的
3.使用插入行API:
gridinsertrow(名称,内容数组=null,行号=-1,父窗口ID) 插入1行数据单元格起始索引从第1列(即索引号=0)开始计算,数组过短表格自动使用空字符串补齐,过多则多余部分自动舍弃
如图:数组内容为:array("test1","test2","test3","test4","test5","test6")
插入行代码:
- var arr =array("test1","test2","test3","test4","test5","test6")
- gridinsertrow("grid",arr,2) // 在表格的第三行插入一行数据
复制代码
备注:
1.如果要插入一行空行,则使用代码:gridinsertrow("grid",null,2);即数据部分填写null表示空数据 2.如果要在表格末尾插入一行,则行号=-1 或者不填
4. 使用插入列API:
gridinsertcol(名称,列头内容,内容数组=null,列号=-1,父窗口ID="")
插入1列数据单元格起始索引从第1行开始计算(存在固定行的情况下,第一行固定行插入列头内容),固定行不存在的情况下,列头内容不插入,只插入数据 分页模式下插入一列数据从第一页开始插入
如图:插入列代码
- var arr =array("test1","test2","test3","test4","test5","test6")
- gridinsertcol("grid", "测试列头",arr,2)
复制代码
备注:
1.如果要插入一列空列,则使用代码:gridinsertcol("grid", "测试列头",null,2) ;即数据部分填写null表示空 2.如果要在表格末尾插入一列,则列号=-1 或者不填
5. 存在多个固定行的情况时,第一行固定行插入列头,以后的固定行插入数据和普通单元格一样
如图:
表格API演示附件:
表格分页模式下数据操作示例.rar
(1.59 MB, 下载次数: 778)
file:///C:/DOCUME~1/ADMINI~1/LOCALS~1/Temp/msohtml1/01/clip_image010.jpg
|