事件

参数

描述

afterInsertRow

Rowed

Rowdata

Rowelem

此事件发生在每次插入行后

rowid 为插入的行 ID

rowdata 是被插入行的数据数组。格式为 name:value 对， name 在 colModel 定义

rowelem 是应答元素。 xml 为 xml 行， json 为所有行数据。

注意：若 gridview 为 true ，此事件不会发生

beforeRequest

none

此事件发生在任何数据请求前，但当 datatype 为 function 时不发生。

beforeSelectRow

rowid, e

此事件发生在用户点击行，选中该行前。

rowid 为行的 ID ， e 为事件对象

该事件将返回布尔值 true （行被选中）或 false （行未被选中）。

gridComplete

none

此事件发生在表格所有数据装入和进程完成后。与 datatype 参数及排序分页等无关。

loadBeforeSend

xhr

此事件发生在 XMLHttpRequest 被发送前，用于修改对象属性（如 headers ）。

xhr 为 XMLHttpRequest 对象。

loadComplete

xhr

此事件发生在每个服务器请求后。 xhr 为 XMLHttpRequest 对象。

loadError

xhr,

status,

error

此事件在请求失败时发生。事件有 3 个参数：

xhr 为 XMLHttpRequest 对象；

Satus 为错误类型描述； error 为错误对象。

onCellSelect

rowid,

iCol,

cellcontent,

e

此事件在点击表格特定单元格时发生。

rowid 为行 ID ； iCol 为列索引；

cellcontent 为单元格中内容；

e 点击事件对象。

ondblClickRow

rowid,

iRow,

iCol,

e

此事件发生在行双击后发生。

rowid 为行 ID ； iRow 为行索引（勿与 rowid 混淆）；

iCol 为列索引；

e 为事件对象。

onHeaderClick

gridstate

此事件发生在点击显示或隐藏表格后发生（ hidegrid 为 true ）

gridstate 为表格状态，有 visible 和 hidden 两个值

onPaging

pgButton

此事件发生在点击 page button 后，填充数据前，及用户输入一个与当前页页码不同的新页码并回车时。参见 pager

onRightClickRow

rowid,

iRow,

iCol,

e

此事件发生在右击行后。（此事件在 Opera 浏览器中无效）

rowid 为行 ID ； iRow 为行索引（勿与 rowid 混淆）

iCol 为列索引；

e 为事件对象。

onSelectAll

aRowids,

status

此事件发生在点击标题的复选框时发生（ multiselect 为 true ）

aRowids 选定行 ID 的数组（哪些行的复选框与头复选框相同）

status 头复选框的选定的布尔值， true 为选中， false 为未选中

onSelectRow

rowid,

status

此事件发生在行点击后

rowid 为行 ID ；

status 为选择状态。当 multiselect 为 true 时使用，当行被选中时返回 true ；为选中时返回 false 。

onSortCol

index,

iCol,

sortorder

此事件发生在列排序被点击之后，数据排序前

index 为 colModel 中定义的索引名； iCol 为列的索引号

sortorder 为新的排序方式， asc 或 desc

resizeStart

event,

index

此事件发生在列被重新定义宽度时。

event 为事件对象； index 为在 colModel 中定义的列索引。

resizeStop

newwidth, index

此事件发生在列被重新定义宽度后。

newwidth 为新的列宽度； index 为在 colModel 中定义的列索引。

serializeGridData

postData

通过此事件可以序列化传递给 ajax 请求的的数据。此事件将返回一个以序列化的数据。若有自定义的数据（如 JSON 字符串、 XML 字符串）要发给服务器时，可使用该事件。

方法

参数

返回值

描述

addJSONData

data

none

用传递的 data （数组）填充网格。用法：假如我们从 web 服务器获得的数据（ jsonresponse ），则

