mx.events.ListEvent (ActionScript 3.0)

	属性	定义方
		bubbles : Boolean [] 指示事件是否为冒泡事件。	Event
		cancelable : Boolean [] 指示是否可以阻止与事件相关联的行为。	Event
		columnIndex : int 包含在其中发生该事件的项目渲染器的列的从零开始的索引。	ListEvent
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [] 事件流中的当前阶段。	Event
		itemRenderer : IListItemRenderer 在其中发生该事件的项目渲染器。	ListEvent
		prototype : Object [] 对类或函数对象的原型对象的引用。	Object
		reason : String 调度 itemEditEnd 事件的原因。	ListEvent
		rowIndex : int 在包含项目渲染器（在其中发生了此事件）的行的从零开始的索引中；对于编辑事件，则为在数据提供程序中正在编辑的项目的索引。	ListEvent
		target : Object [] 事件目标。	Event
		type : String [] 事件的类型。	Event

	方法	定义方
		ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null) 构造函数。	ListEvent
		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" [] Event.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" [] ListEvent.CHANGE 常数可为 change 事件定义 ListEvent 对象的 type 属性的值，指示由于用户交互所选内容已发生更改。	ListEvent
		CLOSE : String = "close" [] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。	Event
		CLOSING : String = "closing" [] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。	Event
		COMPLETE : String = "complete" [] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。	Event
		CONNECT : String = "connect" [] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。	Event
		DEACTIVATE : String = "deactivate" [] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。	Event
		DISPLAYING : String = "displaying" [] 定义 displaying 事件对象的 type 属性值。	Event
		ENTER_FRAME : String = "enterFrame" [] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。	Event
		EXITING : String = "exiting" [] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。	Event
		FULLSCREEN : String = "fullScreen" [] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。	Event
		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_CLICK : String = "itemClick" [] ListEvent.ITEM_CLICK 常数可为 itemClick 事件定义 ListEvent 对象的 type 属性的值，指示用户在控件中某个可视项目上单击了鼠标。	ListEvent
		ITEM_DOUBLE_CLICK : String = "itemDoubleClick" [] ListEvent.ITEM_DOUBLE_CLICK 常数可为 itemDoubleClick 事件定义 ListEvent 对象的 type 属性的值，指示用户在控件中某个可视项目上双击了鼠标。	ListEvent
		ITEM_EDIT_BEGIN : String = "itemEditBegin" [] ListEvent.ITEM_EDIT_BEGIN 常数可为 itemEditBegin 事件定义事件对象的 type 属性的值，指示准备编辑的项目。	ListEvent
		ITEM_EDIT_BEGINNING : String = "itemEditBeginning" [] ListEvent.ITEM_EDIT_BEGINNING 常数可为 itemEditBeginning 事件定义 ListEvent 对象的 type 属性的值，指示用户已准备好编辑某个项目，例如，通过在该项目上释放鼠标按键。	ListEvent
		ITEM_EDIT_END : String = "itemEditEnd" [] ListEvent.ITEM_EDIT_END 常数可为 itemEditEnd 事件定义 ListEvent 对象的 type 属性的值，指示编辑会话结束。	ListEvent
		ITEM_FOCUS_IN : String = "itemFocusIn" [] ListEvent.ITEM_FOCUS_IN 常数可为 itemFocusIn 事件定义 ListEvent 对象的 type 属性的值，指示项目已获得焦点。	ListEvent
		ITEM_FOCUS_OUT : String = "itemFocusOut" [] ListEvent.ITEM_FOCUS_OUT 常数可为 itemFocusOut 事件定义 ListEvent 对象的 type 属性的值，指示项目已失去焦点。	ListEvent
		ITEM_ROLL_OUT : String = "itemRollOut" [] ListEvent.ITEM_ROLL_OUT 常数可为 itemRollOut 事件定义 ListEvent 对象的 type 属性的值，指示用户执行了将鼠标指针从控件中某个可视项目上移开的操作。	ListEvent
		ITEM_ROLL_OVER : String = "itemRollOver" [] ListEvent.ITEM_ROLL_OVER 常数可为 itemRollOver 事件定义 ListEvent 对象的 type 属性的值，指示用户执行了将鼠标指针滑过控件中某个可视项目的操作。	ListEvent
		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
		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
		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

包含在其中发生该事件的项目渲染器的列的从零开始的索引。

