AdvancedDataGridEvent

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

AdvancedDataGridEvent 类表示特定于 AdvancedDataGrid 控件的事件对象，例如可编辑网格项获得焦点时调度的事件。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		animate : Boolean 如果为 true，则使打开或关闭操作具有动画效果；仅用于 ITEM_OPENING 类型事件。	AdvancedDataGridEvent
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		column : AdvancedDataGridColumn 导致此事件的列的 AdvancedDataGridColumnGroup 实例。	AdvancedDataGridEvent
		columnIndex : int AdvancedDataGrid 对象的与此事件相关联的列的 columns Array 中的从零开始的索引。	AdvancedDataGridEvent
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		dataField : String 与列关联的数据中的字段或属性的名称。	AdvancedDataGridEvent
		dispatchEvent : Boolean 是否在完成打开或关闭动画之后调度 ITEM_OPEN 或 ITEM_CLOSE 事件。	AdvancedDataGridEvent
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		headerPart : String 如果单击了标题中的 HEADER_RELEASE 事件。	AdvancedDataGridEvent
		item : Object 存储 node 属性。	AdvancedDataGridEvent
		itemRenderer : IListItemRenderer 正在编辑的项目的项呈示器，或者正在单击或拉伸的标题呈示器。	AdvancedDataGridEvent
		localX : Number 列的 x 位置（以像素为单位）；用于重放列拉伸事件。	AdvancedDataGridEvent
		multiColumnSort : Boolean 如果为 true，则指示无论已使用的是何种排序方式，新的 dataField 属性应该同已使用的排序方式一起使用，从而进行多列排序。	AdvancedDataGridEvent
		opening : Boolean 指示项目处于打开状态 (true) 还是关闭状态 (false)。	AdvancedDataGridEvent
		reason : String 调度 itemEditEnd 事件的原因。	AdvancedDataGridEvent
		removeColumnFromSort : Boolean 如果为 true，则从多列排序中删除列。	AdvancedDataGridEvent
		rowIndex : int 数据提供者中项目的索引（从零开始）。	AdvancedDataGridEvent
		target : Object [只读] 事件目标。	Event
		triggerEvent : Event 触发此事件的事件的 MouseEvent 或 KeyboardEvent 对象；如果此事件以编程方式触发，则为 null。	AdvancedDataGridEvent
		type : String [只读] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		AdvancedDataGridEvent(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, multiColumnSort:Boolean = false, removeColumnFromSort:Boolean = false, item:Object = null, triggerEvent:Event = null, headerPart:String = null) 构造函数。	AdvancedDataGridEvent
		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
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回一个字符串，其中包含 Event 对象的所有属性。	Event
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		COLUMN_STRETCH : String = "columnStretch" [静态] AdvancedDataGridEvent.COLUMN_STRETCH 常量可为 columnStretch 事件定义事件对象的 type 属性的值，指示用户已将列水平展开。	AdvancedDataGridEvent
		HEADER_DRAG_OUTSIDE : String = "headerDragOutside" [静态] AdvancedDataGridEvent.HEADER_DRAG_OUTSIDE 常量可为 headerDragOutside 事件定义事件对象的 type 属性的值，指示用户已在列标题上按下和释放鼠标。	AdvancedDataGridEvent
		HEADER_DROP_OUTSIDE : String = "headerDropOutside" [静态] AdvancedDataGridEvent.HEADER_DROP_OUTSIDE 常量可为 headerDropOutside 事件定义事件对象的 type 属性的值。	AdvancedDataGridEvent
		HEADER_RELEASE : String = "headerRelease" [静态] AdvancedDataGridEvent.HEADER_RELEASE 常量定义 headerRelease 事件的事件对象的 type 属性值，用于指示用户在列标题上按下和释放鼠标。	AdvancedDataGridEvent
		ITEM_CLOSE : String = "itemClose" [静态] AdvancedDataGridEvent.ITEM_CLOSE 事件类型常量指示 AdvancedDataGrid 分支已关闭或已折叠。	AdvancedDataGridEvent
		ITEM_EDIT_BEGIN : String = "itemEditBegin" [静态] AdvancedDataGridEvent.ITEM_EDIT_BEGIN 常量可为 itemEditBegin 事件定义事件对象的 type 属性的值，指示项目已准备就绪，可进行编辑。	AdvancedDataGridEvent
		ITEM_EDIT_BEGINNING : String = "itemEditBeginning" [静态] AdvancedDataGridEvent.ITEM__EDIT_BEGINNING 常量可为 itemEditBeginning 事件定义事件对象的 type 属性的值，指示用户已准备好编辑项目，例如，通过在项目上释放鼠标按键。	AdvancedDataGridEvent
		ITEM_EDIT_END : String = "itemEditEnd" [静态] AdvancedDataGridEvent.ITEM_EDIT_END 常量可为 itemEditEnd 事件定义事件对象的 type 属性的值，指示编辑会话结束。	AdvancedDataGridEvent
		ITEM_FOCUS_IN : String = "itemFocusIn" [静态] AdvancedDataGridEvent.ITEM_FOCUS_IN 常量可为 itemFocusIn 事件定义事件对象的 type 属性的值，指示项目已获得焦点。	AdvancedDataGridEvent
		ITEM_FOCUS_OUT : String = "itemFocusOut" [静态] AdvancedDataGridEvent.ITEM_FOCUS_OUT 常量可为 itemFocusOut 事件定义事件对象的 type 属性的值，指示项目已失去焦点。	AdvancedDataGridEvent
		ITEM_OPEN : String = "itemOpen" [静态] AdvancedDataGridEvent.ITEM_OPEN 事件类型常量指示 AdvancedDataGrid 分支已打开或已展开。	AdvancedDataGridEvent
		ITEM_OPENING : String = "itemOpening" [静态] 在 AdvancedDataGrid 打开或关闭之前立即调度 AdvancedDataGridEvent.ITEM_OPENING 事件类型常量。	AdvancedDataGridEvent
		SORT : String = "sort" [静态] AdvancedDataGridEvent.SORT 常量可为 sort 事件定义事件对象的 type 属性的值。	AdvancedDataGridEvent

