全称 mx.datacontrols.LockHeaderGridItem
命名空间 mx.datacontrols
LockHeaderGridItem
继承层次结构 LockHeaderGridItemDataGridItem
源文件 ~\mx\scripts\datacontrols\LockHeaderGrid.js
提供一个数据项列表控件(LockHeaderGrid 类型)中的数据项的类。该数据项容器的 HTML 元素为 <TR>

构造函数

名称 说明
LockHeaderGridItem() 构建 LockHeaderGridItem 类的新实例。

初始化函数

名称 说明
init()

方法

名称 说明
changeValues(p_changeValues) 更新指定的列的值。
getIndex() 返回该数据项在 DataGridDataGrid.items 集合中的序号(0 代表第一个)。如果该对象的 owner 字段为空,则返回 -1。
getValue(p_index) 返回指定列序号或列名对应的数据项的值。
insertCell(p_column)
markError(p_colName, p_value, p_msg) 提供一个方法,给指定单元格上标记错误。
moveDown() 将当前数据项向下移动一格。如果是最后一个数据项则位置不变。
moveTo(p_index) 将当前节点移动到指定的位置。
moveUp() 将当前数据项向上移动一格。如果是第一个数据项则位置不变。
refresh() 更新当前项所有字段的显示值。
remove() 请参见 DataGrid.removeItem 方法。该方法仅当 owner 字段不为空时有效。
select([p_triggerEvent]) 请参见 DataGrid.selectItem 方法。
setChecked(p_checked) 设置 checked 字段的值。
setEnabled(p_enabled) 设置DataGridItem是否可编辑 p_enabled 一个布尔值,true代表可以编辑,false代表不可编辑
setImageKey([p_imageKey]) 设置 imageKey 字段的值。该方法会在 $/icons 目录中查找相应的 png 图片。
setImageUrl([p_imageUrl]) 设置 imageUrl 字段的值。
setItemType(p_type) 设置 itemType 字段的值。
setRowNumber(p_rownumber)
setValue(p_index, p_value) 设置指定列序号或列名对应的数据项的值。
setValues(p_values) 设置 values 字段的值。
toggleChecked() 切换选中状态。
_initCheckBoxCell() 受保护的。初始化复选框单元格,如果复选框单元格已经存在了,就不重复添加 此方法为内部方法,在表格中调用。
_initRowNumberCell() 受保护的。初始化行号单元格,如果行号单元格已经存在了,就不重复添加 此方法为内部方法,在表格中调用。 此方法在成功添加单元格后会返回true,其它情况返回false;

字段

名称 说明
checked 获取一个 Boolean 值,表示数据项是否选中。
enabled 获取一个 布尔值,表示数据项是否可编辑。
id 获取 DataGridItem 的唯一标识。该字段的值是与 DataGrid.primaryKey 字段的值有关。
imageKey 获取一个字符串,表示 DataGridItem 图像的名称。请使用 setImageKey 方法设置该字段的值。
imageUrl 获取一个字符串,表示 DataGridItem 图像的 URL(如“$/icons/save.png”)。请使用 setImageUrl 方法设置该字段的值。
itemType 获取一个字符串,表示说明数据项的类型(如“folder”,“role”,“job”等)。该属性的值如果与 DataGrid.images 集合中的索引值相同,则会显示对应的图片。 请使用 setItemType 方法设置该字段的值。
owner 获取该对象的父容器的对象,通常是一个 DataGrid 类的实例。
values 获取一个 JSON 对象,表示数据项的所有的值。请使用 setValues 方法设置该字段的值。
$e 获取数据项(DataGridItem 类型)容器的 JQuery 对象。数据项容器的 HTML DOM 元素为“tr”。

构造函数详细信息

LockHeaderGridItem() 方法

构建 LockHeaderGridItem 类的新实例。

初始化函数详细信息

init() 方法


方法详细信息

changeValues(p_changeValues) 方法

更新指定的列的值。

参数

  • p_changeValues
    一个 JSON 对象(如{ name: "bruce", age: "25" }),表示需要修改的列的值。

继承自


getIndex() 方法

返回该数据项在 DataGridDataGrid.items 集合中的序号(0 代表第一个)。如果该对象的 owner 字段为空,则返回 -1。

继承自


getValue(p_index) 方法

返回指定列序号或列名对应的数据项的值。

参数

  • p_index
    一个数字(如 0),表示列的序号;或一个字符串,表示列的名称(DataGridColumn.name 字段的值)。

继承自


insertCell(p_column) 方法

参数

  • p_column

继承自


markError(p_colName, p_value, p_msg) 方法

