马上加入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
| 
/2 
发表于 2015-4-29 09:56:18
发表于 2015-4-29 10:03:27
楼主