| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
dataProvider 属性提供，并通过项呈示器显示。
在模型/视图体系结构中，ListBase-derived 类提供视图，dataProvider 对象提供模型。
MXML 语法
显示 MXML 语法
隐藏 MXML 语法The ListBase class inherits all of the tag properties of its superclasses, and adds the following tag properties:
<mx:tagname
Properties
allowDragSelection="false|true"
allowMultipleSelection="false|true"
columnCount="4"
columnWidth="NaN"
dataProvider="null"
dataTipField="label"
dataTipFunction="null"
dragEnabled="false|true"
dragMoveEnabled="false|true"
dropEnabled="false|true"
iconField="null"
iconFunction="null"
itemRenderer="null"
labelField="label"
labelFunction="null"
menuSelectionMode="false|true"
offscreenExtraRowsOrColumns="0"
rowCount="-1"
rowHeight="NaN"
selectable="true|false"
selectedIndex="-1"
selectedIndices="null"
selectedItem="null"
selectedItems="null"
showDataTips="false|true"
variableRowHeight="false|true"
wordWrap="false|true"
Styles
alternatingItemColors="undefined"
itemsChangeEffect="undefined"
dropIndicatorSkin="ListDropIndicator"
focusAlpha="0.5"
focusRoundedCorners="tl tr bl br"
paddingBottom="2"
paddingLeft="2"
paddingRight="0"
paddingTop="2"
rollOverColor="0xEEFEE6"
selectionColor="0x7FCEFF"
selectionDisabledColor="0xDDDDDD"
selectionDuration="250"
selectionEasingFunction="undefined"
textRollOverColor="0x2B333C"
textSelectedColor="0x2B333C"
useRollOver="true|false"
verticalAlign="top|middle|bottom"
Events
change="No default"
dataChange="No default"
itemClick="No default"
itemDoubleClick="No default"
itemRollOut="No default"
itemRollOver="No default"
/>
相关 API 元素
公共属性
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | accessibilityDescription : String
一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 description 属性。 | UIComponent | |
| accessibilityEnabled : Boolean
一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 silent 属性。 | UIComponent | |
| accessibilityImplementation : AccessibilityImplementation
InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。 | InteractiveObject | |
| accessibilityName : String
一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 name 属性。 | UIComponent | |
| accessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。 | DisplayObject | |
| accessibilityShortcut : String
一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 shortcut 属性。 | UIComponent | |
| activeEffects : Array [只读]
组件上当前播放的效果列表，如 EffectInstance 实例的 Array。 | UIComponent | |
| allowDragSelection : Boolean = false
一个标志，指示是否启用拖动选择。 | ListBase | ||
| allowMultipleSelection : Boolean
一个标志，指示是否允许您同时选择多个项目。 | ListBase | ||
| alpha : Number
表示指定对象的 Alpha 透明度值。 | DisplayObject | |
| automationDelegate : Object
处理自动化相关功能的委托对象。 | UIComponent | |
| automationEnabled : Boolean [只读]
如果此组件启用了自动化，则为 true；否则为 false。 | UIComponent | |
| automationName : String
可用作此对象的标识符的名称。 | UIComponent | |
| automationOwner : DisplayObjectContainer [只读]
用于自动化目的的此组件的所有者。 | UIComponent | |
| automationParent : DisplayObjectContainer [只读]
用于自动化目的的此组件的父级。 | UIComponent | |
| automationTabularData : Object [只读]
IAutomationTabularData 接口的实现，可用于检索数据。 | UIComponent | |
| automationValue : Array [只读]
此值通常对应于对象的经呈示的外观，当对象在应用中以可视方式显示时，此值使标识符与该对象相关联。 | UIComponent | |
| automationVisible : Boolean [只读]
如果此组件对于自动化是可见的，则为 true；否则为 false。 | UIComponent | |
| baseline : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| baselinePosition : Number [只读]
组件第一行文本的基线的 y 坐标。 | UIComponent | |
| blendMode : String
BlendMode 类中的一个值，用于指定要使用的混合模式。 | DisplayObject | |
| blendShader : Shader [只写]
设置用于混合前景和背景的着色器。 | DisplayObject | |
| borderMetrics : EdgeMetrics [只读]
返回 EdgeMetrics 对象，它具有四个属性：left、top、right 和 bottom。 | ScrollControlBase | |
| bottom : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| buttonMode : Boolean
指定此 sprite 的按钮模式。 | Sprite | |
| cacheAsBitmap : Boolean
如果设置为 true，则 Flash 运行时将缓存显示对象的内部位图表示形式。 | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
如果为非 null，则 Matrix 对象会定义显示对象在 cacheAsBitmap 设置为 true 时的呈现方式。 | DisplayObject | |
| cacheHeuristic : Boolean [只写]
供 Flex 使用，表示建议为对象实施位图缓存。 | UIComponent | |
| cachePolicy : String
指定此对象的位图缓存策略。 | UIComponent | |
| className : String [只读]
此实例的类的名称，如“Button”。 | UIComponent | |
| columnCount : int
在 TileList 控件中显示的列数，或在 HorizontalList 控件中显示的项目数。 | ListBase | ||
| columnWidth : Number
控件中列的宽度。 | ListBase | ||
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| contentMouseX : Number [只读]
返回鼠标在内容坐标系中的 x 位置。 | UIComponent | |
| contentMouseY : Number [只读]
返回内容坐标系中鼠标的 y 位置。 | UIComponent | |
| contextMenu : NativeMenu
指定与此对象相关联的上下文菜单。 | InteractiveObject | |
| currentState : String
组件的当前视图状态。 | UIComponent | |
| cursorManager : ICursorManager [只读]
获取控制此组件及其同级组件的光标的 CursorManager。 | UIComponent | |
| data : Object
将此组件用作项呈示器或项目编辑器时，此组件应呈示的数据提供程序中的项目。 | ListBase | ||
| dataProvider : Object
要查看的数据集。 | ListBase | ||
| dataTipField : String
数据提供程序项目中作为数据提示显示的字段名称。 | ListBase | ||
| dataTipFunction : Function
用户提供的函数，在各个项目上运行以确定其数据提示。 | ListBase | ||
| depth : Number
确定容器内各项目的呈示顺序。 | UIComponent | |
| descriptor : UIComponentDescriptor
引用 UIComponentDescriptor（如果有），过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。 | UIComponent | |
| designLayer : DesignLayer
指定与该可视元素关联的可选 DesignLayer 实例。 | UIComponent | |
| document : Object
引用与此 UIComponent 相关联的文档对象。 | UIComponent | |
| doubleClickEnabled : Boolean [覆盖]
指定 UIComponent 对象是否接收 doubleClick 事件。 | UIComponent | |
| dragEnabled : Boolean
一个标志，指示是否可以将项目拖出此控件并放到其它控件上。 | ListBase | ||
| dragMoveEnabled : Boolean
一个标志，指示在拖放操作过程中是否可以移动控件中的项目，而不只是从控件中复制这些项目。 | ListBase | ||
| dropEnabled : Boolean
一个标志，指示是否可以将所拖动的项目放到此控件上。 | ListBase | ||
| dropTarget : DisplayObject [只读]
指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。 | Sprite | |
| enabled : Boolean
组件是否可以接受用户交互。 | UIComponent | |
| errorString : String
当验证程序监视组件并且验证失败时，组件的错误提示中将显示的文本。 | UIComponent | |
| explicitHeight : Number
指定该组件在组件坐标中显式高度（以像素为单位）的数字。 | UIComponent | |
| explicitMaxHeight : Number
布局过程中父级要考虑的组件最大建议高度。 | UIComponent | |
| explicitMaxWidth : Number
布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | |
| explicitMinHeight : Number
布局过程中父级要考虑的组件最小建议高度。 | UIComponent | |
| explicitMinWidth : Number
布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | |
| explicitWidth : Number
指定该组件在组件坐标中显式宽度（以像素为单位）的数字。 | UIComponent | |
| filters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。 | DisplayObject | |
| flexContextMenu : IFlexContextMenu
此 UIComponent 的上下文菜单。 | UIComponent | |
| focusEnabled : Boolean
指示切换到此组件时，是否可以获得焦点。 | UIComponent | |
| focusManager : IFocusManager
获取控制此组件及其同级组件的焦点的 FocusManager。 | UIComponent | |
| focusPane : Sprite
与此对象相关联的焦点窗格。 | UIComponent | |
| focusRect : Object
指定此对象是否显示焦点矩形。 | InteractiveObject | |
| graphics : Graphics [只读]
指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘图命令。 | Sprite | |
| hasFocusableChildren : Boolean
一个标志，指示子对象是否能够获得焦点。 | UIComponent | |
| hasLayoutMatrix3D : Boolean [只读]
如果元素具有 3D 矩阵，则为 true。 | UIComponent | |
| height : Number [覆盖]
指定组件在父坐标中的高度的数字（以像素为单位）。 | UIComponent | |
| hitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | |
| horizontalCenter : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| horizontalScrollPolicy : String
指示水平滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。 | ScrollControlBase | |
| horizontalScrollPosition : Number
内容与左边缘的偏移量。 | ScrollControlBase | |
| iconField : String
数据提供程序对象中字段的名称，该字段用于确定显示为图标的对象。 | ListBase | ||
| iconFunction : Function
用户提供的函数，在每个项目上运行以确定其图标。 | ListBase | ||
| id : String
组件 ID。 | UIComponent | |
| includeInLayout : Boolean
指定此组件是否包含在父容器的布局中。 | UIComponent | |
| inheritingStyles : Object
此组件的继承样式链的开头内容。 | UIComponent | |
| initialized : Boolean
一个标志，用于确定某个对象是否已通过布局的所有三个阶段：提交、测量和布局（假设每个阶段都是必需的）。 | UIComponent | |
| instanceIndex : int [只读]
重复组件的索引。 | UIComponent | |
| instanceIndices : Array
一个 Array，包含从此 UIComponent 对象的父文档引用该对象所需的索引。 | UIComponent | |
| is3D : Boolean [只读]
当元素为 3D 时，则为 true。 | UIComponent | |
| isDocument : Boolean [只读]
如果此 UIComponent 实例为文档对象，则为 true。 | UIComponent | |
| isPopUp : Boolean
PopUpManager 将其设置为 true 以指示已弹出该组件。 | UIComponent | |
| itemRenderer : IFactory
控件的自定义项呈示器。 | ListBase | ||
| labelField : String
数据提供程序项目中作为标签显示的字段名称。 | ListBase | ||
| labelFunction : Function
用户提供的函数，在每个项目上运行以确定其标签。 | ListBase | ||
| layoutMatrix3D : Matrix3D [只写]
用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | |
| left : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| listData : BaseListData
如果使用组件作为嵌入式项呈示器或嵌入式项目编辑器，则 Flex 将使用 list 控件中的其它数据初始化组件的 listData 属性。 | ListBase | ||
| liveScrolling : Boolean = true
一个标志，指示移动滚动栏滑块时实时滚动视图，还是释放滑块后才更新视图。 | ScrollControlBase | |
| loaderInfo : LoaderInfo [只读]
返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | |
| maintainProjectionCenter : Boolean
如果为 true，则该组件将使其投影矩阵在其边框的中央保持居中。 | UIComponent | |
| mask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | |
| maxHeight : Number
布局过程中父级要考虑的组件最大建议高度。 | UIComponent | |
| maxHorizontalScrollPosition : Number
horizontalScrollPosition 属性的最大值。 | ScrollControlBase | |
| maxVerticalScrollPosition : Number
verticalScrollPosition 属性的最大值。 | ScrollControlBase | |
| maxWidth : Number
布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | |
| measuredHeight : Number
组件的默认高度（以像素为单位）。 | UIComponent | |
| measuredMinHeight : Number
组件的默认最小高度（以像素为单位）。 | UIComponent | |
| measuredMinWidth : Number
组件的默认最小宽度（以像素为单位）。 | UIComponent | |
| measuredWidth : Number
组件的默认宽度（以像素为单位）。 | UIComponent | |
| menuSelectionMode : Boolean = false
一个标志，指示是否应使用菜单样式选择。 | ListBase | ||
| metaData : Object
如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的，则获取 DisplayObject 实例的元数据对象。 | DisplayObject | |
| minHeight : Number
布局过程中父级要考虑的组件最小建议高度。 | UIComponent | |
| minWidth : Number
布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | |
| moduleFactory : IFlexModuleFactory
模块工厂用作上下文，用于为此组件使用嵌入字体以及查找用于控制此组件样式的样式管理器。 | UIComponent | |
| mouseChildren : Boolean
确定对象的子级是否支持鼠标或用户输入设备。 | DisplayObjectContainer | |
| mouseEnabled : Boolean
指定此对象是否接收鼠标或其他用户输入、消息。 | InteractiveObject | |
| mouseFocusEnabled : Boolean
单击时是否可获得焦点。 | UIComponent | |
| mouseX : Number [只读]
表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。 | DisplayObject | |
| mouseY : Number [只读]
表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。 | DisplayObject | |
| name : String
表示 DisplayObject 的实例名称。 | DisplayObject | |
| needsSoftKeyboard : Boolean
指定当该 InteractiveObject 实例获得焦点时，是否显示虚拟键盘（显示在屏幕上的软键盘）。 | InteractiveObject | |
| nestLevel : int
此对象在所属关系层次结构中的深度。 | UIComponent | |
| nonInheritingStyles : Object
此组件的非继承样式链的开头内容。 | UIComponent | |
| nullItemRenderer : IFactory
控件的自定义项呈示器。 | ListBase | ||
| numAutomationChildren : int [只读]
此容器包含的自动化子项数。 | UIComponent | |
| numChildren : int [只读]
返回此对象的子项数目。 | DisplayObjectContainer | |
| offscreenExtraRowsOrColumns : int
项呈示器的额外行或列的目标数量，供在控件布局中使用。 | ListBase | ||
| opaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | |
| owner : DisplayObjectContainer
此 IVisualElement 对象的所有者。 | UIComponent | |
| parent : DisplayObjectContainer [覆盖] [只读]
此组件的父容器或组件。 | UIComponent | |
| parentApplication : Object [只读]
引用包含此 UIComponent 实例的 Application 对象。 | UIComponent | |
| parentDocument : Object [只读]
引用此 UIComponent 的父文档对象。 | UIComponent | |
| percentHeight : Number
以组件父代大小百分比的方式指定组件高度。 | UIComponent | |
| percentWidth : Number
以组件父代大小百分比的方式指定组件宽度。 | UIComponent | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。 | UIComponent | |
| processedDescriptors : Boolean
临时或延迟子项创建操作后设置为 true，具体取决于发生对象。 | UIComponent | |
| repeater : IRepeater [只读]
对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
| repeaterIndex : int [只读]
项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。 | UIComponent | |
| repeaterIndices : Array
一个 Array，包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。 | UIComponent | |
| repeaters : Array
一个 Array，包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
| right : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| root : DisplayObject [只读]
对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | |
| rotation : Number [覆盖]
表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。 | UIComponent | |
| rotationX : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。 | UIComponent | |
| rotationY : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。 | UIComponent | |
| rotationZ : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。 | UIComponent | |
| rowCount : int
要显示的行数。 | ListBase | ||
| rowHeight : Number
行高（以像素为单位）。 | ListBase | ||
| scale9Grid : Rectangle
当前有效的缩放网格。 | DisplayObject | |
| scaleX : Number [覆盖]
用于指定水平缩放系数的数字。 | UIComponent | |
| scaleY : Number [覆盖]
用于指定垂直缩放系数的数字。 | UIComponent | |
| scaleZ : Number [覆盖]
指定沿着 z 轴的缩放因子的数值。 | UIComponent | |
| screen : Rectangle [只读]
返回包含此对象的基本绘图表面大小和位置的对象。 | UIComponent | |
| scrollRect : Rectangle
显示对象的滚动矩形范围。 | DisplayObject | |
| scrollTipFunction : Function
将要显示的字符串作为 ScrollTip 计算的函数。 | ScrollControlBase | |
| selectable : Boolean
一个标志，指示列表是否将所选项目显示为选中状态。 | ListBase | ||
| selectedIndex : int
所选项目的数据提供程序中的索引。 | ListBase | ||
| selectedIndices : Array
数据提供程序中所选项目的索引的数组。 | ListBase | ||
| selectedItem : Object
对数据提供程序中所选项目的引用。 | ListBase | ||
| selectedItems : Array
对数据提供程序中所选项目的引用的数组。 | ListBase | ||
| selectedItemsCompareFunction : Function
用于比较 selectedItems 属性中的项目与数据提供程序中的项目的函数。 | ListBase | ||
| showDataTips : Boolean
一个标志，指示是否为行中的文本显示数据提示。 | ListBase | ||
| showInAutomationHierarchy : Boolean
用于确定自动化对象是否显示在自动化层次中的标志。 | UIComponent | |
| showScrollTips : Boolean = false
一个标志，指示拖动滚动滑块时是否应在其旁边显示工具提示。 | ScrollControlBase | |
| softKeyboard : String
控制软键盘的外观。 | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
定义当显示软键盘时应在屏幕上保留的区域（在 iOS 上不支持）。 | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
控制此 sprite 中的声音。 | Sprite | |
| stage : Stage [只读]
显示对象的舞台。 | DisplayObject | |
| states : Array
为此组件定义的视图状态。 | UIComponent | |
| styleDeclaration : CSSStyleDeclaration
存储此对象的内嵌继承样式。 | UIComponent | |
| styleManager : IStyleManager2 [只读]
返回此组件使用的 StyleManager 实例。 | UIComponent | |
| styleName : Object
此组件使用的类样式。 | UIComponent | |
| styleParent : IAdvancedStyleClient
组件的父项用于评估后代选择器。 | UIComponent | |
| systemManager : ISystemManager
返回此组件使用的 SystemManager 对象。 | UIComponent | |
| tabChildren : Boolean
确定对象的子项是否支持 Tab 键。 | DisplayObjectContainer | |
| tabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | |
| tabFocusEnabled : Boolean
一个标志，指示该对象是否能够通过 Tab 键获得焦点。这与 Flash Player 使用的 tabEnabled 属性类似。对于处理键盘输入的组件该标志通常为 true，但是控件栏中的一些组件将其设置为 false，因为它们不能像编辑器一样从另外的组件窃取焦点。 | UIComponent | |
| tabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [只读]
返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。 | DisplayObjectContainer | |
| toolTip : String
要在 ToolTip 中显示的文本。 | UIComponent | |
| top : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| transform : flash.geom:Transform [覆盖]
一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | UIComponent | |
| transformX : Number
设置组件转换中心的 x 坐标。 | UIComponent | |
| transformY : Number
设置组件转换中心的 y 坐标。 | UIComponent | |
| transformZ : Number
设置组件转换中心的 z 坐标。 | UIComponent | |
| transitions : Array
一个 Transition 对象 Array，其中的每个 Transition 对象都定义一组效果，用于在视图状态发生更改时播放。 | UIComponent | |
| tweeningProperties : Array
当前在此对象上进行补间的属性数组。 | UIComponent | |
| uid : String
对象的唯一标识符。 | UIComponent | |
| updateCompletePendingFlag : Boolean
一个标志，确定某个对象是否已通过所有三个阶段的布局验证（假设需要通过所有验证）。 | UIComponent | |
| useHandCursor : Boolean
布尔值，表示当指针滑过 buttonMode 属性设置为 true 的 sprite 时是否显示指针手形（手形光标）。 | Sprite | |
| validationSubField : String
供验证程序用来将子字段与此组件相关联。 | UIComponent | |
| value : Object [只读]
所选项目，或者所选项目的数据或标签字段。 | ListBase | ||
| variableRowHeight : Boolean
一个标志，指示各行是否可以采用不同的高度。 | ListBase | ||
| verticalCenter : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| verticalScrollPolicy : String
指示垂直滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。 | ScrollControlBase | |
| verticalScrollPosition : Number
顶边到内容的偏移量。 | ScrollControlBase | |
| viewMetrics : EdgeMetrics [只读]
考虑滚动条（如果可见）的 EdgeMetrics 对象。 | ScrollControlBase | |
| visible : Boolean [覆盖]
显示对象是否可见。 | UIComponent | |
| width : Number [覆盖]
指定组件在父坐标中的宽度的数字（以像素为单位）。 | UIComponent | |
| wordWrap : Boolean
一个标志，指示行中的文本是否应自动换行。 | ListBase | ||
| x : Number [覆盖]
指定组件在其父容器中的水平位置（以像素为单位）的数字。 | UIComponent | |
| y : Number [覆盖]
指定组件在其父容器中的垂直位置（以像素为单位）的数字。 | UIComponent | |
| z : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | UIComponent | |
受保护的属性
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| actualCollection : ICollectionView
通常存储于运行数据更改效果时使用的 collection 中的值副本。 | ListBase | ||
| actualIterator : IViewCursor
通常存储于运行数据更改效果时使用的 iterator 中的值副本。 | ListBase | ||
| allowItemSizeChangeNotification : Boolean [只写]
如果设置为 false，则呈示器无法使 List 的大小失效. | ListBase | ||
| anchorBookmark : CursorBookmark
作为锚点的项目的书签。 | ListBase | ||
| anchorIndex : int = -1
作为选择锚点的数据提供程序中项目的偏移量。 | ListBase | ||
| border : IFlexDisplayObject
边框对象。 | ScrollControlBase | |
| cachedItemsChangeEffect : IEffect = null
当控件的数据提供程序中发生更改时播放的效果，通过 itemsChangeEffect 样式设置。 | ListBase | ||
| caretBookmark : CursorBookmark
尖号下方项目的书签。 | ListBase | ||
| caretIndex : int = -1
作为选择尖号点的数据提供程序中项目的偏移量。 | ListBase | ||
| caretIndicator : Sprite
包含图形的 DisplayObject，该图形指示哪个呈示器是尖号。 | ListBase | ||
| caretItemRenderer : IListItemRenderer
尖号下方项目的呈示器。 | ListBase | ||
| caretUID : String
尖号下方项目的 UID。 | ListBase | ||
| collection : ICollectionView
用于提供数据提供程序的 ICollectionView。 | ListBase | ||
| currentCSSState : String [只读]
匹配 CSS 伪选择器时要使用的状态。 | UIComponent | |
| dataEffectCompleted : Boolean = false
一个标志，指示数据更改效果已完成。 | ListBase | ||
| dataItemWrappersByRenderer : Dictionary
将项呈示器映射到 ItemWrappers（用于提供其数据）的 dictionary。 | ListBase | ||
| defaultColumnCount : int = 4
要显示的默认列数。 | ListBase | ||
| defaultRowCount : int = 4
要显示的默认行数。 | ListBase | ||
| dragImage : IUIComponent [只读]
获取可显示拖放操作中的可视效果的类实例。 | ListBase | ||
| dragImageOffsets : Point [只读]
获取所拖动图像在拖放后的偏移量。 | ListBase | ||
| explicitColumnCount : int = -1
显式设置 columnCount 属性时需要的列计数。 | ListBase | ||
| explicitColumnWidth : Number
显式设置 columnWidth 时需要的列宽。 | ListBase | ||
| explicitRowCount : int = -1
显式设置 rowCount 时需要的行计数。 | ListBase | ||
| explicitRowHeight : Number
显式设置 rowHeight 时需要的行高。 | ListBase | ||
| factoryMap : Dictionary
项呈示器基于工厂的映射。 | ListBase | ||
| freeItemRenderers : Array
闲置项呈示器的堆栈。 | ListBase | ||
| freeItemRenderersByFactory : Dictionary
空闲项呈示器基于工厂的映射。 | ListBase | ||
| hasComplexLayoutMatrix : Boolean [只读]
如果 UIComponent 具有任何非平移 (x,y) 转换属性，则返回 true。 | UIComponent | |
| highlightIndicator : Sprite
包含图形的 DisplayObject，用以指示加亮哪个呈示器。 | ListBase | ||
| highlightItemRenderer : IListItemRenderer
当前滚动到尖号上方或下方的呈示器。 | ListBase | ||
| highlightUID : String
当前滚动到尖号上方或下方的项目的 UID。 | ListBase | ||
| horizontalScrollBar : ScrollBar
水平滚动条。 | ScrollControlBase | |
| itemsNeedMeasurement : Boolean = true
一个标志，指示是否需要计算 columnWidth 和 rowHeight 属性。 | ListBase | ||
| itemsSizeChanged : Boolean = false
一个标志，指示呈示器的大小可能已更改。 | ListBase | ||
| iterator : IViewCursor
主 IViewCursor，用于从数据提供程序中获取项目并将这些项目传递到呈示器。 | ListBase | ||
| iteratorValid : Boolean = true
一个标志，指示发生页面错误和迭代器位置无效（未放置在所显示的最上方项目处）。 | ListBase | ||
| keySelectionPending : Boolean = false
一个标志，指示键盘选择是否由于页面错误而中断。 | ListBase | ||
| lastDropIndex : int
最近计算出的索引，这是拖动项目在放置目标中的添加位置。 | ListBase | ||
| lastSeekPending : ListBaseSeekPending
导致页面错误的最新一次搜索。 | ListBase | ||
| listContent : ListBaseContentHolder
一个内部显示对象，是所有项呈示器、选择内容、亮显指示符以及其它支持图形的父级。 | ListBase | ||
| listContentStyleFilters : Object [只读]
从 ListBase 传递到 listContent 的一组样式。 | ListBase | ||
| listItems : Array [只读]
一个由数组组成的数组，其中包含用于呈示每个数据提供程序项目的 itemRenderer 实例。 | ListBase | ||
| maskShape : Shape
遮罩。 | ScrollControlBase | |
| modifiedCollectionView : ModifiedCollectionView
集合视图，用于暂时保留上次的数据提供程序状态，以方便运行数据更改效果。 | ListBase | ||
| offscreenExtraColumns : int = 0
用于控件布局的项呈示器的额外列的目标数量。 | ListBase | ||
| offscreenExtraColumnsLeft : int = 0
当前位于最左侧可视列左侧的屏幕外的列数。 | ListBase | ||
| offscreenExtraColumnsRight : int = 0
当前位于最右侧可视列右侧的屏幕外的列数。 | ListBase | ||
| offscreenExtraRows : int = 0
要用于控件布局的项呈示器中额外行的目标数量。 | ListBase | ||
| offscreenExtraRowsBottom : int = 0
当前位于底部可视呈示器下方的屏幕外的项目数。 | ListBase | ||
| offscreenExtraRowsOrColumnsChanged : Boolean = false
一个标志，指示屏幕外的行数或列数可能已更改。 | ListBase | ||
| offscreenExtraRowsTop : int = 0
当前位于最顶部可见行上方的屏幕外的行数。 | ListBase | ||
| rendererChanged : Boolean = false
一个标志，指示呈示器已更改。 | ListBase | ||
| reservedItemRenderers : Object
当前闲置但近期可能会用到的项呈示器的哈希映射。 | ListBase | ||
| resourceManager : IResourceManager [只读]
对管理所有应用程序本地化资源的对象的引用。 | UIComponent | |
| rowInfo : Array [只读]
ListRowInfo 对象数组，这些对象用于缓存行高和 listItems 中行的其它跟踪信息。 | ListBase | ||
| rowMap : Object
项呈示器与其各自 ListRowInfo 对象的哈希映射。 | ListBase | ||
| runDataEffectNextUpdate : Boolean = false
一个标志，指示下次更新显示时是否应该启动数据效果。 | ListBase | ||
| runningDataEffect : Boolean = false
一个标志，指示当前是否正在运行数据更改效果。 | ListBase | ||
| scrollAreaChanged : Boolean
一个标志，指示滚动区域随滚动条的出现或消失进行更改。 | ScrollControlBase | |
| selectedData : Object
用于跟踪当前所选项目的 ListBaseSelectionData 对象的哈希表。 | ListBase | ||
| selectionIndicators : Object
所选指示符的哈希表。 | ListBase | ||
| selectionLayer : Sprite
listContent 中的图层，用于绘制所有选择内容和加亮指示符。 | ListBase | ||
| selectionTweens : Object
所选内容补间的哈希表。 | ListBase | ||
| showCaret : Boolean
一个标志，指示是否显示尖号。 | ListBase | ||
| unconstrainedRenderers : Dictionary
不受列表布局算法影响的项呈示器的哈希映射。 | ListBase | ||
| unscaledHeight : Number [只读]
用于确定组件的未缩放高度的简便方法。 | UIComponent | |
| unscaledWidth : Number [只读]
用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成，还应将此宽度作为参数传递到 updateDisplayList() 中。 | UIComponent | |
| verticalScrollBar : ScrollBar
垂直滚动条。 | ScrollControlBase | |
| visibleData : Object [只读]
视图中当前使用的数据提供程序项呈示器的哈希表。 | ListBase | ||
| wordWrapChanged : Boolean = false
一个标志，指示自上次更新显示列表后 wordWrap 属性值是否已更改。 | ListBase | ||
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
ListBase()
构造函数。 | ListBase | ||
|
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
|
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
如果正在运行数据更改效果，则添加项呈示器。 | ListBase | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
|
将非可视样式客户端添加到该组件实例。 | UIComponent | |
|
表示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
返回将放置项目添加到放置目标中的位置的索引。 | ListBase | ||
|
排队稍后调用的函数。 | UIComponent | |
|
删除此组件实例的样式属性。 | UIComponent | |
|
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
|
将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | |
|
将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | |
|
返回标识此容器中的子项的一组属性。 | UIComponent | |
|
返回标识此容器中的子项的一组属性。 | UIComponent | |
创建一个给定了数据对象的项呈示器。 | ListBase | ||
|
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | |
|
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | |
|
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | |
| [覆盖]
将事件调度到事件流中。 | UIComponent | |
|
在此组件周围显示或隐藏焦点指示符。 | UIComponent | |
| drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | |
|
停止在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
|
开始在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
|
结束组件上当前播放的所有效果。 | UIComponent | |
|
执行 UIComponent 对象是目标的所有绑定。 | UIComponent | |
根据 String 查找列表中的项目，并将所选内容移至该项目。 | ListBase | ||
|
打印完成后调用。 | UIComponent | |
|
在指定的索引位置提供自动化对象。 | UIComponent | |
|
提供自动化对象列表。 | UIComponent | |
|
返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
|
按指定的元素大小，返回元素边界的 x 坐标。 | UIComponent | |
|
按指定的元素大小，返回元素边界的 y 坐标。 | UIComponent | |
|
返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | |
|
返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
|
返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | |
|
查找此 UIComponent 实例的类型选择器。 | UIComponent | |
|
返回一个约束布局值，这与获取此组件的约束样式的方式类似。 | UIComponent | |
|
确定是使用显式高度还是测量高度的一种简便方法
| UIComponent | |
|
确定是使用显式宽度还是测量宽度的一种简便方法
| UIComponent | |
|
获取当前具有焦点的对象。 | UIComponent | |
返回相应的工厂；如果尚未指定，则使用默认工厂。 | ListBase | ||
|
返回元素的布局高度。 | UIComponent | |
|
返回元素的布局宽度。 | UIComponent | |
|
返回元素在屏幕上进行绘制时所用的 x 坐标。 | UIComponent | |
|
返回元素在屏幕上进行绘制时所用的 y 坐标。 | UIComponent | |
|
返回用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | |
|
返回此元素的布局转换 Matrix3D。 | UIComponent | |
|
返回元素的最大高度。 | UIComponent | |
|
返回元素的最大宽度。 | UIComponent | |
|
返回元素的最小高度。 | UIComponent | |
|
返回元素的最小宽度。 | UIComponent | |
|
返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。 | DisplayObjectContainer | |
|
返回元素的首选高度。 | UIComponent | |
|
返回元素的首选宽度。 | UIComponent | |
|
返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。 | DisplayObject | |
返回 true 或 false 以指示是否应在目标上播放效果。 | ListBase | ||
|
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目；如果此 Repeater 未重复，则返回 null。 | UIComponent | |
|
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
|
将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | |
|
将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。 | DisplayObject | |
|
将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。 | DisplayObject | |
|
如果 currentCSSState 不为 null，则返回 true。 | UIComponent | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
确定是否已在此 UIComponent 上定义指定的状态。 | UIComponent | |
在鼠标指针下方隐藏指示允许执行拖放操作的拖放指示符。 | ListBase | ||
|
计算显示对象的边框，以确定它是否与 obj 显示对象的边框重叠或相交。 | DisplayObject | |
|
计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
|
返回一个框 Matrix，在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | |
针对数据提供程序中某个项目的索引获取项呈示器（如果存在）。 | ListBase | ||
计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。 | ListBase | ||
|
初始化此组件的内部结构。 | UIComponent | |
|
初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | |
|
标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
|
由某个组件的项目进行调用，以指示其 depth 属性已更改。 | UIComponent | |
|
当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。 | UIComponent | |
在下次更新时刷新所有行。 | ListBase | ||
|
标记组件，以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
|
标记组件，以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
确定是否加亮显示数据提供者项目的项呈示器（当鼠标滑过它，或者通过键盘导航使它位于尖号下方时）。 | ListBase | ||
确定数据提供程序项目的项呈示器是否可选。 | ListBase | ||
确定是否已选中数据提供程序项目的项呈示器。 | ListBase | ||
确定数据提供程序项的项呈示器是否为键盘导航后位于尖号下方的项。 | ListBase | ||
确定呈示器是否显示某个项目。 | ListBase | ||
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
确定呈示器是否包含（或拥有）显示对象。 | ListBase | ||
返回通过此项呈示器呈示的该项目在数据提供程序中的项目索引。 | ListBase | ||
返回呈示器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。 | ListBase | ||
根据 iconField 和 iconFunction 属性返回表示数据项目图标的类（如果存在）。 | ListBase | ||
返回数据提供程序中给定项目的项呈示器（如果存在）。 | ListBase | ||
返回呈示器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。 | ListBase | ||
|
将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。 | DisplayObject | |
|
将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | |
|
将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。 | DisplayObject | |
|
如果 cssState 与 currentCSSState 匹配，则返回 true。 | UIComponent | |
|
确定此实例与给定类型相同，还是属于给定类型的子类。 | UIComponent | |
使用当前项呈示器测量数据提供程序中的一组项目，并返回这些项目的高度之和。 | ListBase | ||
|
测量指定的 HTML 文本（该文本中可能包含 <font> 和 <b> 等 HTML 标签），假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。 | UIComponent | |
|
测量指定的文本，假定该文本使用由此 UIComponent 的样式确定的 UITextFormat 显示在单行 UITextField（或 UIFTETextField）中。 | UIComponent | |
使用当前项呈示器测量数据提供程序中的一组项目，并返回找到的最大宽度。 | ListBase | ||
|
将组件移动到其父项内的指定位置。 | UIComponent | |
|
将样式更改传播到子项。 | UIComponent | |
|
如果 owner 属性链从 child 指向此 UIComponent，则返回 true。 | UIComponent | |
|
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | |
|
准备 IFlexDisplayObject 用于打印。 | UIComponent | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
为此组件及其所有后代生成或重新生成 CSS 样式缓存，前提条件是递归参数为 true。 | UIComponent | |
|
针对每个效果事件，将 EffectManager 注册为一个事件侦听器。 | UIComponent | |
|
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | |
|
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | |
|
从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。 | DisplayObjectContainer | |
如果正在运行数据更改效果，则移除项呈示器。 | ListBase | ||
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
|
从该组件实例删除非可视样式客户端。 | UIComponent | |
|
重放指定的事件。 | UIComponent | |
|
显示虚拟键盘。 | InteractiveObject | |
|
使用提供的 ID 解析子项。 | UIComponent | |
| [静态]
在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
确保给定索引处的数据提供程序项目可见。 | ListBase | ||
|
调整对象大小。 | UIComponent | |
|
更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | |
|
设置一个布局约束值的方式，与设置此组件的约束样式的方式相同。 | UIComponent | |
|
设置当前状态。 | UIComponent | |
|
设置此组件的焦点。 | UIComponent | |
|
设置元素在屏幕上进行绘制时所用的坐标。 | UIComponent | |
|
设置元素的布局大小。 | UIComponent | |
|
设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。 | UIComponent | |
|
设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。 | UIComponent | |
|
设置循环操作动态属性的可用性。 | Object | |
|
对此组件实例设置样式属性。 | UIComponent | |
|
当 visible 属性发生更改时调用。 | UIComponent | |
在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。 | ListBase | ||
|
允许用户拖动指定的 Sprite。 | Sprite | |
|
使用户可以在启用触摸的设备上拖动指定的 Sprite。 | Sprite | |
|
对源起于此对象的所有 MovieClip 递归停止时间轴执行。 | DisplayObjectContainer | |
|
结束 startDrag() 方法。 | Sprite | |
|
结束 startTouchDrag() 方法，用于启用触摸的设备。 | Sprite | |
|
检测对样式属性的更改。 | UIComponent | |
|
首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。 | UIComponent | |
| [静态]
阻止对使用 callLater() 排队的方法进行背景处理，直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
|
交换两个指定子对象的 Z 轴顺序（从前到后顺序）。 | DisplayObjectContainer | |
|
在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。 | DisplayObjectContainer | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
| [覆盖]
返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | |
| transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
用于更新转换的旋转、缩放和平移的一种实用程序方法，同时保留某个特定点，该点是在组件自己的坐标空间中指定的，且在父项的坐标空间中是固定的。 | UIComponent | |
|
一种实用程序方法，用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。 | UIComponent | |
如果对应于特定数据项目的项呈示器需要移动到控件中项呈示器的正常位置之外，则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。 | ListBase | ||
|
验证子项的位置和大小，并绘制其他可视内容。 | UIComponent | |
|
验证并更新此对象的属性和布局，如果需要的话重绘对象。 | UIComponent | |
|
由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | |
|
如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法，随后在测量时调用了 validateSize() 方法，则验证组件的度量大小。 | UIComponent | |
|
处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | |
|
返回指定对象的原始值。 | Object | |
|
返回一个框 Matrix，在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
受保护的方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
作为拖放操作的一部分，将所选项目添加到 DragSource 对象。 | ListBase | ||
将呈示器添加到循环使用的呈示器列表，使其不可见并清除对该呈示器的引用。 | ListBase | ||
从用于存储对行的引用的数组开头添加一个空白行。 | ListBase | ||
|
调整焦点矩形。 | UIComponent | |
从 updateDisplayList() 方法中调用，用以调整 listContent 的大小和位置。 | ListBase | ||
|
提交计算的矩阵，该矩阵是基于布局矩阵以及 flash displayObject 的转换的转换偏移量而构建的。 | UIComponent | |
设置应用选择指示符的效果。 | ListBase | ||
|
这是一个内部方法，供 Flex 框架用于支持 Dissolve 效果。 | UIComponent | |
在执行拖放操作时计算拖放指示符的 y 位置。 | ListBase | ||
|
确定是否可以跳过对 measure() 方法的调用。 | UIComponent | |
|
创建子对象后执行任何最终处理。 | UIComponent | |
清除给定 Sprite 中的尖号指示符。 | ListBase | ||
清除给定 Sprite 中的加亮指示符。 | ListBase | ||
删除所有选定、加亮显示和尖号指示符。 | ListBase | ||
清除所选项目组，并移除表示那些项目的选定状态的所有图形。 | ListBase | ||
清空 visibleData 哈希表。 | ListBase | ||
当数据发生更改时，处理从数据提供程序中调度的 CollectionEvent。 | ListBase | ||
[覆盖]
根据是否已显式设置 columnCountcolumnWidth、rowHeight 和 rowCount 等属性来计算列宽、行高以及行数和列数。 | ListBase | ||
根据行数、列数以及可查看的行和列配置 ScrollBar。 | ListBase | ||
通过调用 ObjectUtil.copy() 方法为此对象制作一个深层副本，然后通过调用 UIDUtil.createUID() 方法用一个新值替代该副本的 uid 属性（如果存在）。 | ListBase | ||
按照选择时的顺序复制所选项目。 | ListBase | ||
|
为此组件创建边框。 | ScrollControlBase | |
[覆盖]
创建对象作为此 ListBase 的子对象，在这种情况下为将容纳所有项呈示器的 listContent 对象。 | ListBase | ||
|
根据所用的嵌入字体使用上下文创建新对象。 | UIComponent | |
|
使用给定的 moduleFactory 创建对象。 | UIComponent | |
循环使用不再需要的行，并删除其指示符。 | ListBase | ||
|
更新属性时调度 PropertyChangeEvent 的 Helper 方法。 | UIComponent | |
处理 DragEvent.DRAG_COMPLETE 事件。 | ListBase | ||
处理 DragEvent.DRAG_DROP 事件。 | ListBase | ||
处理 DragEvent.DRAG_ENTER 事件。 | ListBase | ||
处理 DragEvent.DRAG_EXIT 事件。 | ListBase | ||
处理 DragEvent.DRAG_OVER 事件。 | ListBase | ||
Interval 函数，用于在鼠标位于列表上方或下方时上下滚动列表。 | ListBase | ||
dragStart 事件的默认处理函数。 | ListBase | ||
drawCaretIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void
使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制尖号指示符。 | ListBase | ||
drawHighlightIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void
使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制加亮指示符。 | ListBase | ||
drawItem(item:IListItemRenderer, selected:Boolean = false, highlighted:Boolean = false, caret:Boolean = false, transition:Boolean = false):void
绘制带有指示符（加亮显示的或选中的）或尖号的呈示器。 | ListBase | ||
绘制行中所有交替行的颜色、边框和背景。 | ListBase | ||
drawSelectionIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void
使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制选择指示符。 | ListBase | ||
尝试在数据提供程序中查找下一个以 eventCode 参数中的字符开头的项目。 | ListBase | ||
在数据更改效果运行完毕后，通过恢复原始集合和迭代器并移除此效果使用的所有缓存值进行清理。 | ListBase | ||
基于 caretIndex 和 anchorIndex 属性设置所选项目。 | ListBase | ||
|
当 UIComponent 对象获得焦点时调用的事件处理函数。 | UIComponent | |
|
当 UIComponent 对象失去焦点时调用的事件处理函数。 | UIComponent | |
检索已创建但当前未使用的项呈示器。 | ListBase | ||
给定索引处数据提供程序项目所在的列。 | ListBase | ||
给定索引处数据提供程序项目所在的行。 | ListBase | ||
|
对于组件的某些不常使用的高级布局功能，初始化其实现和存储。 | UIComponent | |
|
完成对此组件的初始化。 | UIComponent | |
|
初始化此组件的辅助功能代码。 | UIComponent | |
当数据提供程序中发生更改时应用数据更改效果。 | ListBase | ||
|
此对象影响其布局时（includeInLayout 为 true），使父代大小和显示列表失效的 Helper 方法。 | UIComponent | |
|
通常由包含 UITextField 对象的组件覆盖，其中 UITextField 对象获取焦点。 | UIComponent | |
如果项呈示器不再根据列表的布局算法定位，则返回 true，尽管由于调用 unconstrainRenderer() 方法正在运行数据更改效果。 | ListBase | ||
返回一个包含项呈示器的 columnIndex 和 rowIndex 的点。 | ListBase | ||
确定数据提供程序项目的 UID。 | ListBase | ||
|
为 keyDown 事件调用的事件处理函数。 | UIComponent | |
|
为 keyUp 事件调用的事件处理函数。 | UIComponent | |
|
通过设置此控件边框的位置和大小来响应大小更改。 | ScrollControlBase | |
makeRowsAndColumns(left:Number, top:Number, right:Number, bottom:Number, firstColumn:int, firstRow:int, byCount:Boolean = false, rowsNeeded:uint = 0):Point
创建足够的行和列以填充左侧、顶部、右侧和底部描述的区域。 | ListBase | ||
[覆盖]
根据 rowCount、columnCount、rowHeight 和 columnWidth 属性计算组件的度量宽度和高度。 | ListBase | ||
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_CLICK 事件。 | ListBase | ||
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_DOUBLE_CLICK 事件。 | ListBase | ||
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_DOWN 事件。 | ListBase | ||
确定哪种项呈示器位于鼠标下方。 | ListBase | ||
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_MOVE 事件。 | ListBase | ||
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_OUT 事件。 | ListBase | ||
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_OVER 事件。 | ListBase | ||
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_DOWN 事件。 | ListBase | ||
[覆盖]
通过更改滚动位置处理 mouseWheel 事件。 | ListBase | ||
水平移动所选项目并加亮指示符。 | ListBase | ||
垂直移动所选项目并加亮指示符。 | ListBase | ||
垂直移动行，并更新 rowInfo 记录。 | ListBase | ||
沿水平方向移动所选项目，以响应用户使用向左键或向右键以及功能键（如 Shift 和 Ctrl 键）选择项目的操作。 | ListBase | ||
沿垂直方向移动所选项目，以响应用户使用向上键或向下键以及功能键（如 Shift 和 Ctrl 键）选择项目的操作。 | ListBase | ||
准备集合事件的数据效果。 | ListBase | ||
当呈示器发生更改时，updateDisplayList() 方法将调用此方法，用以删除现有的项呈示器并清理各种缓存结构。 | ListBase | ||
更新 visibleData 哈希表中的键。 | ListBase | ||
从用于存储对行的引用的数组中删除一行。 | ListBase | ||
清理数据提供程序中给定项目的选项亮显及其他关联图形。 | ListBase | ||
|
构建 UIComponent 时将调用此方法，并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时，都会再次调用此方法。 | UIComponent | |
从用于存储对行的引用的数组开头删除请求的行数。 | ListBase | ||
|
确定此组件中的空间是否足以显示给定的滚动条。 | ScrollControlBase | |
|
scroll 事件的默认事件处理函数。 | ScrollControlBase | |
调整呈示器以响应滚动位置的更改。 | ListBase | ||
返回给定滚动位置第一个可见行和列处的项目的数据提供程序索引。 | ListBase | ||
调整呈示器以响应滚动位置的更改。 | ListBase | ||
当由于页面错误而导致寻找失败时的默认故障处理函数。 | ListBase | ||
当由于页面错误而导致寻找失败时的默认结果处理函数。 | ListBase | ||
搜索位置，并在必要时处理 ItemPendingError。 | ListBase | ||
selectItem(item:IListItemRenderer, shiftKey:Boolean, ctrlKey:Boolean, transition:Boolean = true):Boolean
如果使用鼠标单击提供的项呈示器，并且键盘功能键处于给定状态，则更新所选项目组。 | ListBase | ||
设置 rowCount 属性不会导致 invalidation，也不会设置将永久锁定行数的 explicitRowCount 属性。 | ListBase | ||
设置 rowHeight 属性不会导致 invalidation，也不会设置将永久锁定行高的 explicitRowHeight。 | ListBase | ||
|
使 ScrollControlBase 基于传递的参数显示或隐藏滚动条。 | ScrollControlBase | |
|
在水平方向和垂直方向上，指定转换拉伸因子。 | UIComponent | |
移动引用多行的数组中的某一行。 | ListBase | ||
|
当状态改变以检查状态特定的样式是否应用到此组件时，会调用此方法。 | UIComponent | |
确定所请求的行集的高度。 | ListBase | ||
从用于存储对行的引用的数组末端删除所有剩余行。 | ListBase | ||
如果项呈示器可见，则根据其 UID 进行查找。 | ListBase | ||
[覆盖]
当可显示的项目数发生更改时添加或移除项呈示器。 | ListBase | ||
刷新所有行。 | ListBase | ||
事件
| 事件 | 摘要 | 由以下参数定义 | ||
|---|---|---|---|---|
| [广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | ||
| 当组件通过使用 addChild()、addChildAt()、addElement() 或 addElementAt() 方法作为内容子项添加到容器后调度。 | UIComponent | ||
| 将显示对象添加到显示列表中时调度。 | DisplayObject | ||
| 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | ||
| 当用户操作导致 selectedIndex 或 selectedItem 属性发生变化时调度此事件。 | ListBase | |||
| 当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。 | InteractiveObject | ||
| 用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。 | InteractiveObject | ||
| 当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | ||
| 在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。 | InteractiveObject | ||
| 当组件完成其构建、属性处理、测量、布置和绘制时调度。 | UIComponent | ||
| 视图状态更改后调度。 | UIComponent | ||
| 在 currentState 属性更改后但视图状态更改前调度。 | UIComponent | ||
| 在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。 | InteractiveObject | ||
| 当 data 属性更改时进行调度。 | ListBase | |||
| [广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | ||
| 如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true，当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | ||
| 在拖动操作完成时（将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时）由拖动启动器（作为要拖动的数据源的组件）调度。 | UIComponent | ||
| 用户在放置目标上释放鼠标时由放置目标调度。 | UIComponent | ||
| 当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时，由该组件调度。 | UIComponent | ||
| 用户在组件外拖动但没有将数据放置到目标时，由组件调度。 | UIComponent | ||
| 在拖动操作期间，当用户在鼠标位于组件上方的情况下移动鼠标时，由组件调度。 | UIComponent | ||
| 启动拖动操作时，由拖动启动器调度。 | UIComponent | ||
| 在一个效果结束后调度。 | UIComponent | ||
| 在即将开始播放效果前调度。 | UIComponent | ||
| 在停止某个效果（仅当对该效果调用 stop() 时发生）之后调度。 | UIComponent | ||
| [播放事件] 播放头进入新帧时调度。 | DisplayObject | ||
| 在组件已进入视图状态之后调度。 | UIComponent | ||
| [广播事件] 播放头退出当前帧时调度。 | DisplayObject | ||
| 在组件即将退出视图状态之前调度。 | UIComponent | ||
| 显示对象获得焦点后调度。 | InteractiveObject | ||
| 显示对象失去焦点后调度。 | InteractiveObject | ||
| [广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。 | DisplayObject | ||
| 当用户使用 InteractiveObject 实例沿触摸面边缘创建接触点时调度（如在 Siri Remote for Apple TV 上沿触摸面边缘轻击）。有些设备也可能将这种接触解释为多个触摸事件的组合。 | InteractiveObject | ||
| 当用户在启用触摸设备上的同一 InteractiveObject 实例上按下两个接触点时（例如，在配有触摸屏的移动电话或平板电脑上的显示对象上按下和释放两个手指）调度。 | InteractiveObject | ||
| 当用户在启用触摸的设备上的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上的显示对象上从左向右移动手指）调度。 | InteractiveObject | ||
| 当用户在接触点处使用 InteractiveObject 实例执行旋转手势时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或平板电脑上的显示对象上旋转这两个手指）调度。 | InteractiveObject | ||
| 当用户在接触点处使用 InteractiveObject 实例执行滑动手势（例如，在配有触摸屏的移动电话或平板电脑上用三根手指触摸屏幕，然后在一个显示对象上平行移动这三根手指）时调度。 | InteractiveObject | ||
| 当用户使用 InteractiveObject 实例创建接触点，然后点击启用触屏的设备时（例如，将几个手指放在显示对象上以打开菜单，然后点击一个手指在配有触摸屏的移动电话或平板电脑上选择一个菜单项）调度。 | InteractiveObject | ||
| 当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或平板电脑上的显示对象上快速分开手指）调度。 | InteractiveObject | ||
| 当对象的状态从可见变为不可见时调度。 | UIComponent | ||
| 此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序 | InteractiveObject | ||
| 当组件完成构建并设置了所有初始化属性后调度。 | UIComponent | ||
| 当组件由 Validator 监控且未通过验证时调度。 | UIComponent | ||
| 当用户单击控件中的某个项目时调度此事件。 | ListBase | |||
| 当用户双击控件中的某个项目时调度此事件。 | ListBase | |||
| 当用户将鼠标指针移出控件中的某个项目时调度此事件。 | ListBase | |||
| 当用户将鼠标指针滚至控件中的某个项目时调度此方法。 | ListBase | |||
| 用户按下某个键时调度。 | InteractiveObject | ||
| 用户尝试使用键盘导航更改焦点时调度。 | InteractiveObject | ||
| 用户释放某个键时调度。 | InteractiveObject | ||
| 当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | ||
| 当用户在使用 PopUpManager 打开的某个组件外部单击时，从该组件调度。 | UIComponent | ||
| 用户尝试使用指针设备更改焦点时调度。 | InteractiveObject | ||
| 用户移动 InteractiveObject 上的指针设备时调度。 | InteractiveObject | ||
| 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | ||
| 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
| 当鼠标滚轮滚动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
| 当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时，从该组件调度。 | UIComponent | ||
| 移动对象后调度。 | UIComponent | ||
| 当用户释放拖动手势时由拖动启动器 InteractiveObject 调度。 | InteractiveObject | ||
| 在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。 | InteractiveObject | ||
| 当拖动手势进入其边界时由 InteractiveObject 调度。 | InteractiveObject | ||
| 当拖动手势离开其边界时由 InteractiveObject 调度。 | InteractiveObject | ||
| 当拖动手势保持在其边界内时，由 InteractiveObject 持续调度。 | InteractiveObject | ||
| 在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | ||
| 在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | ||
| 在用户为粘贴操作激活特定于平台的加速键组合或从文本上下文菜单中选择“粘贴”时调度。 | InteractiveObject | ||
| 在组件初始化序列开始时调度。 | UIComponent | ||
| 当用户将活动笔针放低经过屏幕的邻近检测阈值上时调度。 | InteractiveObject | ||
| 当用户将活动笔针抬高放在屏幕的邻近检测阈值上时调度。 | InteractiveObject | ||
| 当用户将活动笔针移动到屏幕上但仍保留在邻近检测阈值中时调度。 | InteractiveObject | ||
| 当用户直接将活动笔针从此 InteractiveObject 上移开但仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | ||
| 当用户直接将活动笔针移动到此 InteractiveObject 上但仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | ||
| 当用户从此 InteractiveObject 及其任一子项中移开而仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | ||
| 当用户将活动笔针从显示列表中子项的对象树中滑过此 InteractiveObject 时（而仍保留在屏幕的邻近检测阈值中）时调度。 | InteractiveObject | ||
| 在用户首先在 InteractiveObject 实例上按下按钮，然后将指针设备移离 InteractiveObject 实例，释放指针设备上的按钮时调度。 | InteractiveObject | ||
| 当组件通过使用 removeChild()、removeChildAt()、removeElement() 或 removeElementAt() 方法作为内容子项从容器中删除后调度。 | UIComponent | ||
| 将要从显示列表中删除显示对象时调度。 | DisplayObject | ||
| 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | ||
| [广播事件] 将要更新和呈现显示列表时调度。 | DisplayObject | ||
| 在调整组件大小时调度。 | UIComponent | ||
| 当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
| 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | ||
| 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
| 当滚动内容时调度。 | ScrollControlBase | ||
| 在用户为全选操作激活特定于平台的加速键组合或从文本上下文菜单中选择“全选”时调度。 | InteractiveObject | ||
| 当对象的状态从不可见变为可见时调度。 | UIComponent | ||
| 在放开软键盘之后立即调度。 | InteractiveObject | ||
| 在放开软键盘之前立即调度。 | InteractiveObject | ||
| 在隐藏软键盘之后立即调度。 | InteractiveObject | ||
| 在组件进入新状态且切换到该状态的状态转换动画已经播放完时调度。 | UIComponent | ||
| 在组件中断转换到当前状态从而切换到新状态时调度。 | UIComponent | ||
| 对象的 tabChildren 标志值发生更改时调度。 | InteractiveObject | ||
| 对象的 tabEnabled 标志发生更改时调度。 | InteractiveObject | ||
| 对象的 tabIndex 属性值发生更改时调度。 | InteractiveObject | ||
| 当用户输入一个或多个文本字符时调度。 | InteractiveObject | ||
| 要创建 ToolTip 时由组件调度。 | UIComponent | ||
| 已隐藏组件的 ToolTip 并要将其放弃时由组件调度。 | UIComponent | ||
| 要隐藏组件的 ToolTip 时由组件调度。 | UIComponent | ||
| 要显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
| 显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
| 用户将鼠标移动到设置了 toolTip 属性的组件上方后，由该组件调度。 | UIComponent | ||
| 当用户第一次触摸启用触摸的设备时（例如，用手指触摸配有触摸屏的移动电话或平板）调度。 | InteractiveObject | ||
| 当用户移除与启用触摸的设备的接触时（例如，将手指从配有触摸屏的移动电话或平板电脑上抬起）调度。 | InteractiveObject | ||
| 不可撤消事件，在组件结束响应 touch 交互用户操作时由组件调度。 | UIComponent | ||
| 不可撤消事件，在组件开始响应 touch 交互用户操作时由组件调度。 | UIComponent | ||
| 可撤消事件，在组件试图响应 touch 交互用户操作时由组件调度。 | UIComponent | ||
| 当用户触碰设备时进行调度，而且会连续调度，直到接触点被删除。 | InteractiveObject | ||
| 当用户将接触点从启用触摸的设备上的 InteractiveObject 实例移开时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从一个显示对象拖到另一个显示对象）调度。 | InteractiveObject | ||
| 当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。 | InteractiveObject | ||
| 当用户移动接触点，使其远离启用触摸的设备上的 InteractiveObject 实例时（例如，在配有触摸屏的移动电话或平板电脑上将一个手指从显示对象上的一点移动到显示对象外的一点）调度。 | InteractiveObject | ||
| 当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。 | InteractiveObject | ||
| 当用户在启用触摸设备上的已启动接触的同一 InteractiveObject 实例上抬起接触点时（例如，在配有触摸屏的移动电话或平板的显示对象上的某一点处按下并释放手指）调度。 | InteractiveObject | ||
| 当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度（如果需要）。 | UIComponent | ||
| 当组件由 Validator 监控并且成功通过验证时调度。 | UIComponent | ||
| 当以编程方式或通过用户交互更改值时调度。 | UIComponent | ||
样式
样式为常见样式，或与特定主题关联。如果为常见样式，则可以用于任何主题。如果样式与特定主题关联，则只有应用程序使用该主题时才能使用该样式。
常见样式
| 样式 | 说明 | 由以下参数定义 | ||
|---|---|---|---|---|
alternatingItemColors | 类型: Array 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 列表中项目使用的背景色。此值是由一种或多种颜色组成的数组。列表项目的背景将交替使用此数组中的各种颜色。 对于 DataGrid 控件，行中的所有项目都使用相同的背景色，而每行的背景色都由颜色数组确定。 对于只使用一个列表填充二维显示的 TileList 控件，此样式可根据指定的列数、行数和颜色数生成棋盘外观、条纹或其它图案。TileList 循环使用各种颜色，根据布局方向设置各个项目的背景色。如果您的 TileList 为水平布局，并且颜色数和列数均为偶数，则显示条纹图案。如果列数为奇数，则显示棋盘图案。 默认值为 undefined。 | ListBase | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从内容区域的上边缘到控件的基线位置的垂直距离（以像素为单位）. | UIComponent | ||
| 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件的边框外观类. | ScrollControlBase | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 边框样式. | ScrollControlBase | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件底边到其父容器的内容区域底边之间的垂直距离（以像素为单位）. | UIComponent | ||
| 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件中文本（包括组件标签）的颜色. | ScrollControlBase | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件显示的文本的方向性. | ScrollControlBase | ||
| 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用时组件中文本的颜色. | ScrollControlBase | ||
dropIndicatorSkin | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用于指示所拖动项目的放置位置的外观。如果 ListBase 衍生的组件是拖放操作的潜在放置目标，则调用 showDropFeedback() 方法将产生此类的实例，并将该实例定位在所放置项目之后项目的 itemRenderer 上方一个像素处（如果进行放置）。
默认值为 mx.controls.listClasses.ListDropIndicator。 | ListBase | ||
| 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 验证失败时，组件加亮部分的颜色. | UIComponent | ||
| 类型: Number CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定焦点外观的 alpha 透明度值. | ScrollControlBase | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 焦点矩形使用的混合模式. | UIComponent | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定焦点矩形的哪些角应该是圆角. | ScrollControlBase | ||
| 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用于绘制焦点矩形的外观. | UIComponent | ||
| 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 焦点矩形轮廓的粗细（以像素为单位）. | UIComponent | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置内部 TextField 的 antiAliasType 属性. | ScrollControlBase | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 使用的字体的名称. | ScrollControlBase | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性. | ScrollControlBase | ||
| 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性. | ScrollControlBase | ||
| 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本的高度，以像素为单位. | ScrollControlBase | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用斜体. | ScrollControlBase | ||
| 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性. | ScrollControlBase | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用粗体. | ScrollControlBase | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的水平距离（以像素为单位）. | UIComponent | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 水平 scrollbar 的样式名称. | ScrollControlBase | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 2.5 该组件的主要交互模式. | UIComponent | ||
| 类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 一个布尔值，表示是启用 ( true) 还是禁用 (false) 字距调整. | ScrollControlBase | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.1 运行时版本: Flash10, AIR 1.5 指定组件的所需布局方向. | UIComponent | ||
| 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本行之间附加的垂直空间. | ScrollControlBase | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件左边到其父容器的内容区域左边之间的水平距离（以像素为单位）. | UIComponent | ||
| 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 各字符之间显示的附加像素数. | ScrollControlBase | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件显示的文本的区域设置. | ScrollControlBase | ||
paddingBottom | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 行的底部与该行中呈示器底部之间的像素数目。 默认值为 2。 | ListBase | ||
paddingLeft | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件左边框与其内容区域左边缘之间的像素数目。 默认值为 0。 在 Halo 主题中，Button 控件的默认值为 10，在 Spark 主题中，其默认值为 6。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 Tree 控件的默认值为 2。 | ListBase | ||
paddingRight | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件右边框与其内容区域右边缘之间的像素数目。 默认值为 0。 在 Halo 主题中，Button 控件的默认值为 10，在 Spark 主题中，其默认值为 6。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 | ListBase | ||
paddingTop | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 行的顶部与该行中呈示器顶部之间的像素数目。 默认值为 2。 | ListBase | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件右边到其父容器的内容区域右边之间的水平距离（以像素为单位）. | UIComponent | ||
rollOverColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用户将鼠标移到呈示器上时其背景的颜色。Halo 主题的默认值为 0xB2E1FF。Spark 主题的默认值为 0xCEDBEF。
| ListBase | ||
selectionColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用户选中呈示器时其背景的颜色。Halo 主题的默认值为 0x7FCEFF。Spark 主题的默认值为 0xA8C6EE。
| ListBase | ||
selectionDisabledColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用此组件时呈示器的背景色。 默认值为 0xDDDDDD。 | ListBase | ||
selectionDuration | 类型: Number 格式: Time CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 选择效果的持续时间。如果选中了某个项目，则在背景着色时会播放相应的效果。设置为 0 可禁用此效果。 默认值为 250。 | ListBase | ||
selectionEasingFunction | 类型: Function CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 针对选项效果的 easingFunction。如果选中了某个项目，则在背景着色时会播放相应的效果。默认效果为颜色的线性淡入淡出。easingFunction 可用于控制选择效果。 默认值为 undefined。 | ListBase | ||
| 类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 当此组件无效时，显示错误边框或外观 | UIComponent | ||
| 类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 如果此组件无效，当用户将鼠标移到它上方时，将显示错误提示 | UIComponent | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器内文本的对齐方式. | ScrollControlBase | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否加下划线. | ScrollControlBase | ||
| 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 实现此组件用来呈示文本的 IUITextField 的类. | ScrollControlBase | ||
| 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本第一行偏离容器左侧的距离（以像素为单位）. | ScrollControlBase | ||
textRollOverColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用户将鼠标移到呈示器上时其文本的颜色。Halo 主题的默认值为 0x2B333C。Spark 主题的默认值为 0x000000。
| ListBase | ||
textSelectedColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用户选中呈示器时其文本的颜色。Halo 主题的默认值为 0x2B333C。Spark 主题的默认值为 0x000000。
| ListBase | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件顶边到其父容器的内容区域顶边之间的垂直距离（以像素为单位）. | UIComponent | ||
useRollOver | 类型: Boolean CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 一个标志，控制当鼠标滚过项目时是否加亮显示该项目。如果为 true，则当鼠标滚过行时加亮显示这些行。如果为 false，则只在选中行时才进行加亮显示。
默认值为 true。 | ListBase | ||
verticalAlign | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 垂直对齐行中的呈示器。可能值包括 "top"、"middle" 和 "bottom"。DataGrid 根据此样式以及 paddingTop 和 paddingBottom 样式在行中定位呈示器。如果某一行上各列中项目的高度不等，则其它列表类不使用 verticalAlign，但项呈示器可以检查此样式属性，并根据检查结果调整其布局。
默认值为 "top"。 | ListBase | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的垂直距离（以像素为单位）. | UIComponent | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 垂直 scrollbar 的样式名称. | ScrollControlBase | ||
Spark 主题样式
Halo 主题样式
属性详细信息
actualCollection | 属性 |
protected var actualCollection:ICollectionView| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
通常存储于运行数据更改效果时使用的 collection 中的值副本。当数据更改效果未运行时，此值应为空。
actualIterator | 属性 |
protected var actualIterator:IViewCursor| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
通常存储于运行数据更改效果时使用的 iterator 中的值副本。
allowDragSelection | 属性 |
public var allowDragSelection:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示是否启用拖动选择。拖动选择能够通过拖动至某个项目来选中该项目；而在普通选择中，当鼠标悬停在要选择的项目上方时，不能按下鼠标按键。此功能适用于 ComboBox 下拉项，支持以下操作：当鼠标悬停在下拉按钮上方时按下鼠标按键，然后将鼠标拖动至下拉项选择一个项目。
默认值为 false。
allowItemSizeChangeNotification | 属性 |
allowMultipleSelection | 属性 |
allowMultipleSelection:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示是否允许您同时选择多个项目。如果为 true，则用户可以选择多个项目。没有禁止不连续选择的选项。标准复选选项始终有效（按住 Shift 键的同时单击、按住 Ctrl 键的同时单击）。
默认值为 false。
实现
public function get allowMultipleSelection():Boolean public function set allowMultipleSelection(value:Boolean):voidanchorBookmark | 属性 |
protected var anchorBookmark:CursorBookmark| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
作为锚点的项目的书签。借助书签，该组件可快速搜索项目集合中的某个位置。当选择锚点与尖号或加亮显示的项目之间的一组项目时，或在应用 Sort 或 Filter 后查找所选项目时，使用此属性。
anchorIndex | 属性 |
protected var anchorIndex:int = -1| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
作为选择锚点的数据提供程序中项目的偏移量。
cachedItemsChangeEffect | 属性 |
protected var cachedItemsChangeEffect:IEffect = null| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当控件的数据提供程序中发生更改时播放的效果，通过 itemsChangeEffect 样式设置。
caretBookmark | 属性 |
protected var caretBookmark:CursorBookmark| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
尖号下方项目的书签。借助书签，该组件可快速搜索项目集合中的某个位置。
caretIndex | 属性 |
protected var caretIndex:int = -1| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
作为选择尖号点的数据提供程序中项目的偏移量。
相关 API 元素
caretIndicator | 属性 |
protected var caretIndicator:Sprite| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
包含图形的 DisplayObject，该图形指示哪个呈示器是尖号。
caretItemRenderer | 属性 |
protected var caretItemRenderer:IListItemRenderer| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
尖号下方项目的呈示器。选择模型中包含一个锚点、一个尖号和一个加亮显示的项目。如果正在使用鼠标进行选择，则当鼠标滚过时，鼠标下方的项目将加亮显示。如果单击鼠标时不按住功能键（Shift 或 Ctrl），将清除所选项目集，并将选中加亮显示的项目，使其成为锚点。使用鼠标选择时不使用尖号。如果已存在一个锚点并使用 Shift 键选中了另一个项目，则将清除旧的所选项目组，并选中此项目与锚点之间的所有项目。按住 Ctrl 键的同时单击项目可切换对单个项目的选择，但不会移动锚点。
使用键盘选择项目时，如果箭头键未与功能键配合使用，则将清除旧选择并选择新项目，新项目将成为锚点和尖号，同时在加亮显示的选中内容周围显示尖号指示符。如果用户结合使用箭头键和 Shift 键，将清除旧的选择并选择锚点与新项目之间的项目。此时尖号将移至新项目。如果按住 Ctrl 键的同时按方向键，则只移动尖号。用户可以使用空格键切换尖号下的项目的选择。
caretUID | 属性 |
protected var caretUID:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
尖号下方项目的 UID。
collection | 属性 |
protected var collection:ICollectionView| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
用于提供数据提供程序的 ICollectionView。当设置 dataProvider 属性时，Flex 将根据需要包装数据提供程序以支持 ICollectionView 接口，并将此属性设置为该结果。然后，ListBase 类使用此属性访问提供程序中的数据。获取 dataProvider 属性后，Flex 将返回此值。
columnCount | 属性 |
columnWidth | 属性 |
data | 属性 |
data:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
将此组件用作项呈示器或项目编辑器时，此组件应呈示的数据提供程序中的项目。列表类将在各个呈示器或编辑器上设置此属性，并且组件将显示数据。ListBase-derived 类支持将此属性用于复杂情况，例如存在 DataGrid 列表或者 DataGrid（其中一列就是一个 List）的情况。
除了 data 属性外，列表类还使用 listData 属性，用以确定显示内容。如果列表类位于 DataGrid 中，则它需要将列的 dataField 属性映射到数据中的某个属性，并为该属性设置 selectedItem 值。如果列表类位于 List 或 TileList 控件中，则它需要将列表的 labelField 属性映射到数据中的某个属性，并为该属性设置 selectedItem 值。否则，它会将 selectedItem 设置为数据本身。
此属性使用数据提供程序，但不对其进行设置。在任何情况下，都必须以其它方式设置数据提供程序。
不要以 MXML 方式设置此属性。
此属性可用作数据绑定的源。修改此属性后，将调度 dataChange 事件。
实现
public function get data():Object public function set data(value:Object):void相关 API 元素
dataEffectCompleted | 属性 |
protected var dataEffectCompleted:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示数据更改效果已完成。组件的响应方式通常是在下次调用 updateDisplayList() 时清除各种内部数据结构。
dataItemWrappersByRenderer | 属性 |
protected var dataItemWrappersByRenderer:Dictionary| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
将项呈示器映射到 ItemWrappers（用于提供其数据）的 dictionary。仅当运行数据效果时才适用。
dataProvider | 属性 |
dataProvider:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
要查看的数据集。此属性允许您将大多数类型的对象用作数据提供程序。如果将 dataProvider 属性设置为 Array，则会将其转换为 ArrayCollection。如果将该属性设置为 XML 对象，则会将其转换为仅包含一个项目的 XMLListCollection。如果将该属性设置为 XMLList，则会将其转换为 XMLListCollection。如果将该属性设置为实现 IList 或 ICollectionView 接口的对象，则可直接应用此对象。
受转换操作的影响，在您获取 dataProvider 属性时，该属性值将始终为 ICollectionView，所以此值不一定是您设置的对象类型。如果要修改数据提供程序中的数据，则了解以下行为非常重要：可能不会检测对原始数据所做的更改，但将检测对从 dataProvider 属性获取的 ICollectionView 对象所做的更改。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 collectionChange 事件。
实现
public function get dataProvider():Object public function set dataProvider(value:Object):void相关 API 元素
dataTipField | 属性 |
dataTipField:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
数据提供程序项目中作为数据提示显示的字段名称。默认情况下，该列表将在每个项目上查找 label 属性并将其显示出来。但是，如果数据对象中不包含 label 属性，则可以将 dataTipField 属性设置为使用数据对象中的其它属性。例如，在查看从数据库中检索的一组人名时，可以使用“FullName”。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 dataTipFieldChanged 事件。
实现
public function get dataTipField():String public function set dataTipField(value:String):voiddataTipFunction | 属性 |
dataTipFunction:Function| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
用户提供的函数，在各个项目上运行以确定其数据提示。默认情况下，该列表将在每个数据提供程序项目上查找 label 属性并将其显示出来。但是，一些项目不包含 label 属性，也不包含可供在行中显示的其它属性。例如，数据集中包含 lastName 和 firstName 字段，但您希望显示全名。您可以提供一个 dataTipFunction，用于查找合适的字段并返回可显示的字符串。dataTipFunction 还非常适用于处理格式设置和本地化。
dataTipFunction 仅使用数据提供程序中的某个项目作为唯一自变量并返回一个字符串，如以下示例所示：
myDataTipFunction(item:Object):String
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 dataTipFunctionChanged 事件。
实现
public function get dataTipFunction():Function public function set dataTipFunction(value:Function):voiddefaultColumnCount | 属性 |
protected var defaultColumnCount:int = 4| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
要显示的默认列数。当尝试根据大小或内容计算 columnCount 时，如果计算所得的列数值小于 1，则使用此值。
默认值为 4。
defaultRowCount | 属性 |
protected var defaultRowCount:int = 4| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
要显示的默认行数。当尝试根据大小或内容计算 rowCount 时，如果计算所得的列数值小于 1，则使用此值。
默认值为 4。
dragEnabled | 属性 |
dragImage | 属性 |
dragImage:IUIComponent [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
获取可显示拖放操作中的可视效果的类实例。
默认值为 mx.controls.listClasses.ListItemDragProxy。
实现
protected function get dragImage():IUIComponentdragImageOffsets | 属性 |
dragMoveEnabled | 属性 |
dragMoveEnabled:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示在拖放操作过程中是否可以移动控件中的项目，而不只是从控件中复制这些项目。如果此属性设置为 true，dragEnabled 属性设置为 true，就可以移动项目。通常情况下，不能或不应移除数据提供程序中的项目，因此在拖放过程中不应允许移动操作。
默认值为 false。
实现
public function get dragMoveEnabled():Boolean public function set dragMoveEnabled(value:Boolean):voiddropEnabled | 属性 |
dropEnabled:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示是否可以将所拖动的项目放到此控件上。
如果将此属性设置为 true，则该控件将接受所有数据格式，并假定所拖动的数据与数据提供程序中数据的格式相匹配。如果要显式检查正在拖动的数据的数据格式，您必须处理一个或多个拖动事件（如 dragOver），并调用 DragEvent 的 preventDefault() 方法来自定义列表类接受拖放数据的方式。
将 dropEnabled 设置为 true 时，Flex 会自动调用 showDropFeedback() 和 hideDropFeedback() 方法来显示拖放指示符。
默认值为 false。
实现
public function get dropEnabled():Boolean public function set dropEnabled(value:Boolean):voidexplicitColumnCount | 属性 |
protected var explicitColumnCount:int = -1| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
显式设置 columnCount 属性时需要的列计数。
explicitColumnWidth | 属性 |
protected var explicitColumnWidth:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
显式设置 columnWidth 时需要的列宽。
explicitRowCount | 属性 |
protected var explicitRowCount:int = -1| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
显式设置 rowCount 时需要的行计数。
explicitRowHeight | 属性 |
protected var explicitRowHeight:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
显式设置 rowHeight 时需要的行高。
factoryMap | 属性 |
protected var factoryMap:Dictionary| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
项呈示器基于工厂的映射。此属性是一个基于 itemRenderer（其值为 IFactory）编制索引的 Dictionary。
freeItemRenderers | 属性 |
protected var freeItemRenderers:Array| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
闲置项呈示器的堆栈。多数列表类都会在滚动出可显示区域时回收已创建的呈示器；这样可在滚动期间节省时间。重复使用的呈示器都存储在该位置。
freeItemRenderersByFactory | 属性 |
protected var freeItemRenderersByFactory:Dictionary| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
空闲项呈示器基于工厂的映射。此属性是一个基于工厂（其值为 itemRenderer 的 Dictionaries）编制索引的 Dictionary。
highlightIndicator | 属性 |
protected var highlightIndicator:Sprite| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
包含图形的 DisplayObject，用以指示加亮哪个呈示器。
highlightItemRenderer | 属性 |
protected var highlightItemRenderer:IListItemRenderer| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当前滚动到尖号上方或下方的呈示器。
highlightUID | 属性 |
protected var highlightUID:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当前滚动到尖号上方或下方的项目的 UID。
iconField | 属性 |
iconField:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
数据提供程序对象中字段的名称，该字段用于确定显示为图标的对象。默认情况下，列表类不会尝试将图标与行中的文本一起显示。但是，您可以通过指定图标字段来指定一个图形，将其作为图标创建并显示在行中。DataGrid 将忽略此属性。
呈示器将在数据提供程序对象中查找名为 iconField 的属性。如果该属性的值是类，将对此类进行实例化并使其成为 IFlexDisplayObject 实例。如果该属性的值是 String，将从应用程序中查找是否存在同名的类；如果没有，还将从文档中查找同名的属性，并将该属性映射到某个类中。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 iconFieldChanged 事件。
实现
public function get iconField():String public function set iconField(value:String):voidiconFunction | 属性 |
iconFunction:Function| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
用户提供的函数，在每个项目上运行以确定其图标。默认情况下，列表类不会尝试将图标与行中的文本一起显示。但是，通过指定图标函数，您可以为将创建并显示为行中的一个图标的图形指定一个类。DataGrid 将忽略此属性。
iconFunction 仅使用数据提供程序中的某个项目作为唯一自变量并返回一个类，如以下示例所示：
iconFunction(item:Object):Class
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 iconFunctionChanged 事件。
实现
public function get iconFunction():Function public function set iconFunction(value:Function):voiditemRenderer | 属性 |
itemRenderer:IFactory| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
控件的自定义项呈示器。您可以指定嵌入式、内嵌或自定义项呈示器。
默认的项呈示器取决于组件类。TileList 和 HorizontalList 类使用 TileListItemRenderer；List 类使用 ListItemRenderer。DataGrid 类使用 DataGridColumn 中的 DataGridItemRenderer。
实现
public function get itemRenderer():IFactory public function set itemRenderer(value:IFactory):voiditemsNeedMeasurement | 属性 |
protected var itemsNeedMeasurement:Boolean = true| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示是否需要计算 columnWidth 和 rowHeight 属性。如果样式更改可影响呈示器的测量结果，或数据提供程序发生更改，将设置此属性。
itemsSizeChanged | 属性 |
protected var itemsSizeChanged:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示呈示器的大小可能已更改。组件的响应方式通常是在下次调用 updateDisplayList() 时，对所有呈示器重新应用数据项目。假定重新应用项目将使项呈示器失效并重新进行测量。
iterator | 属性 |
protected var iterator:IViewCursor| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
主 IViewCursor，用于从数据提供程序中获取项目并将这些项目传递到呈示器。在任何代码顺序的结尾，都必须始终将其放置在所显示的最上方可视项目处。
iteratorValid | 属性 |
protected var iteratorValid:Boolean = true| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示发生页面错误和迭代器位置无效（未放置在所显示的最上方项目处）。如果组件出现页面错误（ItemPending 错误），它会将 iteratorValid 设置为 false。通常用于处理项目呈示问题的代码将检查此标志，并且直到从服务器传来数据页面才运行。
keySelectionPending | 属性 |
protected var keySelectionPending:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示键盘选择是否由于页面错误而中断。组件的响应方式是暂停呈示项目，直到数据页面显示。显示分页的数据时，将调用 finishKeySelection() 方法。
labelField | 属性 |
labelField:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
数据提供程序项目中作为标签显示的字段名称。默认情况下，列表将在每个项目上查找 label 属性并将其显示出来。但是，如果该数据对象不包含 label 属性，则可以将 labelField 属性设置为使用数据对象中的其它属性。例如，在查看从数据库中提取的一组人名时，可以使用“FullName”。
默认值为 "label"。
此属性可用作数据绑定的源。修改此属性后，将调度 labelFieldChanged 事件。
实现
public function get labelField():String public function set labelField(value:String):voidlabelFunction | 属性 |
labelFunction:Function| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
用户提供的函数，在每个项目上运行以确定其标签。默认情况下，该列表将在每个数据提供程序项目上查找 label 属性并将其显示出来。但是，一些数据集不包含 label 属性，也不包含可用于显示的其它属性。例如，数据集中包含 lastName 和 firstName 字段，但您希望显示全名。
您可以提供一个 labelFunction，用于查找合适的字段并返回可显示的字符串。labelFunction 还非常适用于处理格式设置和本地化。
对于大多数组件而言，此标签函数仅使用数据提供程序中的某个项目作为唯一参数，并返回一个字符串。
myLabelFunction(item:Object):String
DataGrid 和 DataGridColumn 类的方法签名是：
myLabelFunction(item:Object, column:DataGridColumn):String
其中，item 包含 DataGrid 项目对象，并且 column 指定 DataGrid 列。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 labelFunctionChanged 事件。
实现
public function get labelFunction():Function public function set labelFunction(value:Function):voidlastDropIndex | 属性 |
protected var lastDropIndex:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
最近计算出的索引，这是拖动项目在放置目标中的添加位置。
lastSeekPending | 属性 |
protected var lastSeekPending:ListBaseSeekPending| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
导致页面错误的最新一次搜索。如果存在多个页面错误，则只考虑最近的页面错误，因为这是迭代器所处的位置，还是重新呈示行的开始位置。
listContent | 属性 |
protected var listContent:ListBaseContentHolder| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个内部显示对象，是所有项呈示器、选择内容、亮显指示符以及其它支持图形的父级。它大致与 Container 类中的 contentPane 相等，用于管理滚动。
listContentStyleFilters | 属性 |
listData | 属性 |
listData:BaseListData| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
如果使用组件作为嵌入式项呈示器或嵌入式项目编辑器，则 Flex 将使用 list 控件中的其它数据初始化组件的 listData 属性。然后，该组件可以使用 listData 属性和 data 属性显示作为嵌入式项呈示器或嵌入式项目编辑器的相应信息。
您无需在 MXML 或 ActionScript 中设置此属性；将组件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 会对其进行设置。
此属性可用作数据绑定的源。修改此属性后，将调度 dataChange 事件。
实现
public function get listData():BaseListData public function set listData(value:BaseListData):void相关 API 元素
listItems | 属性 |
menuSelectionMode | 属性 |
public var menuSelectionMode:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示是否应使用菜单样式选择。在 Menu 中，从一个呈示器拖动到另一个呈示器将选择新呈示器并取消选择旧呈示器。
modifiedCollectionView | 属性 |
protected var modifiedCollectionView:ModifiedCollectionView| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
集合视图，用于暂时保留上次的数据提供程序状态，以方便运行数据更改效果。
nullItemRenderer | 属性 |
nullItemRenderer:IFactory| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
控件的自定义项呈示器。您可以指定嵌入式、内嵌或自定义项呈示器。
默认的项呈示器取决于组件类。TileList 和 HorizontalList 类使用 TileListItemRenderer；List 类使用 ListItemRenderer。DataGrid 类使用 DataGridColumn 中的 DataGridItemRenderer。
实现
public function get nullItemRenderer():IFactory public function set nullItemRenderer(value:IFactory):voidoffscreenExtraColumns | 属性 |
protected var offscreenExtraColumns:int = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
用于控件布局的项呈示器的额外列的目标数量。其中半数的列创建在屏幕上可见列的左侧；另一半创建在右侧。通常，设置 offscreenExtraRowsOrColumns 属性时将间接设置此属性。
默认值为 0。
offscreenExtraColumnsLeft | 属性 |
protected var offscreenExtraColumnsLeft:int = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当前位于最左侧可视列左侧的屏幕外的列数。此值将为 <= offscreenExtraColumns / 2。
默认值为 0。
offscreenExtraColumnsRight | 属性 |
protected var offscreenExtraColumnsRight:int = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当前位于最右侧可视列右侧的屏幕外的列数。此值将为 <= offscreenExtraColumns / 2。
默认值为 0。
offscreenExtraRows | 属性 |
protected var offscreenExtraRows:int = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
要用于控件布局的项呈示器中额外行的目标数量。其中半数的行创建在屏幕上可见行的上方；另一半创建在下方。通常，设置 offscreenExtraRowsOrColumns 属性时将间接设置此属性。
默认值为 0。
offscreenExtraRowsBottom | 属性 |
protected var offscreenExtraRowsBottom:int = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当前位于底部可视呈示器下方的屏幕外的项目数。此值将为 <= offscreenExtraRows / 2。
默认值为 0。
offscreenExtraRowsOrColumns | 属性 |
offscreenExtraRowsOrColumns:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
项呈示器的额外行或列的目标数量，供在控件布局中使用。其中半数的行/列在屏幕上可见行/列的顶部或左侧创建；另一半在其底部或右侧创建。
创建行还是列取决于控件及其属性。通常情况下将使用行，但 TileBase 组件除外，该组件的 direction 设置为 TileBaseDirection.VERTICAL。此时将创建列。
在对 List 或 TileList 控件应用数据效果时，通常将此属性设置为非零值。如果更改影响与当前可见项目对应的数据提供程序元素，或者影响数据提供程序元素中可见项目前后指定数目的项目，则所做的更改会触发数据效果。数据效果可能不会对此范围之外的数据提供程序元素进行完善的动画处理。
此属性很有用，因为数据效果的工作原理是：先确定基于列表的控件的“动画前”布局，然后确定“动画后”布局，最后设置效果的属性以创建从动画前布局到动画后布局的动画。由于许多效果都可以将当前不可见的项目更改为可见，或者将当前可见的项目更改为不可见，所以此属性将该控件配置为创建屏幕外项呈示器，以便在播放数据效果时这些项目已然存在。
此属性的合理值可能是屏幕上的可见行数。如果将此值设置得过大，则在用于包含大量元素的数据提供程序时可能会导致性能问题。
默认值为 0。
实现
public function get offscreenExtraRowsOrColumns():int public function set offscreenExtraRowsOrColumns(value:int):voidoffscreenExtraRowsOrColumnsChanged | 属性 |
protected var offscreenExtraRowsOrColumnsChanged:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示屏幕外的行数或列数可能已更改。
offscreenExtraRowsTop | 属性 |
protected var offscreenExtraRowsTop:int = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当前位于最顶部可见行上方的屏幕外的行数。此值将为 <= offscreenExtraRows / 2。当计算 listItems 和 rowInfo 数组与数据提供程序中项目的关系时使用（与 verticalScrollPosition 属性配合使用）。
默认值为 0。
rendererChanged | 属性 |
protected var rendererChanged:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示呈示器已更改。组件的响应方式通常是在下次调用 updateDisplayList() 时破坏所有现有呈示器并重新绘制所有呈示器。
reservedItemRenderers | 属性 |
protected var reservedItemRenderers:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当前闲置但近期可能会用到的项呈示器的哈希映射。当运行数据效果时使用。此映射按数据提供程序项目的 UID 编制索引。
rowCount | 属性 |
rowHeight | 属性 |
rowInfo | 属性 |
rowMap | 属性 |
protected var rowMap:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
项呈示器与其各自 ListRowInfo 对象的哈希映射。ListRowInfo 对象按项呈示器的 DisplayObject 名称编制索引。
runDataEffectNextUpdate | 属性 |
protected var runDataEffectNextUpdate:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示下次更新显示时是否应该启动数据效果。
runningDataEffect | 属性 |
protected var runningDataEffect:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示当前是否正在运行数据更改效果。
selectable | 属性 |
selectedData | 属性 |
protected var selectedData:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
用于跟踪当前所选项目的 ListBaseSelectionData 对象的哈希表。此表按项目的 UID 编制索引。
相关 API 元素
selectedIndex | 属性 |
selectedIndices | 属性 |
selectedItem | 属性 |
selectedItems | 属性 |
selectedItemsCompareFunction | 属性 |
selectedItemsCompareFunction:Function| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 9, AIR 1.5 |
用于比较 selectedItems 属性中的项目与数据提供程序中的项目的函数。如果存在匹配，则数据提供程序中的项目会变成所选内容的一部分。默认情况下，或者将 selectedItemsCompareFunction 设置为 null 时，会使用默认比较函数，该函数使用全等 (===)。请注意，Flex 的早期版本使用等于 (==)，因此在某些情形下可能会存在行为差异。某个公共比较函数可能会简单地比较对象的 UID，或者测试某个特定属性是否匹配。
比较函数采用两个参数。第一个参数是数据提供程序中的对象。第二个参数是 selectedItems 属性中的对象。如果数据提供程序项目将被选中，则该函数会返回 true。
myCompareFunction(itemInDataProvider:Object, itemInSelectedItems):Boolean
默认值为 null，它使用全等。
此属性可用作数据绑定的源。修改此属性后，将调度 selectedItemsCompareFunctionChanged 事件。
实现
public function get selectedItemsCompareFunction():Function public function set selectedItemsCompareFunction(value:Function):voidselectionIndicators | 属性 |
protected var selectionIndicators:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
所选指示符的哈希表。当清除所选项目组后，此表允许组件快速查找和移除指示符。此表按项目的 UID 编制索引。
selectionLayer | 属性 |
protected var selectionLayer:Sprite| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
listContent 中的图层，用于绘制所有选择内容和加亮指示符。
selectionTweens | 属性 |
protected var selectionTweens:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
所选内容补间的哈希表。清除所选项目组后，此表允许组件快速查找和清除正在处理的任何补间。此表按项目的 UID 编制索引。
showCaret | 属性 |
protected var showCaret:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示是否显示尖号。通常，当检测到鼠标活动时，此属性设置为 false；当使用键盘进行选择时，将重新设置为 true。
showDataTips | 属性 |
showDataTips:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示是否为行中的文本显示数据提示。如果为 true，则显示数据提示。数据提示是一些工具提示，用于显示对行而言过长的文本。如果设置了 dataTipFunction，则无论文本对行而言是否过长都会显示数据提示。
默认值为 false。
此属性可用作数据绑定的源。修改此属性后，将调度 showDataTipsChanged 事件。
实现
public function get showDataTips():Boolean public function set showDataTips(value:Boolean):voidunconstrainedRenderers | 属性 |
protected var unconstrainedRenderers:Dictionary| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
不受列表布局算法影响的项呈示器的哈希映射。
value | 属性 |
value:Object [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
所选项目，或者所选项目的数据或标签字段。如果所选项目是 Number 或 String，则其值为此项目。如果所选项目是对象，则该值为 data 属性（如果存在）或 label 属性（如果存在）。
注意：通常首选使用 selectedItem。此属性可实现与旧应用程序的向后兼容性。
此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。
实现
public function get value():ObjectvariableRowHeight | 属性 |
visibleData | 属性 |
wordWrap | 属性 |
wordWrapChanged | 属性 |
protected var wordWrapChanged:Boolean = false| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示自上次更新显示列表后 wordWrap 属性值是否已更改。更改 wordWrap 属性值时将设置此属性，并可通过 updateDisplayList() 方法将属性重置为 false。组件的响应方式通常是在下次调用 updateDisplayList() 时，对所有呈示器重新应用数据项目。这与 itemsSizeChanged 不同，它可以进一步指示将数据项目重新应用到呈示器不会使其失效，因为唯一发生变化的是，计算呈示器大小时是否应计入 wordWrap.
构造函数详细信息
ListBase | () | 构造函数 |
public function ListBase()| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
方法详细信息
addDataEffectItem | () | 方法 |
addDragData | () | 方法 |
addToFreeItemRenderers | () | 方法 |
protected function addToFreeItemRenderers(item:IListItemRenderer):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
将呈示器添加到循环使用的呈示器列表，使其不可见并清除对该呈示器的引用。如果正在运行某个数据效果，则将保留该呈示器以供那些数据以后使用。否则，会将其添加到常规 freeItemRenderers 堆栈中。
参数
item:IListItemRenderer — 要添加的呈示器。
|
addToRowArrays | () | 方法 |
protected function addToRowArrays():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
从用于存储对行的引用的数组开头添加一个空白行。
adjustListContent | () | 方法 |
protected function adjustListContent(unscaledWidth:Number = -1, unscaledHeight:Number = -1):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
从 updateDisplayList() 方法中调用，用于调整 listContent 的大小和位置。
参数
unscaledWidth:Number (default = -1)scaleX 属性值。
| |
unscaledHeight:Number (default = -1)scaleY 属性值。
|
applySelectionEffect | () | 方法 |
protected function applySelectionEffect(indicator:Sprite, uid:String, itemRenderer:IListItemRenderer):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
设置应用选择指示符的效果。默认为基本的 alpha 补间。
参数
indicator:Sprite — 包含描绘选择的图形的 Sprite。
| |
uid:String — 所选项目的 UID，可用于在表中编制索引并跟踪多个选择效果。
| |
itemRenderer:IListItemRenderer — 要作为所选内容显示的项呈示器。
|
calculateDropIndex | () | 方法 |
calculateDropIndicatorY | () | 方法 |
clearCaretIndicator | () | 方法 |
protected function clearCaretIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
清除给定 Sprite 中的尖号指示符。
参数
indicator:Sprite — 一个 Sprite 对象，其中应该包含图形以使呈示器呈示加亮效果。
| |
itemRenderer:IListItemRenderer — 加亮的项呈示器。
|
clearHighlightIndicator | () | 方法 |
protected function clearHighlightIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
清除给定 Sprite 中的加亮指示符。
参数
indicator:Sprite — 一个 Sprite 对象，其中应该包含图形以使呈示器呈示加亮效果。
| |
itemRenderer:IListItemRenderer — 加亮的项呈示器。
|
clearIndicators | () | 方法 |
protected function clearIndicators():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
删除所有选定、加亮显示和尖号指示符。
clearSelected | () | 方法 |
clearVisibleData | () | 方法 |
protected function clearVisibleData():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
清空 visibleData 哈希表。
collectionChangeHandler | () | 方法 |
commitProperties | () | 方法 |
override protected function commitProperties():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
根据是否已显式设置 columnCount columnWidth、rowHeight 和 rowCount 等属性来计算列宽、行高以及行数和列数。
相关 API 元素
configureScrollBars | () | 方法 |
protected function configureScrollBars():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
根据行数、列数以及可查看的行和列配置 ScrollBar。更新了行和列之后，将从 updateDisplayList() 方法调用此方法。此方法应指出向 setScrollBarProperties() 方法传入哪些参数才能正确设置 ScrollBar。
copyItemWithUID | () | 方法 |
copySelectedItems | () | 方法 |
createChildren | () | 方法 |
override protected function createChildren():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
创建对象作为此 ListBase 的子对象，在这种情况下为将容纳所有项呈示器的 listContent 对象。项呈示器并不立即创建，而是以后在调用 updateDisplayList() 方法时创建。
createItemRenderer | () | 方法 |
public function createItemRenderer(data:Object):IListItemRenderer| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
创建一个给定了数据对象的项呈示器。
参数
data:Object — 数据对象。
|
IListItemRenderer — 项呈示器。
|
destroyRow | () | 方法 |
dragCompleteHandler | () | 方法 |
dragDropHandler | () | 方法 |
protected function dragDropHandler(event:DragEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
处理 DragEvent.DRAG_DROP 事件。此方法通过调用 hideDropFeedback() 方法隐藏放置反馈。
如果此操作为 COPY，则此方法将调用 ObjectUtil.copy() 方法为此对象制作一个深层副本，然后通过调用 UIDUtil.createUID() 方法用一个新值替代该副本的 uid 属性（如果存在）。
参数
event:DragEvent — DragEvent 对象。
|
相关 API 元素
dragEnterHandler | () | 方法 |
dragExitHandler | () | 方法 |
dragOverHandler | () | 方法 |
dragScroll | () | 方法 |
protected function dragScroll():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
Interval 函数，用于在鼠标位于列表上方或下方时上下滚动列表。
dragStartHandler | () | 方法 |
drawCaretIndicator | () | 方法 |
protected function drawCaretIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制尖号指示符。
参数
indicator:Sprite — 一个 Sprite 对象，其中应该包含图形以使呈示器呈示加亮效果。
| |
x:Number — 建议的指示符 x 位置。
| |
y:Number — 建议的指示符 y 位置。
| |
width:Number — 建议的指示符宽度。
| |
height:Number — 建议的指示符高度。
| |
color:uint — 建议的指示符颜色。
| |
itemRenderer:IListItemRenderer — 加亮的项呈示器。
|
drawHighlightIndicator | () | 方法 |
protected function drawHighlightIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制加亮指示符。
参数
indicator:Sprite — 一个 Sprite 对象，其中应该包含图形以使呈示器呈示加亮效果。
| |
x:Number — 建议的指示符 x 位置。
| |
y:Number — 建议的指示符 y 位置。
| |
width:Number — 建议的指示符宽度。
| |
height:Number — 建议的指示符高度。
| |
color:uint — 建议的指示符颜色。
| |
itemRenderer:IListItemRenderer — 加亮的项呈示器。
|
drawItem | () | 方法 |
protected function drawItem(item:IListItemRenderer, selected:Boolean = false, highlighted:Boolean = false, caret:Boolean = false, transition:Boolean = false):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
绘制带有指示符（加亮显示的或选中的）或尖号的呈示器。
参数
item:IListItemRenderer — 呈示器。
| |
selected:Boolean (default = false)true。
| |
highlighted:Boolean (default = false)true。
| |
caret:Boolean (default = false)true。
| |
transition:Boolean (default = false)true。
|
drawRowBackgrounds | () | 方法 |
protected function drawRowBackgrounds():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
绘制行中所有交替行的颜色、边框和背景。
drawSelectionIndicator | () | 方法 |
protected function drawSelectionIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制选择指示符。
参数
indicator:Sprite — 一个 Sprite 对象，其中应该包含图形以使呈示器呈示加亮效果。
| |
x:Number — 建议的指示符 x 位置。
| |
y:Number — 建议的指示符 y 位置。
| |
width:Number — 建议的指示符宽度。
| |
height:Number — 建议的指示符高度。
| |
color:uint — 建议的指示符颜色。
| |
itemRenderer:IListItemRenderer — 加亮的项呈示器。
|
findKey | () | 方法 |
findString | () | 方法 |
public function findString(str:String):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
根据 String 查找列表中的项目，并将所选内容移至该项目。搜索从 selectedIndex 位置开始；如果到达数据提供程序的末端，则将从起始处开始。
对于 DataGrid 控件，此方法将默认搜索控件中的第一列。要搜索其他列，请将填充控件时使用的集合的 sort 属性设置为要搜索的一个或多个特定字段。每个字段都对应于控件中的一列。
参数
str:String — 要匹配的字符串。
|
Boolean — 如果找到匹配项，则为 true。
|
相关 API 元素
finishDataChangeEffect | () | 方法 |
protected function finishDataChangeEffect(event:EffectEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
在数据更改效果运行完毕后，通过恢复原始集合和迭代器并移除此效果使用的所有缓存值进行清理。此方法由 Flex 框架调用；您无需从自己的代码中调用。
参数
event:EffectEvent — EffectEvent。
|
finishKeySelection | () | 方法 |
protected function finishKeySelection():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
基于 caretIndex 和 anchorIndex 属性设置所选项目。如果键盘选择处理函数在滚动以获得更多项目时发生页面错误，则键盘选择处理函数和 updateDisplayList() 方法将调用此方法。
getItemRendererFactory | () | 方法 |
getRendererSemanticValue | () | 方法 |
public function getRendererSemanticValue(target:Object, semanticProperty:String):Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回 true 或 false 以指示是否应在目标上播放效果。当您在数据效果上设置 filter 属性时，EffectTargetFilter 类调用此方法。例如，将 filter 属性设置为 addItem 或 removeItem。
参数
target:Object — 项呈示器
| |
semanticProperty:String — 要返回其值的呈示器的语义属性。
|
Object — true 或 false，指示是否应在目标对象中播放效果。
|
getReservedOrFreeItemRenderer | () | 方法 |
protected function getReservedOrFreeItemRenderer(data:Object):IListItemRenderer| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
检索已创建但当前未使用的项呈示器。如果正在运行某个数据效果，则将首先尝试从 reservedItemRenderers 映射中检索。否则（或如果未找到保留的呈示器），将从 freeItemRenderers 堆栈中检索。
参数
data:Object — 供项呈示器显示的数据。
|
IListItemRenderer — 当前未使用已创建的项呈示器。
|
hideDropFeedback | () | 方法 |
indexToColumn | () | 方法 |
indexToItemRenderer | () | 方法 |
public function indexToItemRenderer(index:int):IListItemRenderer| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
针对数据提供程序中某个项目的索引获取项呈示器（如果存在）。因为只有可查看行组中的项目才有项呈示器，所以无法对不可见的项目使用此方法。
参数
index:int — 某个项目的数据提供程序中的偏移量。
|
IListItemRenderer — 用于显示项目的项呈示器；如果当前未显示此项目，则为 null。
|
indexToRow | () | 方法 |
indicesToIndex | () | 方法 |
public function indicesToIndex(rowIndex:int, colIndex:int):int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。根据平铺布局的方向以及 TileList 中的行数和列数，TileList 中第 3 列第 9 行的项目可能与数据提供程序中对应位置的项目不同。
参数
rowIndex:int — 行从零开始的索引，包括从顶部滚离的行。因此，如果 verticalScrollPosition 为 2，则第一个可见行的 rowIndex 为 2。
| |
colIndex:int — 列从零开始的索引，包括滚离左侧的列。如果 horizontalScrollPosition 为 2，则左侧第一列的 columnIndex 为 2。
|
int — 数据提供程序中的偏移量。
|
initiateDataChangeEffect | () | 方法 |
invalidateList | () | 方法 |
public function invalidateList():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
在下次更新时刷新所有行。
isItemHighlighted | () | 方法 |
isItemSelectable | () | 方法 |
isItemSelected | () | 方法 |
isItemShowingCaret | () | 方法 |
isItemVisible | () | 方法 |
isRendererUnconstrained | () | 方法 |
itemRendererContains | () | 方法 |
public function itemRendererContains(renderer:IListItemRenderer, object:DisplayObject):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
确定呈示器是否包含（或拥有）显示对象。所有权表示显示对象实际上并非呈示器的子项，而是在一定程度上与之相关联。呈示器应该包含弹出框，以便弹出框中的活动与呈示器相关联，并且在其它组件中不作为活动显示。
参数
renderer:IListItemRenderer — 可能包含或拥有显示对象的呈示器。
| |
object:DisplayObject — 可能与呈示器相关联的显示对象。
|
Boolean — 如果呈示器中包含或拥有显示对象，则返回 true。
|
itemRendererToIndex | () | 方法 |
public function itemRendererToIndex(itemRenderer:IListItemRenderer):int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回通过此项呈示器呈示的该项目在数据提供程序中的项目索引。因为只有可查看行组中的项目才有项呈示器，所以无法对不可见的项目使用此方法。
参数
itemRenderer:IListItemRenderer — 项呈示器，其中显示了您希望获知其数据提供程序索引的项目。
|
int — 数据提供程序中项目的索引。
|
itemRendererToIndices | () | 方法 |
protected function itemRendererToIndices(item:IListItemRenderer):Point| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回一个包含项呈示器的 columnIndex 和 rowIndex 的点。由于只为可查看行组中的项目创建项呈示器，因此您无法使用此方法获得不可见项目的索引。另请注意，项呈示器可循环使用。因此当重用某个项呈示器来显示其他项目时，您获得的项目索引可能会发生变化。通常，在使用鼠标和键盘执行处理期间项呈示器显示的数据集未更改的情况下调用此方法。
参数
item:IListItemRenderer — 项呈示器。
|
Point — 点。x 属性是 columnIndex，y 属性是 rowIndex。
|
itemToDataTip | () | 方法 |
itemToIcon | () | 方法 |
itemToItemRenderer | () | 方法 |
public function itemToItemRenderer(item:Object):IListItemRenderer| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回数据提供程序中给定项目的项呈示器（如果存在）。因为只有可查看行组中的项目才有项呈示器，所以当项目不可见时，此方法将返回 null。对于 DataGrid，将返回第一列的呈示器。
参数
item:Object — 数据提供程序项目。
|
IListItemRenderer — 项呈示器；如果当前未显示项目，则为 null。
|
itemToLabel | () | 方法 |
itemToUID | () | 方法 |
protected function itemToUID(data:Object):String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
确定数据提供程序项目的 UID。数据提供程序中的所有项目都必须具有唯一的 ID (UID)，或生成一个与之相关的 ID。这意味着您无法在数据提供程序中两次显示对象或标量值。
例如，不支持以下数据提供者，因为“foo”值出现了两次，而且字符串的 UID 是字符串本身。
var sampleDP:Array = ["foo", "bar", "foo"]
如果简单动态对象是两个不同的实例，则可以显示两次。支持以下数据提供者，原因是由于每个实例都是不同的对象，因此将向每个实例提供不同的 UID：
var sampleDP:Array = [{label: "foo"}, {label: "foo"}]
请注意，以下数据提供程序不受支持，因为同一实例出现了两次。
var foo:Object = {label: "foo"};
sampleDP:Array = [foo, foo];
参数
data:Object — 数据提供程序项目。
|
String — 字符串形式的 UID.
|
makeRowsAndColumns | () | 方法 |
protected function makeRowsAndColumns(left:Number, top:Number, right:Number, bottom:Number, firstColumn:int, firstRow:int, byCount:Boolean = false, rowsNeeded:uint = 0):Point| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
创建足够的行和列以填充左侧、顶部、右侧和底部描述的区域。这将创建呈示器，并在 listItems 数组中从 (firstColumn, firstRow)( 开始向下插入。
如果已指定 byCount 和 rowsNeeded，则只需创建指定的行数，并忽略 bottom 和 right 参数。
参数
left:Number — 要填充的区域的水平像素偏移量。
| |
top:Number — 要填充的区域的垂直像素偏移量。
| |
right:Number — 要填充的区域与组件左侧的水平像素偏移量。
| |
bottom:Number — 要填充的区域与组件顶部的垂直像素偏移量。
| |
firstColumn:int — 存储要创建的第一个呈示器时 listItems 中的偏移量。
| |
firstRow:int — 存储要创建的第一个呈示器时 listItems 中的偏移量。
| |
byCount:Boolean (default = false)rowsNeeded 行，并忽略 bottom 参数.
| |
rowsNeeded:uint (default = 0)byCount 为 true 时要创建的行数。
|
Point — 包含所创建的行数和列数的点。
|
measure | () | 方法 |
override protected function measure():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
根据 rowCount、columnCount、rowHeight 和 columnWidth 属性计算组件的度量宽度和高度。
相关 API 元素
measureHeightOfItems | () | 方法 |
public function measureHeightOfItems(index:int = -1, count:int = 0):Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
使用当前项呈示器测量数据提供程序中的一组项目，并返回这些项目的高度之和。
此方法无法在 ListBase 类中实现，而是必须在子类中实现。
如果 index 值为负，则指定在计算高度时包含所有标题。
参数
index:int (default = -1) | |
count:int (default = 0) |
Number — 所测量项目的高度之和。
|
measureWidthOfItems | () | 方法 |
public function measureWidthOfItems(index:int = -1, count:int = 0):Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
使用当前项呈示器测量数据提供程序中的一组项目，并返回找到的最大宽度。此方法用于计算组件的宽度。各种 ListBase-derived 类的实现之间存在细微差异。DataGrid 将测量其列而非数据提供程序项目，而 TileList 只测量第一个项目并假定所有项目大小相同。
此方法无法在 ListBase 类中实现，而是必须在子类中实现。
如果 index 值为负，则指定在计算宽度时包含所有标题。
参数
index:int (default = -1) | |
count:int (default = 0) |
Number — 所测量项目的最大宽度。
|
mouseClickHandler | () | 方法 |
protected function mouseClickHandler(event:MouseEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_CLICK 事件。此方法确定单击了哪个呈示器，并调度 ListEvent.ITEM_CLICK 事件。
参数
event:MouseEvent — MouseEvent 对象。
|
mouseDoubleClickHandler | () | 方法 |
protected function mouseDoubleClickHandler(event:MouseEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_DOUBLE_CLICK 事件。此方法确定单击了哪个呈示器，并调度 ListEvent.ITEM_DOUBLE_CLICK 事件。
参数
event:MouseEvent — MouseEvent 对象。
|
mouseDownHandler | () | 方法 |
protected function mouseDownHandler(event:MouseEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_DOWN 事件。此方法查找被按下的呈示器，并准备接收 MouseEvent.MOUSE_UP 事件。
参数
event:MouseEvent — MouseEvent 对象。
|
mouseEventToItemRenderer | () | 方法 |
protected function mouseEventToItemRenderer(event:MouseEvent):IListItemRenderer| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
确定哪种项呈示器位于鼠标下方。项呈示器可由多个鼠标目标组成，也可以包含鼠标目标范围之外的可见区域。此方法既检查鼠标目标又检查鼠标位置，以便从用户角度确定鼠标下方是哪种项呈示器，这可能与鼠标事件提供的信息有所不同。
参数
event:MouseEvent — 包含鼠标位置及其下方对象的 MouseEvent。
|
IListItemRenderer — 位于鼠标下方的项呈示器；如果不存在，则为 null。
|
mouseMoveHandler | () | 方法 |
protected function mouseMoveHandler(event:MouseEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_MOVE 事件。此方法监视导致开始拖放并发送 DragEvent.DRAG_START 事件的动作。它还检查鼠标是否位于呈示器的非目标区域，以便 Flex 尽量使呈示器看起来像目标一样。
参数
event:MouseEvent — MouseEvent 对象。
|
mouseOutHandler | () | 方法 |
protected function mouseOutHandler(event:MouseEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_OUT 事件。此方法查找鼠标离开的呈示器并删除其加亮效果。
参数
event:MouseEvent — MouseEvent 对象。
|
mouseOverHandler | () | 方法 |
protected function mouseOverHandler(event:MouseEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_OVER 事件。此方法查找鼠标到达的呈示器并加亮该呈示器。
列表类还会从 MouseEvent.MOUSE_MOVE 事件调用此方法。此事件用于检测呈示器中非目标区域以及呈示器周围填充区域中的移动。
参数
event:MouseEvent — MouseEvent 对象。
|
mouseUpHandler | () | 方法 |
protected function mouseUpHandler(event:MouseEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
处理列表中所有鼠标目标（包括呈示器）的 MouseEvent.MOUSE_DOWN 事件。此方法查找被按下的呈示器，并准备接收 MouseEvent.MOUSE_UP 事件。
参数
event:MouseEvent — MouseEvent 对象。
|
mouseWheelHandler | () | 方法 |
override protected function mouseWheelHandler(event:MouseEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
通过更改滚动位置处理 mouseWheel 事件。这是 ScrollControlBase 类中的版本副本，可以对其进行修改以便水平运行目标时更改 horizontalScrollPosition。
参数
event:MouseEvent — MouseEvent 对象。
|
相关 API 元素
moveIndicatorsHorizontally | () | 方法 |
moveIndicatorsVertically | () | 方法 |
moveRowVertically | () | 方法 |
moveSelectionHorizontally | () | 方法 |
protected function moveSelectionHorizontally(code:uint, shiftKey:Boolean, ctrlKey:Boolean):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
沿水平方向移动所选项目，以响应用户使用向左键或向右键以及功能键（如 Shift 和 Ctrl 键）选择项目的操作。这种方法可能会更改 horizontalScrollPosition、verticalScrollPosition 和 caretIndex 属性，并调用 finishKeySelection() 方法来更新选项。
此操作无法在 ListBase 中实现，因为默认列表只有一列，无法水平滚动。
参数
code:uint — 按下的键（例如 Keyboard.LEFT）。
| |
shiftKey:Boolean — 如果在按住 Shift 键的同时按下某个键，则为 true。
| |
ctrlKey:Boolean — 如果在按住 Ctrl 键的同时按下某个键，则为 true。
|
moveSelectionVertically | () | 方法 |
protected function moveSelectionVertically(code:uint, shiftKey:Boolean, ctrlKey:Boolean):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
沿垂直方向移动所选项目，以响应用户使用向上键或向下键以及功能键（如 Shift 和 Ctrl 键）选择项目的操作。这种方法可能会更改 horizontalScrollPosition、verticalScrollPosition 和 caretIndex 属性，并调用 finishKeySelection() 方法来更新选项。
参数
code:uint — 按下的键（例如 Keyboard.DOWN）。
| |
shiftKey:Boolean — 如果在按住 Shift 键的同时按下某个键，则为 true。
| |
ctrlKey:Boolean — 如果在按住 Ctrl 键的同时按下某个键，则为 true。
|
prepareDataEffect | () | 方法 |
protected function prepareDataEffect(ce:CollectionEvent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
准备集合事件的数据效果。
参数
ce:CollectionEvent — collection 事件。
|
purgeItemRenderers | () | 方法 |
protected function purgeItemRenderers():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当呈示器发生更改时，updateDisplayList() 方法将调用此方法，用以删除现有的项呈示器并清理各种缓存结构。
reKeyVisibleData | () | 方法 |
protected function reKeyVisibleData():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
更新 visibleData 哈希表中的键。
removeDataEffectItem | () | 方法 |
removeFromRowArrays | () | 方法 |
removeIndicators | () | 方法 |
restoreRowArrays | () | 方法 |
scrollHorizontally | () | 方法 |
protected function scrollHorizontally(pos:int, deltaPos:int, scrollUp:Boolean):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
调整呈示器以响应滚动位置的更改。
当滚动位置的更改量低于可见行数时，列表类将尝试优化滚动。此时，一些行只需进行移动即可而无需进行其它更改，另一些行则需要删除，然后添加新行。如果滚动位置更改量过大，将删除所有旧行，并调用 makeRowsAndColumns() 方法在整个可查看区域添加新行。
此操作无法在 ListBase 中实现，因为默认列表只有一列，无法水平滚动。
参数
pos:int — 新的滚动位置。
| |
deltaPos:int — 位置的变化。此值始终为正数。
| |
scrollUp:Boolean — 如果滚动位置正在逐渐缩小，则为 true。
|
scrollPositionToIndex | () | 方法 |
protected function scrollPositionToIndex(horizontalScrollPosition:int, verticalScrollPosition:int):int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回给定滚动位置第一个可见行和列处的项目的数据提供程序索引。
参数
horizontalScrollPosition:int — 与滚动位置相对应的 horizontalScrollPosition 属性值。
| |
verticalScrollPosition:int — 与滚动位置相对应的 verticalScrollPosition 属性值。
|
int — 数据提供程序索引。
|
scrollToIndex | () | 方法 |
public function scrollToIndex(index:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
确保给定索引处的数据提供程序项目可见。如果此项目可见，则 verticalScrollPosition 属性将保持不变，即使该项目并非第一个可见项目也不例外。如果此项目当前不可见，则会更改 verticalScrollPosition 属性以将该项目设为第一个可见项目；但行数不足时除外，因为 verticalScrollPosition 值受 maxVerticalScrollPosition 属性限制。
参数
index:int — 数据提供程序中项目的索引。
|
Boolean — 如果更改了 verticalScrollPosition，则返回 true。
|
scrollVertically | () | 方法 |
protected function scrollVertically(pos:int, deltaPos:int, scrollUp:Boolean):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
调整呈示器以响应滚动位置的更改。
当滚动位置的更改量低于可见行数时，列表类将尝试优化滚动。此时，一些行只需进行移动即可而无需进行其它更改，另一些行则需要删除，然后添加新行。如果滚动位置更改量过大，将删除所有旧行，并调用 makeRowsAndColumns() 方法在整个可查看区域添加新行。
参数
pos:int — 新的滚动位置。
| |
deltaPos:int — 位置的变化。此值始终为正数。
| |
scrollUp:Boolean — 如果滚动位置正在逐渐缩小，则为 true。
|
seekPendingFailureHandler | () | 方法 |
protected function seekPendingFailureHandler(data:Object, info:ListBaseSeekPending):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当由于页面错误而导致寻找失败时的默认故障处理函数。
参数
data:Object — 导致该错误的数据。
| |
info:ListBaseSeekPending — 有关由于 ItemPendingError 错误而中断的搜索操作的数据。
|
seekPendingResultHandler | () | 方法 |
protected function seekPendingResultHandler(data:Object, info:ListBaseSeekPending):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当由于页面错误而导致寻找失败时的默认结果处理函数。此方法将检查是否存在最新页面的错误结果：如果没有，则退出；如果有，则将迭代器设置到正确的位置。
参数
data:Object — 导致该错误的数据。
| |
info:ListBaseSeekPending — 有关由于 ItemPendingError 错误而中断的搜索操作的数据。
|
seekPositionSafely | () | 方法 |
selectItem | () | 方法 |
protected function selectItem(item:IListItemRenderer, shiftKey:Boolean, ctrlKey:Boolean, transition:Boolean = true):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
如果使用鼠标单击提供的项呈示器，并且键盘功能键处于给定状态，则更新所选项目组。此方法也可以根据项呈示器更新后的选定状态更新其显示。
参数
item:IListItemRenderer — 单击的项呈示器。
| |
shiftKey:Boolean — 如果在单击鼠标的同时按下 Shift 键，则返回 true。
| |
ctrlKey:Boolean — 如果在按住 Ctrl 键的同时单击鼠标，则为 true。
| |
transition:Boolean (default = true)true。
|
Boolean — 如果所选项目组发生更改，则返回 true。单击已选项目并不总是能更改所选的项目集。
|
setRowCount | () | 方法 |
setRowHeight | () | 方法 |
shiftRow | () | 方法 |
protected function shiftRow(oldIndex:int, newIndex:int, numCols:int, shiftItems:Boolean):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
移动引用多行的数组中的某一行。
参数
oldIndex:int — 数组中的旧索引。
| |
newIndex:int — 数组中的新索引。
| |
numCols:int — 行中的列数。
| |
shiftItems:Boolean — 如果实际移动了项目，则为 true。如果只更改了项目的 rowIndex，则为 false。
|
showDropFeedback | () | 方法 |
sumRowHeights | () | 方法 |
truncateRowArrays | () | 方法 |
UIDToItemRenderer | () | 方法 |
protected function UIDToItemRenderer(uid:String):IListItemRenderer| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
如果项呈示器可见，则根据其 UID 进行查找。
参数
uid:String — 项目的 UID。
|
IListItemRenderer — 项呈示器。
|
unconstrainRenderer | () | 方法 |
updateDisplayList | () | 方法 |
override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当可显示的项目数发生更改时添加或移除项呈示器。如果项呈示器可能已发生更改，请刷新它们。如果是以编程方式进行的更改，请应用此选项。
参数
unscaledWidth:Number — 指定组件在组件坐标中的宽度（以像素为单位），而不考虑该组件的 scaleX 属性值。
| |
unscaledHeight:Number — 指定组件在组件坐标中的高度（以像素为单位），而不考虑该组件的 scaleY 属性值。
|
相关 API 元素
updateList | () | 方法 |
protected function updateList():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
刷新所有行。调用此方法可能需要进行大量处理，因为它完全重绘列表中所有的呈示器，而且直到完成才返回。
事件详细信息
change | 事件 |
事件对象类型:
属性 ListEvent.type =
mx.events.ListEvent属性 ListEvent.type =
mx.events.ListEvent.CHANGE| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当用户操作导致 selectedIndex 或 selectedItem 属性发生变化时调度此事件。
change 事件定义 ListEvent 对象的 type 属性的值，指示由于用户交互所选内容已发生更改。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
itemRenderer | 单击的项呈示器。 |
reason | null |
rowIndex | 与事件相关联的项目的从零开始的索引。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
类型 | ListEvent.CHANGE |
dataChange | 事件 |
事件对象类型:
属性 FlexEvent.type =
mx.events.FlexEvent属性 FlexEvent.type =
mx.events.FlexEvent.DATA_CHANGE| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当 data 属性更改时进行调度。
当您使用组件作为项呈示器时，data 属性将包含要显示的数据。您可以侦听此事件，并在 data 属性更改时更新组件。
FlexEvent.DATA_CHANGE 常量可为 dataChange 事件定义事件对象的 type 属性值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
itemClick | 事件 |
事件对象类型:
属性 ListEvent.type =
mx.events.ListEvent属性 ListEvent.type =
mx.events.ListEvent.ITEM_CLICK| 语言版本: | 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 |
itemDoubleClick | 事件 |
事件对象类型:
属性 ListEvent.type =
mx.events.ListEvent属性 ListEvent.type =
mx.events.ListEvent.ITEM_DOUBLE_CLICK| 语言版本: | 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 |
itemRollOut | 事件 |
事件对象类型:
属性 ListEvent.type =
mx.events.ListEvent属性 ListEvent.type =
mx.events.ListEvent.ITEM_ROLL_OUT| 语言版本: | 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 |
itemRollOver | 事件 |
事件对象类型:
属性 ListEvent.type =
mx.events.ListEvent属性 ListEvent.type =
mx.events.ListEvent.ITEM_ROLL_OVER| 语言版本: | 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