ListEvent

包	fl.events
类	public class ListEvent
继承	ListEvent Event Object
子类	DataGridEvent

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

ListEvent 类定义基于列表的组件（包括 List、DataGrid、TileList 和 ComboBox 组件）的事件。这些事件包括：

ListEvent.ITEM_CLICK：用户在组件中的项目上单击鼠标以后调度。
ListEvent.ITEM_DOUBLE_CLICK：用户在组件中的项目上快速连续单击鼠标两次以后调度。
ListEvent.ITEM_ROLL_OUT：用户将鼠标指针从组件中的项目移开以后调度。
ListEvent.ITEM_ROLL_OVER：用户在组件中的项目上悬停鼠标指针时调度。

相关 API 元素

公共属性

	属性		由以下参数定义
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		columnIndex : int [只读] 获取与此事件关联的项目的列索引。	ListEvent
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		index : int [只读] 获取包含渲染器的单元格的从零开始的索引。	ListEvent
		item : Object [只读] 获取属于当前单元格渲染器的数据。	ListEvent
		rowIndex : Object [只读] 获取与此事件关联的项目的行索引。	ListEvent
		target : Object [只读] 事件目标。	Event
		type : String [只读] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, index:int = -1, item:Object = null) 使用指定的参数创建新的 ListEvent 对象。	ListEvent
		clone():Event [覆盖] 创建 ListEvent 对象的副本，并设置每个参数的值以匹配原始参数值。	ListEvent
		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 [覆盖] 返回一个字符串，其中包含 ListEvent 对象的所有属性。	ListEvent
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		ITEM_CLICK : String = "itemClick" [静态] 定义 itemClick 事件对象的 type 属性值。	ListEvent
		ITEM_DOUBLE_CLICK : String = "itemDoubleClick" [静态] 定义 itemDoubleClick 事件对象的 type 属性值。	ListEvent
		ITEM_ROLL_OUT : String = "itemRollOut" [静态] 定义 itemRollOut 事件对象的 type 属性值。	ListEvent
		ITEM_ROLL_OVER : String = "itemRollOver" [静态] 定义 itemRollOver 事件对象的 type 属性值。	ListEvent

属性详细信息

columnIndex

属性

columnIndex:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

获取与此事件关联的项目的列索引。

实现
public function get columnIndex():int

相关 API 元素

rowIndex

index

属性

index:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

获取包含渲染器的单元格的从零开始的索引。

实现
public function get index():int

item

属性

item:Object [只读]

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

获取属于当前单元格渲染器的数据。

实现
public function get item():Object

rowIndex

属性

rowIndex:Object [只读]

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

获取与此事件关联的项目的行索引。

实现
public function get rowIndex():Object

相关 API 元素

columnIndex

构造函数详细信息

()

构造函数

public function ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, index:int = -1, item:Object = null)

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

使用指定的参数创建新的 ListEvent 对象。

参数

	`type:String` — 事件类型；该值标识引发事件的动作。

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

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

	`columnIndex:int` (default = `-1`) — 包含渲染器的列的从零开始的索引或列中数据的可视表示形式。

	`rowIndex:int` (default = `-1`) — 包含渲染器的行的从零开始的索引或行中数据的可视表示形式。

	`index:int` (default = `-1`) — DataProvider 中项目的索引（从零开始）。

	`item:Object` (default = `null`) — 对属于渲染器的数据的引用。

方法详细信息

clone

()

方法

override public function clone():Event

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

创建 ListEvent 对象的副本，并设置每个参数的值以匹配原始参数值。

Event — 其参数值与原始参数值匹配的新 ListEvent 对象。

toString

()

方法

override public function toString():String

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

返回一个字符串，其中包含 ListEvent 对象的所有属性。字符串的格式如下：

[ListEvent type=value bubbles=value cancelable=value columnIndex=value rowIndex=value]

String — ListEvent 对象的字符串表示形式。

常量详细信息

ITEM_CLICK

常量

public static const ITEM_CLICK:String = "itemClick"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 itemClick 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`true`
`columnIndex`	包含呈示器的列的从零开始的索引。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`index`	包含渲染器的 DataProvider 中从零开始的索引。
`item`	对属于渲染器的数据的引用。
`rowIndex`	包含渲染器的行的从零开始的索引。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

ITEM_DOUBLE_CLICK

常量

public static const ITEM_DOUBLE_CLICK:String = "itemDoubleClick"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 itemDoubleClick 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`true`
`columnIndex`	包含呈示器的列的从零开始的索引。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`index`	包含渲染器的 DataProvider 中从零开始的索引。
`item`	对属于渲染器的数据的引用。
`rowIndex`	包含渲染器的行的从零开始的索引。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

ITEM_ROLL_OUT

常量

public static const ITEM_ROLL_OUT:String = "itemRollOut"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 itemRollOut 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`columnIndex`	包含呈示器的列的从零开始的索引。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`index`	包含渲染器的 DataProvider 中从零开始的索引。
`item`	对属于渲染器的数据的引用。
`rowIndex`	包含渲染器的行的从零开始的索引。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

相关 API 元素

ITEM_ROLL_OVER

常量

public static const ITEM_ROLL_OVER:String = "itemRollOver"

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

定义 itemRollOver 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`columnIndex`	包含呈示器的列的从零开始的索引。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`index`	包含渲染器的 DataProvider 中从零开始的索引。
`item`	对属于渲染器的数据的引用。
`rowIndex`	包含渲染器的行的从零开始的索引。
`target`	调度了事件的对象。target 不一定是侦听该事件的对象。使用 `currentTarget` 属性可以访问侦听该事件的对象。

相关 API 元素

ITEM_ROLL_OUT

示例如何使用本示例

ListEventExample.as

此示例演示如何使用 ListEvent 类来确定数据网格内项目的行和列。

将 DataGrid 组件添加到库中。
将此代码另存为 ListEventExample.as 并保存到 FLA 文件所在的同一目录中。
将 FLA 中的 DocumentClass 设置为 ListEventExample。

package
{
    import flash.display.Sprite;
    import fl.data.DataProvider;
    import fl.controls.DataGrid;
    import fl.events.ListEvent;
    
    public class ListEventExample extends Sprite
    {
        private var dg:DataGrid;
        
        public function ListEventExample() {
            createDataGrid();
        }
        private function createDataGrid():void {
            dg = new DataGrid();
            addChild(dg);
            dg.setSize(200,300);
            
            var dp:DataProvider = new DataProvider();
            var i:uint;
            var totalRows:uint = 42;
            for(i=0; i<totalRows; i++) {
                dp.addItem( {     col1:getRandomNumber(),
                                   col2:getRandomNumber(),
                                col3:getRandomNumber() } );
            }
            dg.dataProvider = dp;
            dg.addEventListener(ListEvent.ITEM_ROLL_OVER, declarePosition);
        }
        private function declarePosition(e:ListEvent):void {
            trace("You are above row: " + e.rowIndex + " column: " + e.columnIndex);    
        }
        private function getRandomNumber():uint {
            return Math.round(Math.random()*100);
        }
    }
}

法律声明 | 在线隐私策略

ListEvent - AS3 Flash

类 x

columnIndex

index

item

rowIndex

ListEvent

clone

toString

ITEM_CLICK

ITEM_DOUBLE_CLICK

ITEM_ROLL_OUT

ITEM_ROLL_OVER