dhtmlx使用翻译（三）dhtmlxgrid 数据加载部分

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)" οnclick="grid.changePageRelative(-1)">上一页 </a>

<a href="javascript:void(0)" οnclick="grid.changePageRelative(1)">下一页</a>

1.1.33 clearAll(header)

版本：大众版

参数：

Header： true/false是否删除表头

用途：删除。

参考实例：

<a href="javascript:void(0)" οnclick="grid.changePageRelative(-1)">上一页 </a>

<a href="javascript:void(0)" οnclick="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写于深圳。）