提供一个方法,给指定单元格上标记错误。

参数

  • p_colName
    一个字符串,表示单元格所在列的列标题。
  • p_value
    一个 Boolean 值,true 时标记错误,false 时取消标记。
  • p_msg
    一个字符串,表示提示信息,p_value 为 false 时,可以不传值。

继承自


moveDown() 方法

将当前数据项向下移动一格。如果是最后一个数据项则位置不变。

继承自


moveTo(p_index) 方法

将当前节点移动到指定的位置。

参数

  • p_index
    一个 Number 值,表示节点的索引(0 表示第一个节点)。

继承自


moveUp() 方法

将当前数据项向上移动一格。如果是第一个数据项则位置不变。

继承自


refresh() 方法

更新当前项所有字段的显示值。

继承自


remove() 方法

请参见 DataGrid.removeItem 方法。该方法仅当 owner 字段不为空时有效。

继承自


select([p_triggerEvent]) 方法

请参见 DataGrid.selectItem 方法。

参数

  • p_triggerEvent
    可选的。默认值为“null”。一个 Boolean 值,表示是否要触发 DataGrid.onselectionchanged 事件。如果该值为 true,则触发事件;反之则不触发。

继承自


setChecked(p_checked) 方法

设置 checked 字段的值。

参数

  • p_checked
    一个 Boolean 表示是否选中。

继承自


setEnabled(p_enabled) 方法

设置DataGridItem是否可编辑 p_enabled 一个布尔值,true代表可以编辑,false代表不可编辑

参数

  • p_enabled

继承自


setImageKey([p_imageKey]) 方法

设置 imageKey 字段的值。该方法会在 $/icons 目录中查找相应的 png 图片。

参数

  • p_imageKey
    可选的。一个字符串,表示图片的名称。如 $/icons 目录中有一张图片为“role_48.png”或“role.png”的图片,那么该参数都是“role”。

继承自


setImageUrl([p_imageUrl]) 方法

设置 imageUrl 字段的值。

参数

  • p_imageUrl
    可选的。默认值为“$/images/space.png”。一个字符串,表示图像的 URL。

继承自


setItemType(p_type) 方法

设置 itemType 字段的值。

参数

  • p_type
    一个字符串,表示说明数据项的类型(如“folder”,“role”,“job”等)。

继承自


setRowNumber(p_rownumber) 方法

参数

  • p_rownumber

继承自


setValue(p_index, p_value) 方法

设置指定列序号或列名对应的数据项的值。

参数

  • p_index
    一个数字(如 0)或者列名。
  • p_value
    一个字符串,表示数据项的值。

继承自


setValues(p_values) 方法

设置 values 字段的值。

参数

  • p_values
    一个 JSON 对象,表示数据项的数据值。

继承自


toggleChecked() 方法

切换选中状态。

继承自


_initCheckBoxCell() 方法

受保护的。初始化复选框单元格,如果复选框单元格已经存在了,就不重复添加 此方法为内部方法,在表格中调用。

继承自


_initRowNumberCell() 方法

受保护的。初始化行号单元格,如果行号单元格已经存在了,就不重复添加 此方法为内部方法,在表格中调用。 此方法在成功添加单元格后会返回true,其它情况返回false;

继承自


字段详细信息

checked 字段

获取一个 Boolean 值,表示数据项是否选中。

继承自

默认值

false

enabled 字段

获取一个 布尔值,表示数据项是否可编辑。

继承自


id 字段

获取 DataGridItem 的唯一标识。该字段的值是与 DataGrid.primaryKey 字段的值有关。

继承自


imageKey 字段

获取一个字符串,表示 DataGridItem 图像的名称。请使用 setImageKey 方法设置该字段的值。

继承自


imageUrl 字段

获取一个字符串,表示 DataGridItem 图像的 URL(如“$/icons/save.png”)。请使用 setImageUrl 方法设置该字段的值。

继承自


itemType 字段

获取一个字符串,表示说明数据项的类型(如“folder”,“role”,“job”等)。该属性的值如果与 DataGrid.images 集合中的索引值相同,则会显示对应的图片。 请使用 setItemType 方法设置该字段的值。

继承自

默认值

item

owner 字段

获取该对象的父容器的对象,通常是一个 DataGrid 类的实例。

继承自


values 字段

获取一个 JSON 对象,表示数据项的所有的值。请使用 setValues 方法设置该字段的值。

继承自


$e 字段

获取数据项(DataGridItem 类型)容器的 JQuery 对象。数据项容器的 HTML DOM 元素为“tr”。

继承自