属性详细信息

animate

属性

public var animate:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果为 true，则使打开或关闭操作具有动画效果；仅用于 ITEM_OPENING 类型事件。

column

属性

public var column:AdvancedDataGridColumn

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

导致此事件的列的 AdvancedDataGridColumnGroup 实例。

columnIndex

属性

public var columnIndex:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

AdvancedDataGrid 对象的与此事件相关联的列的 columns Array 的从零开始的索引。

dataField

属性

public var dataField:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

dispatchEvent

属性

public var dispatchEvent:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

打开或关闭动画完成后，是否调度 ITEM_OPEN 或 ITEM_CLOSE 事件。仅用于 ITEM_OPENING 事件。

headerPart

属性

public var headerPart:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果单击了标题中的 HEADER_RELEASE 事件。

item

属性

public var item:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

存储 node 属性。如果根据 XML 数据填充 AdvancedDataGrid，请访问 node 属性的 label 和 data 属性，将二者作为 event.node.attributes.label 和 event.node.attributes.data。

itemRenderer

属性

public var itemRenderer:IListItemRenderer

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

localX

属性

public var localX:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

列的 x 位置（以像素为单位）；用于重放列拉伸事件。

multiColumnSort

属性

public var multiColumnSort:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果为 true，则指示无论已使用的是何种排序方式，新的 dataField 属性应该同已使用的排序方式一起使用，从而进行多列排序。

如果为 false，则应该删除任何存在的排序，并对新的 dataField 属性重新进行排序。

opening

属性

public var opening:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指示项目处于打开状态 (true) 还是关闭状态 (false)。仅用于 ITEM_OPENING 类型事件。

reason

属性

public var reason:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调度 itemEditEnd 事件的原因。仅对类型为 ITEM_EDIT_END 的事件有效。这些可能的值是在 AdvancedDataGridEventReason 类中定义的。

removeColumnFromSort

属性

public var removeColumnFromSort:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果为 true，则从多列排序中删除列。

rowIndex

属性

public var rowIndex:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

triggerEvent

属性

public var triggerEvent:Event

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

触发此事件的事件的 MouseEvent 或 KeyboardEvent 对象；如果此事件以编程方式触发，则为 null。

构造函数详细信息

()

构造函数

public function AdvancedDataGridEvent(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, multiColumnSort:Boolean = false, removeColumnFromSort:Boolean = false, item:Object = null, triggerEvent:Event = null, headerPart:String = null)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