itemRenderer

属性

public var itemRenderer:IListItemRenderer

在其中发生该事件的项目渲染器。您可以使用此属性访问数据提供程序。

reason

属性

public var reason:String

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

另请参见

ListEventReason

rowIndex

属性

public var rowIndex:int

在包含项目渲染器（在其中发生了此事件）的行的从零开始的索引中；对于编辑事件，则为在数据提供程序中正在编辑的项目的索引。

构造函数详细信息

ListEvent

()

构造函数

public function ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null)

构造函数。通常由 Flex 控件调用且不用于应用程序代码。

参数

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

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

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

	`columnIndex:int` (default = `-1`) — 包含渲染器的列的从零开始的索引。

	`rowIndex:int` (default = `-1`) — 包含渲染器的行的从零开始的索引；对于正在编辑的事件，则是将要编辑的数据提供程序中项目的索引

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

	`itemRenderer:IListItemRenderer` (default = `null`) — 数据提供程序项目的项目渲染器。

常量详细信息

CHANGE

常量

public static const CHANGE:String = "change"

ListEvent.CHANGE 常数可为 change 事件定义 ListEvent 对象的 type 属性的值，指示由于用户交互所选内容已发生更改。

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

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	单击的项目渲染器。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.CHANGE

ITEM_CLICK

常量

public static const ITEM_CLICK:String = "itemClick"

ListEvent.ITEM_CLICK 常数可为 itemClick 事件定义 ListEvent 对象的 type 属性的值，指示用户在控件中某个可视项目上单击了鼠标。

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

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	单击的项目渲染器。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_CLICK

ITEM_DOUBLE_CLICK

常量

public static const ITEM_DOUBLE_CLICK:String = "itemDoubleClick"

ListEvent.ITEM_DOUBLE_CLICK 常数可为 itemDoubleClick 事件定义 ListEvent 对象的 type 属性的值，指示用户在控件中某个可视项目上双击了鼠标。

若要接收 itemDoubleClick 事件，必须将组件的 doubleClickEnabled 属性设置为 true。

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

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	双击的项目渲染器。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_DOUBLE_CLICK

ITEM_EDIT_BEGIN

常量

public static const ITEM_EDIT_BEGIN:String = "itemEditBegin"

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

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

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

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

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

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

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

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	所编辑的项目的项目渲染器。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_EDIT_BEGIN

ITEM_EDIT_BEGINNING

常量

public static const ITEM_EDIT_BEGINNING:String = "itemEditBeginning"

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

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

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

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

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	要编辑的项目的项目渲染器。如果此事件由键盘生成，则此属性为 null，因为要编辑的项目可能未在屏幕范围内显示。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_EDIT_BEGIN

ITEM_EDIT_END

常量

public static const ITEM_EDIT_END:String = "itemEditEnd"

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

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

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

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

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

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

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	已编辑的项目的项目渲染器。
`reason`	定义事件原因的常量。该值必须是 `ListEventReson` 类的成员。
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_EDIT_END

ITEM_FOCUS_IN

常量

public static const ITEM_FOCUS_IN:String = "itemFocusIn"

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

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

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	所编辑的项目的项目编辑器实例。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_FOCUS_IN

ITEM_FOCUS_OUT

常量

public static const ITEM_FOCUS_OUT:String = "itemFocusOut"

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

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

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	正在编辑的项目的项目编辑器实例。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_FOCUS_OUT

ITEM_ROLL_OUT

常量

public static const ITEM_ROLL_OUT:String = "itemRollOut"

ListEvent.ITEM_ROLL_OUT 常数可为 itemRollOut 事件定义 ListEvent 对象的 type 属性的值，指示用户执行了将鼠标指针从控件中某个可视项目上移开的操作。

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

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	被移开的项目渲染器。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_ROLL_OUT

ITEM_ROLL_OVER

常量

public static const ITEM_ROLL_OVER:String = "itemRollOver"

ListEvent.ITEM_ROLL_OVER 常数可为 itemRollOver 事件定义 ListEvent 对象的 type 属性的值，指示用户执行了将鼠标指针滑过控件中某个可视项目的操作。

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

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	滑过的项目渲染器。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_ROLL_OVER

包	mx.events
Class	public class ListEvent
继承	ListEvent Event Object
Subclasses	MenuEvent