DataGrid 类（仅限 Flash Professional）

继承 MovieClip > UIObject 类 > UIComponent 类 > View > ScrollView > ScrollSelectList > List 组件 > DataGrid

ActionScript 类名称 mx.controls.DataGrid

每个组件类都有一个 version 属性，而该属性是一个类属性。类属性只能用于该类本身。version 属性会返回一个字符串，该字符串指示组件的版本。若要访问此属性，请使用以下代码：

trace(mx.controls.DataGrid.version);

注意

代码 trace(myDataGridInstance.version); 返回 undefined。

DataGrid 类的方法摘要

下表列出了 DataGrid 类的方法。

方法	说明
DataGrid.addColumn()	将列添加到数据网格。
DataGrid.addColumnAt()	将列添加到数据网格的指定位置。
DataGrid.addItem()	将项目添加到数据网格。
DataGrid.addItemAt()	将项目添加到数据网格的指定位置。
DataGrid.editField()	替换位于指定位置的单元格数据。
DataGrid.getColumnAt()	获取对位于指定位置的列的引用。
DataGrid.getColumnIndex()	获取对位于指定索引的 DataGridColumn 对象的引用。
DataGrid.removeAllColumns()	从数据网格中删除所有列。
DataGrid.removeColumnAt()	从数据网格的指定位置删除列。
DataGrid.replaceItemAt()	使用另一项目替换位于指定位置的项目。
DataGrid.spaceColumnsEqually()	平均间隔所有列。

从 UIObject 类继承的方法

下表列出了 DataGrid 类从 UIObject 类继承的方法。调用这些方法时，请使用 dataGridInstance.methodName 的形式。

方法	说明
UIObject.createClassObject()	创建指定类的对象。
UIObject.createObject()	创建对象的子对象。
UIObject.destroyObject()	破坏组件实例。
UIObject.doLater()	在"属性"检查器和"组件"检查器中设置了参数之后，调用一个函数。
UIObject.getStyle()	从样式声明或对象获取样式属性。
UIObject.invalidate()	标记对象使其在到达下一个帧间隔时进行重绘。
UIObject.move()	将对象移动到要求的位置。
UIObject.redraw()	迫使对象有效以便能在当前帧中绘制。
UIObject.setSize()	将对象调整为所要求的大小。
UIObject.setSkin()	设置对象的外观。
UIObject.setStyle()	设置样式声明或对象的样式属性。

从 UIComponent 类继承的方法

下表列出了 DataGrid 类从 UIComponent 类继承的方法。调用这些方法时，请使用 dataGridInstance.methodName 的形式。

方法	说明
UIComponent.getFocus()	返回对具有焦点的对象的引用。
UIComponent.setFocus()	将焦点设置到组件实例中。

从 List 类继承的方法

下表列出了 DataGrid 类从 List 类继承的方法。调用这些方法时，请使用 dataGridInstance.methodName 的形式。

方法	说明
List.addItem()	向列表的结尾添加项目。
List.addItemAt()	将项目添加到指定索引处的列表。
List.getItemAt()	返回指定索引处的项目。
List.removeAll()	删除列表中的所有项目。
List.removeItemAt()	删除指定索引处的项目。
List.replaceItemAt()	用其它项目替换指定索引处的项目。
List.setPropertiesAt()	将指定的属性应用到指定的项目。
List.sortItems()	按照指定的比较函数对列表中的项目进行排序。
List.sortItemsBy()	按照指定的属性对列表中的项目进行排序。

DataGrid 类的属性摘要

下表列出了 DataGrid 类的属性。

属性	说明
DataGrid.columnCount	只读；显示的列的数目。
DataGrid.columnNames	显示为列的每个项目内的字段名数组。
DataGrid.dataProvider	数据网格的数据模型。
DataGrid.editable	一个布尔值，指示数据网格是 (`true`) 否 (`false`) 可编辑。
DataGrid.focusedCell	定义具有焦点的单元格。
DataGrid.headerHeight	列标题的高度（以像素为单位）。
DataGrid.hScrollPolicy	指示是显示 (`"on"`)、不显示 (`"off"`) 还是在必要时显示 (`"auto"`) 水平滚动条。
DataGrid.resizableColumns	一个布尔值，它指示列是 (`true`) 否 (`false`) 可以调整大小。
DataGrid.selectable	一个布尔值，它指示数据网格是 (`true`) 否 (`false`) 可选择。
DataGrid.showHeaders	一个布尔值，它指示列标题是 (`true`) 否 (`false`) 可见。
DataGrid.sortableColumns	一个布尔值，它指示列是 (`true`) 否 (`false`) 可排序。

从 UIObject 类继承的属性

下表列出了 DataGrid 类从 UIObject 类继承的属性。从 DataGrid 对象访问这些属性时，请使用 dataGridInstance.propertyName 的形式。