参数

	`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 列的位置。

	`multiColumnSort:Boolean` (default = `false`) — 指定一种多列排序。

	`removeColumnFromSort:Boolean` (default = `false`) — 指定从多列排序中移除此列。

	`item:Object` (default = `null`) — 指定 `node` 属性。

	`triggerEvent:Event` (default = `null`) — MouseEvent 或 KeyboardEvent 可触发此事件；如果通过编程方式触发此事件，则返回 `null`。

	`headerPart:String` (default = `null`) — 所单击的标题部件。

常量详细信息

COLUMN_STRETCH

常量

public static const COLUMN_STRETCH:String = "columnStretch"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

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

HEADER_DRAG_OUTSIDE

常量

public static const HEADER_DRAG_OUTSIDE:String = "headerDragOutside"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

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

HEADER_DROP_OUTSIDE

常量

public static const HEADER_DROP_OUTSIDE:String = "headerDropOutside"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

AdvancedDataGridEvent.HEADER_DROP_OUTSIDE 常量可为 headerDropOutside 事件定义事件对象的 type 属性的值。

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

属性	值
`bubbles`	`false`
`cancelable`	`true`
`columnIndex`	AdvancedDataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	与列关联的数据中的字段或属性的名称。
`item`	关闭的 AdvancedDataGrid 项目（节点）。
`itemRenderer`	要释放的标题呈示器。
`localX`	NaN
`multiColumnSort`	`false`
`reason`	null
`removeColumnFromSort`	`false`
`rowIndex`	null
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果节点关闭以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.HEADER_RELEASE

HEADER_RELEASE

常量

public static const HEADER_RELEASE:String = "headerRelease"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

属性	值
`bubbles`	`false`
`cancelable`	`true`
`columnIndex`	AdvancedDataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	与列关联的数据中的字段或属性的名称。
`item`	关闭的 AdvancedDataGrid 项目（节点）。
`itemRenderer`	要释放的标题呈示器。
`localX`	NaN
`multiColumnSort`	`undefined` - 如果希望在多个列上排序，请使用 `sort` 事件。
`reason`	null
`removeColumnFromSort`	`false`
`rowIndex`	null
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果节点关闭以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.HEADER_RELEASE

ITEM_CLOSE

常量

public static const ITEM_CLOSE:String = "itemClose"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

AdvancedDataGridEvent.ITEM_CLOSE 事件类型常量指示 AdvancedDataGrid 分支已关闭或已折叠。

此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息，请参阅详细的属性说明。

属性	值
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	与列关联的数据中的字段或属性的名称。
`item`	关闭的 AdvancedDataGrid 项目（节点）。
`itemRenderer`	已关闭的节点的 ListItemRenderer。
`localX`	NaN
`multiColumnSort`	`false`
`removeColumnFromSort`	`false`
`rowIndex`	-1
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果节点关闭以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.ITEM_CLOSE

ITEM_EDIT_BEGIN

常量

public static const ITEM_EDIT_BEGIN:String = "itemEditBegin"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

AdvancedDataGridEvent.ITEM_EDIT_BEGIN 常量可为 itemEditBegin 事件定义事件对象的 type 属性的值，指示项目已准备就绪，可进行编辑。

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

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

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

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

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

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

属性	值
`bubbles`	`false`
`cancelable`	`true`
`columnIndex`	AdvancedDataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	null
`item`	AdvancedDataGrid 项目（节点）。
`itemRenderer`	所编辑的项目的项呈示器。
`localX`	NaN
`multiColumnSort`	`false`
`reason`	null
`removeColumnFromSort`	`false`
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果节点关闭以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.ITEM_EDIT_BEGIN

ITEM_EDIT_BEGINNING

常量

public static const ITEM_EDIT_BEGINNING:String = "itemEditBeginning"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

此事件的默认侦听器将 AdvancedDataGrid.editedItemPosition 属性设置为具有焦点的项目，这可启动项目编辑会话。

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

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

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

ITEM_EDIT_END

常量

public static const ITEM_EDIT_END:String = "itemEditEnd"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

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

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

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

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

属性	值
`bubbles`	`false`
`cancelable`	`true`
`columnIndex`	AdvancedDataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	与项目的列关联的数据中的字段或属性的名称。
`item`	关闭的 AdvancedDataGrid 项目（节点）。
`itemRenderer`	所编辑的项目的项呈示器。
`localX`	NaN
`multiColumnSort`	`false`
`reason`	定义事件原因的常量。该值必须是 `AdvancedDataGridEventReason` 类的成员。
`removeColumnFromSort`	`false`
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果节点关闭以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.ITEM_EDIT_END

ITEM_FOCUS_IN

常量

public static const ITEM_FOCUS_IN:String = "itemFocusIn"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

属性	值
`bubbles`	`false`
`cancelable`	`false`
`columnIndex`	AdvancedDataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	null
`item`	关闭的 AdvancedDataGrid 项目（节点）。
`itemRenderer`	所编辑的项目的项目编辑器实例。
`localX`	NaN
`multiColumnSort`	`false`
`reason`	null
`removeColumnFromSort`	`false`
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果节点关闭以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.ITEM_FOCUS_IN

ITEM_FOCUS_OUT

常量

public static const ITEM_FOCUS_OUT:String = "itemFocusOut"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

属性	值
`bubbles`	`false`
`cancelable`	`false`
`columnIndex`	AdvancedDataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	null
`item`	关闭的 AdvancedDataGrid 项目（节点）。
`itemRenderer`	所编辑的项目的项目编辑器实例。
`localX`	NaN
`multiColumnSort`	`false`
`reason`	null
`removeColumnFromSort`	`false`
`rowIndex`	数据提供者中项目的索引（从零开始）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果节点关闭以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.ITEM_FOCUS_OUT

ITEM_OPEN

常量

public static const ITEM_OPEN:String = "itemOpen"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

AdvancedDataGridEvent.ITEM_OPEN 事件类型常量指示 AdvancedDataGrid 分支已打开或已展开。

此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息，请参阅详细的属性说明。

属性	值
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`item`	打开的 AdvancedDataGrid 节点。
`itemRenderer`	打开的项目（节点）的 ListItemRenderer。
`localX`	NaN
`multiColumnSort`	`false`
`removeColumnFromSort`	`false`
`rowIndex`	-1
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果项目（节点）打开以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.ITEM_OPEN

ITEM_OPENING

常量

public static const ITEM_OPENING:String = "itemOpening"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在 AdvancedDataGrid 打开或关闭之前立即调度 AdvancedDataGridEvent.ITEM_OPENING 事件类型常量。

此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息，请参阅详细的属性说明。

属性	值
`animate`	是否为打开或关闭操作设计动画效果。
`bubbles`	`false`
`cancelable`	`true`
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dispatchEvent`	打开或关闭动画完成后，是否调度 `ITEM_OPEN` 或 `ITEM_CLOSE` 事件。true
`item`	打开的 AdvancedDataGrid 节点。
`itemRenderer`	打开的项目（节点）的 ListItemRenderer。
`localX`	NaN
`multiColumnSort`	`false`
`removeColumnFromSort`	`false`
`rowIndex`	-1
`opening`	此项目处于打开状态时为 `true`；处于关闭状态时为 false。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果项目打开以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.ITEM_OPENING

SORT

常量

public static const SORT:String = "sort"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

AdvancedDataGridEvent.SORT 常量可为 sort 事件定义事件对象的 type 属性的值。AdvancedDataGrid 控件基于 dataField 和 multiColumnSort 属性的值执行排序。

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

属性	值
`bubbles`	`false`
`cancelable`	`true`
`columnIndex`	AdvancedDataGrid 对象的 `columns` 数组中项目列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dataField`	与列关联的数据中的字段或属性的名称。
`multiColumnSort`	如果为 `true`，则指示无论已使用的是何种排序方式，新的 `dataField` 属性应该同已使用的排序方式一起使用，从而进行多列排序。如果为 `false`，则应该删除任何存在的排序，并对新的 `dataField` 属性重新进行排序。
`removeColumnFromSort`	`false`
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`triggerEvent`	如果节点关闭以响应用户操作，则确定此操作为键盘操作还是鼠标操作。
`type`	AdvancedDataGridEvent.SORT

法律声明 | 在线隐私策略

AdvancedDataGridEvent - AS3 Flex

类 x

animate

column

columnIndex

dataField

dispatchEvent

headerPart

item

itemRenderer

localX

multiColumnSort

opening

reason

removeColumnFromSort

rowIndex

triggerEvent