var mygrid = jQuery(”#”+grid_id)[0];

var myjsongrid = eval(”(”+jsonresponse.responseText+”)”);

mygrid.addJSONData(myjsongrid);

myjsongrid = null;

jsonresponse =null;

将填充网格。当然， myjsongrid 中的数据在传递到 addJSONData 之前可以被操作。

addRowData

rowid,

data,

position,

srcrowid

成功返回 true ，否则返回 false 。

插入一新行， rowid 为新行的 ID ， data （数组）为新行数据， position 为 新行插入的位置（ first 为表头， last 为表尾， srcrowid 指定偏移位置）。 Data 数组的格式为： : {name1:value1,name2: value2…} ， name 为 colModel 指定的名称。

addXMLData

data

none

用传入的 data 填充网格。用法：假如我们从 web 服务器获得数据

(xmlresponse) ，则

var mygrid = jQuery(”#”+grid_id)[0];

mygrid.addXmlData(xmlresponse.responseXML);

将填充网格。当然， xmlresponse 中的数据在传递到 addXmlData 之前可以被操作。

clearGridData

clearfooter

jqGrid object

清除网格中当前装入的数据，如果 clearfooter 参数为 true ，则清除网格最后一行数据。

delRowData

rowid

成功返回 true 否则返回 false

删除 id = rowid 的行。但不会删除服务器上的数据。

footerData

action,

data,

format

jqGrid 对象

此方法获得或设置网格底部数据。见 footerrow in options array 。

action – 可设置为 get （缺省）或 set 。 Get 从底部返回 name:value 对象（ name 为 colModel 中的名称）。此时其他两个参数无效。

Set 将 data 数组（对象）设置到底部。 Data 为 colName 中的名称和值对。

format – 缺省为 true ，表示设置时使用 formatter ( 如果 colModel 中已定义 ) 。 false 表示不使用 formatter 。

getCell

rowid,

iCol

单元格

内容

返回 id = rowid 行 ， column = iCol 列 的内容。 iCol 可以是列的索引或 colName 中定义的名称。 在编辑行或列时不能使用该方法，此时返回的不是当前值，而是原始值。

getCol

colname, returntype, mathoperation

数组或值

返回列值数组。

colname 可以是列的索引值或 colModel 中的名称。 returntype 确定返回数组的类型，为 false( 缺省 ) 时，数组只包含值。为 true 时为对象数组，格式为 {id:rowid, value:cellvalue} ， id 为行的 id ， cellvalue 为单元格的值。如 [{id:1,value:1},{id:2,value:2}…]

mathoperation 为可选参数，可以是 sum 、 avg 和 count 。若此参数进行了有效设置，则返回计算后的值，若无效，则返回空数组。

getDataIDs

none

数组

返回当前网格显示数据的 ID 数组。无数据时返回空数组。

getGridParam

name

混合值

返回请求的参数的值。 name 是 options 数组中的名称，若为设置则 options 被返回。详见 options .

getInd

rowid,

rowcontent

mixed

当 rowcontent 设置为 false （缺省）时，返回 id= rowid 行的索引值。若 rowcontent 设置为 true ，则返回整行。若为找到 rowid 则返回 false 。

getRowData

rowid or none

array{}

返回 id = rowid 行的数据数组。格式为 name:value 对， name 为 colModel 中的名称， value 为该行的值。未找到返回空数组。 在行或列编辑时此方法不可用，此时返回的不是当前值，而是原始值。

若 rowid 为设置，则返回网格中所有数据数组。

hideCol

Colname 或

[colnames]

jqGrid 对象

根据 colname 或 colnames 数组给定的列名隐藏相应的列，列名必须是 colModel 中定义的名称。表格的宽度不会改变。

remapColumns

permutation, updateCells, keepHeader

none

调整列的显示顺序。 permutation 指定调整后的顺序，如 [1,0,2] 表示第一列在第二位显示。若 updateCells 设置为 true ，列数据将重新排序。若 keepHeader 设置为 true ， header 单元格将重新排序。

resetSelection

none

jqGrid 对象

选择（反选）行。多选择模式下同样可用。

setCaption

caption

jqGrid 对象

设置新的表头文字。若表头为隐藏，将显示。

setCell

rowid,

colname,

data,

class,

properties

jqGrid 对象

修改单元格的值、类或样式。其中：

Rowid 为行 ID ； Colname 为列名（可以是从 0 开始的列的索引值）；

data 设置的内容，若为空，则不修改； class 若为字符串，将使用 addClass 为列加入一个类，若为数组，将直接加入 CSS 中； properties 设置单元格属性。

setGridParam

object

jqGrid 对象

设置一个特定的参数。

有些参数需 trigger(“reloadGrid”) 才能生效。注意这个方法可以覆盖事件。名称（ name:value 对）为选项数组中的名称。 选项信息参见 options .

setGridHeight

new_height

jqGrid 对象

动态设置网格高度。只能对单元格的高度进行设置而不是网格。 new_height 可以是像素、百分比或 auto 。

setGridWidth

new_width,

shrink

jqGrid 对象

动态设置网格宽度。 new_width 为新宽度的像素值；

shrink （ true 或 false ）作用同 shrinkToFit （见 options ）。若不设置，则使用 shrinkToFit 设置。

setLabel

colname,

data,

class,

properties

jqGrid 对象

设置指定列标题文字、属性和类：

colname 为列名，可以是从 0 开始的列索引；

data 为标题文字，为空则不修改；

class 若为字符串，则为类名，若为数组，则直接写入 CSS ；

properties 为标题文字的属性。

setRowData

rowid,

data,

cssprop

成功返回 true ，否则返回 false

更新 rowid 指定 行的数据（使用数组）。

Data 数组的格式为 : {name1:value1,name2: value2…} 。 name 为 colModel 中描述的名称， value 为新值。 cssprop 若为字符串，将使用 addClass 为行添加类；若为数组对象，则直接加入 CSS 中。将 data 设置为 false 的情况下，可设置属性和类名

setSelection

rowid,

onselectrow

jqGrid 对象

选择或反选 id = rowid 指定的行。若 onselectrow 设置 为 true ( 缺省 ) 则触发 onSelectRow 事件，否则不触发。

showCol

colname

jqGrid 对象

显示 colname 指定的列。若 colname 为字符串，只显示指定的列，若 colname 为数组 [“name1”,”name2”] 则显示 name1 和 name2 列， name 必须是 colModel 中的名称。宽度不变。

trigger(“reloadGrid”)

none

none

按当前设置重新加载网格。若 datatype 为 xml 或 json ，将从服务器重新请求数据。此方法适用于一个已建立的网格。注意不会改变表头，也就是说改变 colModel 将没有作用。你可用 gridUnload ，使用新 colModel 来重新加载。

updateColumns

none

none

在 拖拽表格时， 同步网格宽度。用法：

var mygrid=jQuery(”#grid_id”)[0];

mygrid.updateColumns();