属性	说明
UIObject.bottom	对象的底边缘位置（相对于其父对象的底边缘）。只读。
UIObject.height	对象的高度（以像素为单位）。只读。
UIObject.left	对象的左边缘（以像素为单位）。只读。
UIObject.right	对象的右边缘位置（相对于其父对象的右边缘）。只读。
UIObject.scaleX	一个数字，它指示对象相对于其父对象在 x 方向上的缩放因子。
UIObject.scaleY	一个数字，它指示对象相对于其父对象在 y 方向上的缩放因子。
UIObject.top	对象上边缘的位置（相对于其父对象）。只读。
UIObject.visible	一个布尔值，它指示对象是可见的 (`true`) 还是不可见的 (`false`)。
UIObject.width	对象的宽度（以像素为单位）。只读。
UIObject.x	对象的左边缘（以像素为单位）。只读。
UIObject.y	对象的上边缘（以像素为单位）。只读。

从 UIComponent 类继承的属性

下表列出了 DataGrid 类从 UIComponent 类继承的属性。从 DataGrid 对象访问这些属性时，请使用 dataGridInstance.propertyName 的形式。

属性	说明
UIComponent.enabled	指明组件是否可以接收焦点和输入。
UIComponent.tabIndex	一个数字，指明文档中组件的 Tab 键顺序。

从 List 类继承的属性

下表列出了 DataGrid 类从 List 类继承的属性。从 DataGrid 对象访问这些属性时，请使用 dataGridInstance.propertyName 的形式。

属性	说明
List.cellRenderer	指定要使用的类或元件以显示列表的每一行。
List.dataProvider	列表项目的来源。
List.hPosition	列表的水平位置。
List.hScrollPolicy	指示是 (`"on"`) 否 (`"off"`) 显示水平滚动条。
List.iconField	各项目中用于指定图标的字段。
List.iconFunction	一个函数，它确定要使用的图标。
List.labelField	指定各项目中用作标签文本的字段。
List.labelFunction	一个函数，它确定各个项目的哪些字段要用作标签文本。
List.length	列表中的项目数。该属性为只读。
List.maxHPosition	当将 List.hScrollPolicy 设置为 `"on"` 时，指定列表可以向右滚动的像素数目。
List.multipleSelection	指示列表中是 (`true`) 否 (`false`) 允许多选。
List.rowCount	列表中至少可以看到一部分的行数。
List.rowHeight	列表中每行的像素高度。
List.selectable	指示列表是 (`true`) 否 (`false`) 为可选择列表。
List.selectedIndex	单选列表中的选择索引。
List.selectedIndices	多选列表中的已选择项目的数组。
List.selectedItem	单选列表中的已选择项目。该属性为只读。
List.selectedItems	多选列表中的已选择的项目对象。该属性为只读。
List.vPosition	滚动列表，以便使最顶部可见的项目为指定的数。
List.vScrollPolicy	指示是显示 (`"on"`)、不显示 (`"off"`) 还是在需要时显示 (`"auto"`) 垂直滚动条。

DataGrid 类的事件摘要

下表列出了 DataGrid 类的事件。

事件	说明
DataGrid.cellEdit	在单元格值更改时广播。
DataGrid.cellFocusIn	在单元格获得焦点时广播。
DataGrid.cellFocusOut	在单元格失去焦点时广播。
DataGrid.cellPress	在单元格被按下（单击）时广播。
DataGrid.change	在选中项目时广播。
DataGrid.columnStretch	当用户在水平方向调整列的大小时广播。
DataGrid.headerRelease	在用户按下(或松开）标题时广播。

从 UIObject 类继承的事件

下表列出了 DataGrid 类从 UIObject 类继承的事件。

事件	说明
UIObject.draw	当对象将要绘制它的图形时进行广播。
UIObject.hide	在对象的状态从可见变为不可见时广播。
UIObject.load	创建子对象时广播。
UIObject.move	移动了对象时广播。
UIObject.resize	在调整对象大小后广播。
UIObject.reveal	在对象的状态从不可见变为可见时广播。
UIObject.unload	卸载子对象时广播。

从 UIComponent 类继承的事件

下表列出了 DataGrid 类从 UIComponent 类继承的事件。

事件	说明
UIComponent.focusIn	当对象收到焦点时进行广播。
UIComponent.focusOut	当对象失去焦点时进行广播。
UIComponent.keyDown	当按下按键时进行广播。
UIComponent.keyUp	当松开按键时进行广播。

从 List 类继承的事件

下表列出了 DataGrid 类从 List 类继承的事件。

事件	说明
List.change	只要用户交互造成选择更改就广播。
List.itemRollOut	鼠标指针在列表项上滑过然后又滑离时广播。
List.itemRollOver	当鼠标指针滑过列表项时进行广播。
List.scroll	滚动列表时，进行广播。

it168学院频道