包 | fl.events |
类 | public class ListEvent |
继承 | ListEvent Event Object |
子类 | DataGridEvent |
语言版本: | ActionScript 3.0 |
产品版本: | Flash CS3 |
运行时版本: | Flash Player 9.0.28.0, AIR 1.0 |
-
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 | ||
[覆盖]
创建 ListEvent 对象的副本,并设置每个参数的值以匹配原始参数值。 | ListEvent | ||
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | ||
表示对象是否已经定义了指定的属性。 | Object | ||
检查是否已对事件调用 preventDefault() 方法。 | Event | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
如果可以取消事件的默认行为,则取消该行为。 | Event | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
设置循环操作动态属性的可用性。 | Object | ||
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | ||
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
[覆盖]
返回一个字符串,其中包含 ListEvent 对象的所有属性。 | ListEvent | ||
返回指定对象的原始值。 | 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 | 属性 |
index | 属性 |
item | 属性 |
rowIndex | 属性 |
构造函数详细信息
ListEvent | () | 构造函数 |
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 | () | 方法 |
toString | () | 方法 |
常量详细信息
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 元素
示例 如何使用本示例
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); } } }
Tue Jun 12 2018, 11:04 AM Z