1.1.31 changePage(pageNum)
版本:专业版 需要dhtmlxgrid_pgn.js支持
参数:
pageNum:跳转页面数
用途:跳转到某个页面
参考实例:
grid.changePage(5);
1.1.32 changePageRelative(ind)
版本:专业版 需要dhtmlxgrid_pgn.js支持
参数:
Ind:跳转页面的间隔数
用途:相对当前页面跳转到某个页面,即this.changePage(this.currentPage + ind);。
参考实例:
<a href="javascript:void(0)" onclick="grid.changePageRelative(-1)">上一页 </a>
<a href="javascript:void(0)" onclick="grid.changePageRelative(1)">下一页</a>
1.1.33 clearAll(header)
版本:大众版
参数:
Header: true/false是否删除表头
用途:删除。
参考实例:
<a href="javascript:void(0)" onclick="grid.changePageRelative(-1)">上一页 </a>
<a href="javascript:void(0)" onclick="grid.changePageRelative(1)">下一页</a>
1.1.34 clearAndLoad (url, call, type)
版本:大众版
参数:
url: 文件路径
call:加载完成后回调函数
type:文件类型( xml, json, jsarray, csv ),默认为xml
用途:清除当前grid数据并使用当前文件重新加载。
参考实例:
//
mygrid.clearAndLoad("grid_new.xml");
//加载完成后执行doAfterRefresh函数
mygrid.clearAndLoad("grid_new.xml",doAfterRefresh);
//指定当前文件支持格式
mygrid.clearAndLoad("grid_new.csv",doAfterRefresh,”csv”);
1.1.35 enableCSVAutoID(mode)
版本:专业版 需要dhtmlxgrid_nxml.js支持
参数:
mode: true/false
用途:csv数据加载时是否自动生成行id。
参考实例:
mygrid.enableCSVAutoID(true);
1.1.36 enableCSVHeader(mode)
版本:专业版 需要dhtmlxgrid_nxml.js支持
参数:
mode: true/false
用途:csv数据加载时是否自动使用第一行数据作为表头。
参考实例:
mygrid.enableCSVHeader(true);
1.1.37 enableDistributedParsing (mode, count, time)
版本:专业版
参数:
mode: true/false;
count:每次解析数据量,默认10
time:设定延迟时间,毫秒,默认为 250
用途:是否使用分布式解析数据,并设定每次解析节点数据量,或延迟时间。
参考实例:
//使用分布式解析
mygrid.enableDistributedParsing(true);
//分布式解析,每次解析50个节点,延迟时间2s内
mygrid.enableDistributedParsing(true,50,2000);
1.1.38 enablePaging (mode,pageSize,pagesInGrp,pagingControlsContainer,showRecInfo,pagingStateContainer)
版本:专业版 需要dhtmlxgrid_pgn.js
参数:
mode: true/false;
pageSize:每页大小
pagesInGrp:每页显示可选择页数
pagingControlsContainer:显示分页条的容器对象,或id
showReclnfo:true|false 是否显示分页数据状态
pagingStateContainer:显示分页数据状态的容器对象,或id
用途:是否使用分页操作,在init前执行。当前方法与enableSmartRendering and enableDistributedParsing 不兼容。
参考实例:
mygrid.enablePaging(true,2,5,"pagingArea",true,"recinfoArea");
1.1.39 enableSmartRendering (mode,buffer,reserved)
版本:大众版 需要dhtmlxgrid_srnd.js
参数:
mode: true/false;
buffer:总数据量
reserved:预加载量
用途:是否允许使用动态加载模式
参考实例:
mygrid.enableSmartRendering(true);//with single-time loaded data
//动态加载,总数据量2000,每次加载50
mygrid.enableSmartRendering(true,2000,50);//with dynamcical loading
1.1.40 getRowAttribute (rId, name)
版本:大众版
参数:
rid: 行索引;
name:属性名称
用途:获得某行节点的属性值
参考实例:
<?xml version='1.0' encoding='iso-8859-1'?>
<rows>
<row id="unique_rowid" some="data">
<cell some="data">cell content</cell>
</row>
</rows>
...
var rowAttr = grid.getRowAttribute("unique_rowid","some");
1.1.41 getStateOfView
版本:大众版
参数:
用途:返回grid 状态
参考实例:
var state=mygrid.getStateOfView();
//翻页模式可用时
state[0] = grid当前第几页
state[1] = 当前页面第一行索引
state[2] = 当前页面最后下一行索引
state[3] = 当前grid记录总记录数
//翻页模式不可用时
state[0] = 最前可视化行索引
state[1] = row可视化高度
state[2] = grid行数
1.1.42 getUserData(row_id, name)
版本:大众版
参数:
row_id: 行索引,不填则查找全局
name: userdata名称
用途:某行或全局userdata值,如row_id为空则查找全局,若存在多个userdata节点,则以第一个为主
参考实例:
<?xml version='1.0' encoding='iso-8859-1'?>
<rows>
<userdata name="NameOfGlobalUserDataBlock">全局userdata</userdata>
<row id="unique_rowid">
<userdata name="NameOfRowUserDataBlock">行内userdata</userdata>
<cell>cell content</cell>
<cell><![CDATA[<font color="red">cell</font> content]]></cell>
</row>
</rows>
//行内
var userdata = grid.getUserData("unique_rowid","NameOfRowUserDataBlock");
//全局user data
var userdata = grid.getUserData("","NameOfGlobalUserDataBlock");
1.1.43 load (url, call, type)
参考clearAndLoad
1.1.44 loadCSVFile (path,afterCall)
与load相识,只不过type为”csv”而已
1.1.45 loadCSVString(str)
版本:专业版 需要 dhtmlxgrid_nxml.js
参数:
str: 数据字符串
用途:以字符串形式加载
参考实例:
var str="11,12,13\n21,22,23\n31,32,33";
mygrid.loadCSVString(str);
1.1.46 parse(data,call,type)
版本:大众版
参数:
data: 字符串或js对象
call: 回调函数
type: 数据类型 (xml,json,jsarray,csv)
用途:以字符串或对象的形式加载grid对象,支持格式(xml string, csv string, xml island, xml object, json objecs , javascript array)
参考实例:
//xml 字符串或xmldoc
mygrid.parse(data);
//js数组
//parse grid from the javascript array
mygrid.parse(data,””,"jsarray");
1.1.47 preventIECaching(mode)
版本:大众版
参数:
mode: true/false
用途:阻止ie缓存当前请求值
参考实例:
mygrid.preventIECaching(true);
//disable prevent IE caching mode
mygrid.preventIECaching(false);
1.1.48 setPagingSkin(name)
版本:大众版
参数:
name: 皮肤名称
用途:设置分页皮肤,支持default,toolbar,bricks
参考实例:
mygrid.setPagingSkin("toolbar");
1.1.49 setPagingTemplates(navigation_template,info_template)
版本:大众版 dhtmlxgrid_pgn.js
参数:
navigation_template: 导航模版信息
info_template:状态模版信息
用途:设置分页模版
参考实例:
mygrid.setPagingTemplates("Pages - [current:0] [current:+1] [current:+2] , from [total] rows","Pages <b>[from]-[to]</b> of <b>[total]</b>");
1.1.50 setPagingWTMode(navButtons,navLabel,pageSelect,perPageSelect)
版本:专业版 dhtmlxgrid_pgn.js
参数:
navButtons - {true|false} 导航button是否可用
navLabel - {true|false} 导航lable是否可用
pageSelect - {true|false} 页面选择框是否可用
perPageSelect - {true|false} 每页显示条数选择框是否可用
用途:设置分页工具条的模式
参考实例:
1.1.51 setRowAttribute(rId, name, value)
版本:大众版
参数:
rid:行索引
name:属性名称
value:属性值
用途:设置某行节点属性值
参考实例:
<?xml version='1.0' encoding='iso-8859-1'?>
<rows>
<row id="unique_rowid" some="data">
<cell some="data">cell content</cell>
</row>
</rows>
...
var rowAttr = grid.setRowAttribute("unique_rowid","some","new value");
1.1.52 setUserData (row_id, name, value)
版本:大众版
参数:
rid:行索引
name:userdata节点属性名称
value:设置值
用途:设置某行或全局userdata值
参考实例:
//设置某行userdata值
mygrid.setUserData("unique_rowid","someName1","new value");
//设置全局userdata值
mygrid.setUserData("","someName1","new value");
1.1.53 startFastOperations
版本:大众版 需要dhtmlxgrid_fast.js
参数:
用途:开启快速操作,开启后事件操作将不会作用,除一些强制事件外
参考实例:
mygrid.startFastOperations();
for (var i=0; i<1000; i++)
mygrid.addRow(mygrid.uid(),[i,"new row"]);
mygrid.stopFastOperations();
1.1.54 stopFastOperations
关闭快速操作,参考startFastOperations
1.1.55 updateFromXML (url, insert_new, del_missed, afterCall)
版本:大众版
参数:
url:引用文件路径
inser_new:是否重新插入行,默认 true;
del_missed:是否删除,原有数据行
afterCall:回调函数
用途:根据xml文件重新刷新grid,并自动屏蔽重复ind
参考实例:
mygrid.updateFromXML("grid_updated.xml");
//插入新数据,删除原有数据
mygrid.updateFromXML("grid_updated.xml",true,true,doAfterUpdate);
(注:本人文章均为原创,转载请注明出处!20100622写于深圳。)
一篇好的文章应该如一坛佳酿,未偿已久醉于心;或如一壶好茶,品尝之间回味无穷;或如与心爱的人共进晚餐,仅餐秀色足以饱食。我不妄想自己的文章能惊世骇俗,但始终期待有“和旋之音,击缶之伴”。