mx.events.DataGridEvent (Flex 3.2)

	属性	定义方
		bubbles : Boolean [只读 (read-only)] 指示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读 (read-only)] 指示是否可以阻止与事件相关联的行为。	Event
		columnIndex : int 与事件关联的列在 DataGrid 对象的 columns 数组中从零开始的索引。	DataGridEvent
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读 (read-only)] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		dataField : String 与列关联的数据中的字段或属性的名称。	DataGridEvent
		eventPhase : uint [只读 (read-only)] 事件流中的当前阶段。	Event
		itemRenderer : IListItemRenderer 用于正在进行编辑的项目的项目渲染器，或者正在单击或拉伸的标题渲染器。	DataGridEvent
		localX : Number 列的 x 位置；用于重播列拉伸事件。	DataGridEvent
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		reason : String 调度 itemEditEnd 事件的原因。	DataGridEvent
		rowIndex : int 数据提供者中项目的索引（从零开始）。	DataGridEvent
		target : Object [只读 (read-only)] 事件目标。	Event
		type : String [只读 (read-only)] 事件的类型。	Event

	方法	定义方
		DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, dataField:String = null, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null, localX:Number = NaN) 构造函数。	DataGridEvent
		clone():Event 复制 Event 子类的实例。	Event
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toString():String 返回一个字符串，其中包含 Event 对象的所有属性。	Event
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

	常量		定义方
		ACTIVATE : String = "activate" [静态] ACTIVATE 常量定义 activate 事件对象的 type 属性的值。	Event
		ADDED : String = "added" [静态] Event.ADDED 常量定义 added 事件对象的 type 属性值。	Event
		ADDED_TO_STAGE : String = "addedToStage" [静态] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。	Event
		CANCEL : String = "cancel" [静态] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。	Event
		CHANGE : String = "change" [静态] Event.CHANGE 常量定义 change 事件对象的 type 属性值。	Event
		CLEAR : String = "clear" [静态] Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。	Event
		CLOSE : String = "close" [静态] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。	Event
		CLOSING : String = "closing" [静态] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。	Event
		COLUMN_STRETCH : String = "columnStretch" [静态] DataGridEvent.COLUMN_STRETCH 常数可为 columnStretch 事件定义事件对象的 type 属性的值，指示用户已将列水平展开。	DataGridEvent
		COMPLETE : String = "complete" [静态] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。	Event
		CONNECT : String = "connect" [静态] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。	Event
		COPY : String = "copy" [静态] 定义 copy 事件对象的 type 属性值。	Event
		CUT : String = "cut" [静态] 定义 cut 事件对象的 type 属性值。	Event
		DEACTIVATE : String = "deactivate" [静态] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。	Event
		DISPLAYING : String = "displaying" [静态] Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。	Event
		ENTER_FRAME : String = "enterFrame" [静态] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。	Event
		EXIT_FRAME : String = "exitFrame" [静态] Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。	Event
		EXITING : String = "exiting" [静态] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。	Event
		FRAME_CONSTRUCTED : String = "frameConstructed" [静态] Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。	Event
		FULLSCREEN : String = "fullScreen" [静态] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。	Event
		HEADER_RELEASE : String = "headerRelease" [静态] DataGridEvent.HEADER_RELEASE 常数可为 headerRelease 事件定义事件对象的 type 属性值，指示用户已在列标题上按下和释放鼠标。	DataGridEvent
		HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [静态] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。	Event
		HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [静态] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。	Event
		HTML_RENDER : String = "htmlRender" [静态] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。	Event
		ID3 : String = "id3" [静态] Event.ID3 常量定义 id3 事件对象的 type 属性值。	Event
		INIT : String = "init" [静态] Event.INIT 常量定义 init 事件对象的 type 属性值。	Event
		ITEM_EDIT_BEGIN : String = "itemEditBegin" [静态] DataGridEvent.ITEM_EDIT_BEGIN 常数可为 itemEditBegin 事件定义事件对象的 type 属性的值，指示项目可进行编辑。	DataGridEvent
		ITEM_EDIT_BEGINNING : String = "itemEditBeginning" [静态] DataGridEvent.ITEM__EDIT_BEGINNING 常数可为 itemEditBeginning 事件定义事件对象的 type 属性的值，指示用户已准备编辑项目，例如通过在项目上释放鼠标按键。	DataGridEvent
		ITEM_EDIT_END : String = "itemEditEnd" [静态] DataGridEvent.ITEM_EDIT_END 常数可为 itemEditEnd 事件定义事件对象的 type 属性的值，指示编辑会话结束。	DataGridEvent
		ITEM_FOCUS_IN : String = "itemFocusIn" [静态] DataGridEvent.ITEM_FOCUS_IN 常数可为 itemFocusIn 事件定义事件对象的 type 属性的值，指示项目已获得焦点。	DataGridEvent
		ITEM_FOCUS_OUT : String = "itemFocusOut" [静态] DataGridEvent.ITEM_FOCUS_OUT 常数可为 itemFocusOut 事件定义事件对象的 type 属性的值，指示项目已失去焦点。	DataGridEvent
		LOCATION_CHANGE : String = "locationChange" [静态] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。	Event
		MOUSE_LEAVE : String = "mouseLeave" [静态] Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。	Event
		NETWORK_CHANGE : String = "networkChange" [静态] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。	Event
		OPEN : String = "open" [静态] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。	Event
		PASTE : String = "paste" [静态] Event.PASTE 常量定义 paste 事件对象的 type 属性的值。	Event
		REMOVED : String = "removed" [静态] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [静态] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。	Event
		RENDER : String = "render" [静态] Event.RENDER 常量定义 render 事件对象的 type 属性的值。	Event
		RESIZE : String = "resize" [静态] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。	Event
		SCROLL : String = "scroll" [静态] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。	Event
		SELECT : String = "select" [静态] Event.SELECT 常量定义 select 事件对象的 type 属性的值。	Event
		SELECT_ALL : String = "selectAll" [静态] Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。	Event
		SOUND_COMPLETE : String = "soundComplete" [静态] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。	Event
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [静态] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [静态] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [静态] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。	Event
		UNLOAD : String = "unload" [静态] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。	Event
		USER_IDLE : String = "userIdle" [静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。	Event
		USER_PRESENT : String = "userPresent" [静态] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。	Event

属性详细信息

columnIndex

属性

public var columnIndex:int

与事件关联的列在 DataGrid 对象的 columns 数组中从零开始的索引。

dataField

属性

public var dataField:String

与列关联的数据中的字段或属性的名称。

itemRenderer

属性

public var itemRenderer:IListItemRenderer

用于正在进行编辑的项目的项目渲染器，或者正在单击或拉伸的标题渲染器。您可以使用此属性访问数据提供程序。

localX

属性

public var localX:Number

列的 x 位置；用于重播列拉伸事件。

reason

属性

public var reason:String

调度 itemEditEnd 事件的原因。仅对类型为 ITEM_EDIT_END 的事件有效。DataGridEventReason 类中定义的可能值。

另请参见

DataGridEventReason

rowIndex

属性

public var rowIndex:int

数据提供者中项目的索引（从零开始）。

构造函数详细信息

DataGridEvent

()

构造函数

public function DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, dataField:String = null, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null, localX:Number = NaN)

