包 | mx.events |
类 | public class ListEvent |
继承 | ListEvent Event Object |
子类 | MenuEvent |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
相关 API 元素
属性 | 由以下参数定义 | ||
---|---|---|---|
bubbles : Boolean [只读]
表示事件是否为冒泡事件。 | Event | ||
cancelable : Boolean [只读]
表示是否可以阻止与事件相关联的行为。 | Event | ||
columnIndex : int
包含在其中发生该事件的项呈示器的列的从零开始的索引。 | ListEvent | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
currentTarget : Object [只读]
当前正在使用某个事件侦听器处理 Event 对象的对象。 | Event | ||
eventPhase : uint [只读]
事件流中的当前阶段。 | Event | ||
itemRenderer : IListItemRenderer
在其中发生该事件的项呈示器。 | ListEvent | ||
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 | ||
复制 Event 子类的实例。 | Event | ||
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | ||
表示对象是否已经定义了指定的属性。 | Object | ||
检查是否已对事件调用 preventDefault() 方法。 | Event | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
如果可以取消事件的默认行为,则取消该行为。 | Event | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
设置循环操作动态属性的可用性。 | Object | ||
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | ||
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
返回一个字符串,其中包含 Event 对象的所有属性。 | Event | ||
返回指定对象的原始值。 | Object |
常量 | 由以下参数定义 | ||
---|---|---|---|
CHANGE : String = "change" [静态]
ListEvent.CHANGE 常量可为 change 事件定义 ListEvent 对象的 type 属性的值,指示由于用户交互所选内容已发生更改。 | ListEvent | ||
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 |
columnIndex | 属性 |
public var columnIndex:int
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
包含在其中发生该事件的项呈示器的列的从零开始的索引。
itemRenderer | 属性 |
public var itemRenderer:IListItemRenderer
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
在其中发生该事件的项呈示器。您可以使用此属性访问数据提供程序。
reason | 属性 |
public var reason:String
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
调度 itemEditEnd
事件的原因。仅对类型为 ITEM_EDIT_END
的事件有效。这些可能的值是在 ListEventReason 类中定义的。
相关 API 元素
rowIndex | 属性 |
public var rowIndex:int
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
在包含项呈示器(在其中发生了此事件)的行的从零开始的索引中;对于编辑事件,则为在数据提供程序中正在编辑的项目的索引。
ListEvent | () | 构造函数 |
public function ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null)
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。通常由 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"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
ListEvent.CHANGE 常量可为 change
事件定义 ListEvent 对象的 type
属性的值,指示由于用户交互所选内容已发生更改。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
itemRenderer | 单击的项呈示器。 |
reason | null |
rowIndex | 与事件相关联的项目的从零开始的索引。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
类型 | ListEvent.CHANGE |
ITEM_CLICK | 常量 |
public static const ITEM_CLICK:String = "itemClick"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
ListEvent.ITEM_CLICK 常量可为 itemClick
事件定义 ListEvent 对象的 type
属性的值,指示用户在控件中某个可视项目上单击了鼠标。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 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"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
ListEvent.ITEM_DOUBLE_CLICK 常量可为 itemDoubleClick
事件定义 ListEvent 对象的 type
属性的值,指示用户在控件中某个可视项目上双击了鼠标。
若要接收 itemDoubleClick 事件,必须将组件的 doubleClickEnabled
属性设置为 true
。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 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"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
ListEvent.ITEM_EDIT_BEGIN 常量可为 itemEditBegin
事件定义事件对象的 type
属性的值,指示准备编辑的项目。
此事件的默认侦听器执行下列操作:
- 通过调用
createItemEditor()
方法来创建项目编辑器对象。 - 将
data
属性从项目复制到编辑器。默认情况下,项目编辑器对象是 TextInput 控件的实例。您可以使用 list 控件的itemEditor
属性指定自定义项目编辑器类。 - 设置 list 控件的
itemEditorInstance
属性,以引用项目编辑器实例。
您可以为此事件编写事件侦听器以修改传递到项目编辑器的数据。例如,您可以修改项目编辑器使用的数据、数据格式或其他信息。
您还可以创建事件侦听器以指定用于编辑项目的项目编辑器。例如,您可能有两个不同的项目编辑器。在事件侦听器中,您可以通过执行下列操作检查要编辑的数据或其他信息,并打开相应的项目编辑器:
- 调用
preventDefault()
以阻止 Flex 在默认事件侦听器中调用createItemEditor()
方法。 - 将
itemEditor
属性设置为相应编辑器。 - 调用
createItemEditor()
方法。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 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"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
ListEvent.ITEM_EDIT_BEGINNING 常量可为 itemEditBeginning
事件定义 ListEvent 对象的 type
属性的值,指示用已户准备编辑某个项目,例如,通过在该项目上释放鼠标按键。
此事件的默认侦听器将 List.editedItemPosition
属性设置为具有焦点的项目,这可启动项目编辑会话。
您通常可以为此事件编写自己的事件侦听器,以禁止编辑特定项目。在为此事件自己编写的事件侦听器内调用 preventDefault()
方法可以阻止默认侦听器执行。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 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"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
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 | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 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"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
ListEvent.ITEM_FOCUS_IN 常量可为 itemFocusIn
事件定义 ListEvent 对象的 type
属性的值,指示项目已获得焦点。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 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"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
ListEvent.ITEM_FOCUS_OUT 常量可为 itemFocusOut
事件定义 ListEvent 对象的 type
属性的值,指示项目已失去焦点。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 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"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
ListEvent.ITEM_ROLL_OUT 常量可为 itemRollOut
事件定义 ListEvent 对象的 type
属性的值,指示用户执行了将鼠标指针从控件中某个可视项目上移开的操作。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 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"
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
ListEvent.ITEM_ROLL_OVER 常量可为 itemRollOver
事件定义 ListEvent 对象的 type
属性的值,指示用户执行了将鼠标指针滑过控件中某个可视项目的操作。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
itemRenderer | 滑过的项呈示器。 |
reason | null |
rowIndex | 与事件相关联的项目的从零开始的索引。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
类型 | ListEvent.ITEM_ROLL_OVER |
Tue Jun 12 2018, 11:04 AM Z