构造函数。通常由 DataGrid 对象调用；不用于应用程序代码。

参数

	`type:String` — 事件类型；指示引发事件的动作。

	`bubbles:Boolean` (default = `false`) — 指定该事件是否可以在显示列表层次结构得到冒泡处理。

	`cancelable:Boolean` (default = `false`) — 指定是否可以防止与事件相关联的行为。

	`columnIndex:int` (default = `-1`) — 发生事件的列的索引（从零开始）。

	`dataField:String` (default = `null`) — 与列关联的数据中的字段或属性的名称。

	`rowIndex:int` (default = `-1`) — 数据提供程序中项目的索引（从零开始）。

	`reason:String` (default = `null`) — 发生 `itemEditEnd` 事件的原因。

	`itemRenderer:IListItemRenderer` (default = `null`) — 所编辑的项目渲染器或被单击的标题渲染器。

	`localX:Number` (default = `NaN`) — 用于重放 `columnStretch` 事件的列 x 位置。

常量详细信息

COLUMN_STRETCH

常量

public static const COLUMN_STRETCH:String = "columnStretch"

DataGridEvent.COLUMN_STRETCH 常数可为 columnStretch 事件定义事件对象的 type 属性的值，指示用户已将列水平展开。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	DataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	与列关联的数据中的字段或属性的名称。
`itemRenderer`	null
`localX`	鼠标的 X 位置
`reason`	null
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	DataGridEvent.COLUMN_STRETCH

HEADER_RELEASE

常量

public static const HEADER_RELEASE:String = "headerRelease"

DataGridEvent.HEADER_RELEASE 常数可为 headerRelease 事件定义事件对象的 type 属性值，指示用户已在列标题上按下和释放鼠标。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	DataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	与列关联的数据中的字段或属性的名称。
`itemRenderer`	要释放的标题渲染器。
`localX`	NaN
`reason`	null
`rowIndex`	null
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	DataGridEvent.HEADER_RELEASE

ITEM_EDIT_BEGIN

常量

public static const ITEM_EDIT_BEGIN:String = "itemEditBegin"

DataGridEvent.ITEM_EDIT_BEGIN 常数可为 itemEditBegin 事件定义事件对象的 type 属性的值，指示项目可进行编辑。

此事件的默认侦听器执行下列操作：

通过调用 createItemEditor() 方法创建项目编辑器对象。
将 data 属性从项目复制到编辑器。默认情况下，项目编辑器对象是 TextInput 控件的实例。您可以使用 list 控件的 itemEditor 属性指定自定义项目编辑器类。
设置 list 控件的 itemEditorInstance 属性，以引用项目编辑器实例。

您可以为此事件编写事件侦听器以修改传递到项目编辑器的数据。例如，您可以修改项目编辑器使用的数据、数据格式或其它信息。

您还可以创建事件侦听器以指定用于编辑项目的项目编辑器。例如，您可能有两个不同的项目编辑器。在事件侦听器中，您可以通过执行下列操作检查要编辑的数据或其它信息，并打开相应的项目编辑器：

调用 preventDefault() 以阻止 Flex 在默认事件侦听器中调用 createItemEditor() 方法。
将 itemEditor 属性设置为相应编辑器。
调用 createItemEditor() 方法。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	DataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	null
`itemRenderer`	所编辑的项目的项目渲染器。
`localX`	NaN
`reason`	null
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	DataGridEvent.ITEM_EDIT_BEGIN

ITEM_EDIT_BEGINNING

常量

public static const ITEM_EDIT_BEGINNING:String = "itemEditBeginning"

DataGridEvent.ITEM__EDIT_BEGINNING 常数可为 itemEditBeginning 事件定义事件对象的 type 属性的值，指示用户已准备编辑项目，例如通过在项目上释放鼠标按键。

此事件的默认侦听器将 DataGrid.editedItemPosition 属性设置为具有焦点的项目，该项目开始项目编辑会话。

您通常可以为此事件编写自己的事件侦听器，以禁止编辑特定项目。在为此事件自己编写的事件侦听器内调用 preventDefault() 方法可以阻止默认侦听器执行。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	DataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	与项目的列关联的数据中的字段或属性的名称。
`itemRenderer`	要编辑的项目的项目渲染器。如果此事件由键盘生成，则此属性为 null，因为要编辑的项目可能未在屏幕范围内显示。
`localX`	NaN
`reason`	null
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	DataGridEvent.ITEM_EDIT_BEGINNING

ITEM_EDIT_END

常量

public static const ITEM_EDIT_END:String = "itemEditEnd"

DataGridEvent.ITEM_EDIT_END 常数可为 itemEditEnd 事件定义事件对象的 type 属性的值，指示编辑会话结束。

列表组件具有针对此事件的默认处理函数，此程序将数据从项目编辑器复制到 list 控件的数据提供程序。默认事件侦听器执行下列操作：

使用与此事件相关联的 DataGridColumn 的 editorDataField 属性确定包含新数据的项目编辑器的属性，并使用这些新数据更新数据提供程序项目。因为默认项目编辑器是 TextInput 控件，所以 editorDataField 属性的默认值为 "text"，以指定 TextInput 的 text 属性包含新项目数据。
调用 destroyItemEditor() 方法以关闭项目编辑器。

通常，您可以为此事件编写事件侦听器，以执行下列操作：

在事件侦听器中，您可以修改编辑器为列表组件返回的数据。例如，您可以在将数据返回到 list 控件之前重新设置其格式。默认情况下，项目编辑器只可以返回一个值。如果希望返回多个值，必须为 itemEditEnd 事件编写事件侦听器。
在事件侦听器中，您可以检查项目编辑器中输入的数据。如果数据不正确，可以调用 preventDefault() 方法阻止 Flex 将新数据传递回 list 控件和关闭编辑器。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	DataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	与项目的列关联的数据中的字段或属性的名称。
`itemRenderer`	所编辑的项目的项目渲染器。
`localX`	NaN
`reason`	定义事件原因的常量。该值必须是 `DataGridEventReason` 类的成员。
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	DataGridEvent.ITEM_EDIT_END

ITEM_FOCUS_IN

常量

public static const ITEM_FOCUS_IN:String = "itemFocusIn"

DataGridEvent.ITEM_FOCUS_IN 常数可为 itemFocusIn 事件定义事件对象的 type 属性的值，指示项目已获得焦点。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	DataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	null
`itemRenderer`	所编辑的项目的项目编辑器实例。
`localX`	NaN
`reason`	null
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	DataGridEvent.ITEM_FOCUS_IN

ITEM_FOCUS_OUT

常量

public static const ITEM_FOCUS_OUT:String = "itemFocusOut"

DataGridEvent.ITEM_FOCUS_OUT 常数可为 itemFocusOut 事件定义事件对象的 type 属性的值，指示项目已失去焦点。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	DataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	null
`itemRenderer`	所编辑的项目的项目编辑器实例。
`localX`	NaN
`reason`	null
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	DataGridEvent.ITEM_FOCUS_OUT

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
DataGridEvent	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例

包	mx.events
类	public class DataGridEvent
继承	DataGridEvent Event Object