| 包 | mx.controls.listClasses |
| Class | public class ListBase |
| 继承 | ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Implements | IDataRenderer, IFocusManagerComponent, IListItemRenderer, IDropInListItemRenderer, IEffectTargetHost |
| Subclasses | DataGridBase, List, TileBase |
dataProvider 属性提供,并通过项目渲染器显示。
在模型/视图体系结构中,ListBase-derived 类提供视图,dataProvider 对象提供模型。
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"
/>
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。 | DisplayObject | |
![]() | activeEffects : Array []
组件上当前播放的效果列表,如 EffectInstance 实例的 Array。 | UIComponent | |
| allowDragSelection : Boolean = false
一个标志,指示是否启用拖动选择。 | ListBase | ||
| allowMultipleSelection : Boolean
一个标志,指示是否允许您同时选择多个项目。 | ListBase | ||
![]() | alpha : Number
指示指定对象的 Alpha 透明度值。 | DisplayObject | |
![]() | automationDelegate : Object
处理自动化相关功能的委托对象。 | UIComponent | |
![]() | automationName : String
可用作此对象的标识符的名称。 | UIComponent | |
![]() | automationTabularData : Object []
IAutomationTabularData 接口的实现,可用于检索数据。 | UIComponent | |
![]() | automationValue : Array []
此值通常对应于对象的经渲染的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。 | UIComponent | |
![]() | baselinePosition : Number []
组件第一行文本的基线的 y 坐标。 | UIComponent | |
![]() | blendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。 | DisplayObject | |
![]() | borderMetrics : EdgeMetrics []
返回 EdgeMetrics 对象,它具有四个属性:left、top、right 和 bottom。 | ScrollControlBase | |
![]() | buttonMode : Boolean
指定此 sprite 的按钮模式。 | Sprite | |
![]() | cacheAsBitmap : Boolean
如果设置为 true,则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。 | 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 | ||
![]() | descriptor : UIComponentDescriptor
引用 UIComponentDescriptor(如果有),过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。 | 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 | |
![]() | height : Number
指定组件在父坐标中的高度的数字(以像素为单位)。 | UIComponent | |
![]() | hitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | |
![]() | 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 | |
![]() | isDocument : Boolean []
确定此 UIComponent 实例是否为文档对象,也就是说它是否位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。 | UIComponent | |
![]() | isPopUp : Boolean
PopUpManager 将其设置为 true 以指示已弹出该组件。 | UIComponent | |
| itemRenderer : IFactory
控件的自定义项目渲染器。 | ListBase | ||
| labelField : String
数据提供程序项目中作为标签显示的字段名称。 | ListBase | ||
| labelFunction : Function
用户提供的函数,在每个项目上运行以确定其标签。 | ListBase | ||
| listData : BaseListData
如果使用组件作为嵌入式项目渲染器或嵌入式项目编辑器,则 Flex 将使用 list 控件中的其它数据初始化组件的 listData 属性。 | ListBase | ||
![]() | liveScrolling : Boolean = true
一个标志,指示移动滚动栏滑块时实时滚动视图,还是释放滑块后才更新视图。 | ScrollControlBase | |
![]() | loaderInfo : LoaderInfo []
返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | |
![]() | 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 | ||
![]() | minHeight : Number
在组件坐标中指定组件最小高度的数字(以像素为单位)。 | UIComponent | |
![]() | minWidth : Number
在组件坐标中指定组件最小宽度的数字(以像素为单位)。 | UIComponent | |
![]() | moduleFactory : IFlexModuleFactory
用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。 | UIComponent | |
![]() | mouseChildren : Boolean
确定对象的子项是否支持鼠标。 | DisplayObjectContainer | |
![]() | mouseEnabled : Boolean
指定此对象是否接收鼠标消息。 | InteractiveObject | |
![]() | mouseFocusEnabled : Boolean
单击时是否可接收焦点。 | UIComponent | |
![]() | mouseX : Number []
指示鼠标位置的 x 坐标,以像素为单位。 | DisplayObject | |
![]() | mouseY : Number []
指示鼠标位置的 y 坐标,以像素为单位。 | DisplayObject | |
![]() | name : String
指示 DisplayObject 的实例名称。 | DisplayObject | |
![]() | nestLevel : int
此对象在所属关系层次结构中的深度。 | UIComponent | |
![]() | nonInheritingStyles : Object
此组件的非继承样式链的开头内容。 | UIComponent | |
| nullItemRenderer : IFactory
控件的自定义项目渲染器。 | ListBase | ||
![]() | numAutomationChildren : int []
此容器包含的自动化子项数。 | UIComponent | |
![]() | numChildren : int []
返回此对象的子项数目。 | DisplayObjectContainer | |
| offscreenExtraRowsOrColumns : int
项目渲染器的额外行或列的目标数量,供在控件布局中使用。 | ListBase | ||
![]() | opaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | |
![]() | owner : DisplayObjectContainer
此 UIComponent 的所有者。 | UIComponent | |
![]() | parent : DisplayObjectContainer []
此组件的父容器或组件。 | UIComponent | |
![]() | parentApplication : Object []
引用包含此 UIComponent 实例的 Application 对象。 | UIComponent | |
![]() | parentDocument : Object []
引用此 UIComponent 的父文档对象。 | UIComponent | |
![]() | percentHeight : Number
以组件父项大小百分比的方式指定组件高度的数字。 | UIComponent | |
![]() | percentWidth : Number
以组件父项大小百分比形式指定其宽度的数字。 | UIComponent | |
![]() | processedDescriptors : Boolean
临时或延迟子项创建操作后设置为 true,具体取决于发生对象。 | UIComponent | |
![]() | prototype : Object []
对类或函数对象的原型对象的引用。 | Object | |
![]() | repeater : IRepeater []
对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
![]() | repeaterIndex : int []
项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。 | UIComponent | |
![]() | repeaterIndices : Array
一个 Array,包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。 | UIComponent | |
![]() | repeaters : Array
一个 Array,包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
![]() | root : DisplayObject []
对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | |
![]() | rotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。 | DisplayObject | |
| rowCount : int
要显示的行数。 | ListBase | ||
| rowHeight : Number
行高(以像素为单位)。 | ListBase | ||
![]() | scale9Grid : Rectangle
当前有效的缩放网格。 | DisplayObject | |
![]() | scaleX : Number
用于指定水平缩放系数的数字。 | UIComponent | |
![]() | scaleY : Number
用于指定垂直缩放系数的数字。 | 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 | ||
| showDataTips : Boolean
一个标志,指示是否为行中的文本显示数据提示。 | ListBase | ||
![]() | showInAutomationHierarchy : Boolean
用于确定自动化对象是否显示在自动化层次中的标志。 | UIComponent | |
![]() | showScrollTips : Boolean = false
一个标志,指示拖动滚动滑块时是否应在其旁边显示工具提示。 | ScrollControlBase | |
![]() | soundTransform : SoundTransform
控制此 sprite 中的声音。 | Sprite | |
![]() | stage : Stage []
显示对象的舞台。 | DisplayObject | |
![]() | states : Array
为此组件定义的视图状态。 | UIComponent | |
![]() | styleDeclaration : CSSStyleDeclaration
存储此对象的内嵌继承样式。 | UIComponent | |
![]() | styleName : Object
此组件使用的类样式。 | UIComponent | |
![]() | systemManager : ISystemManager
返回此组件使用的 SystemManager 对象。 | UIComponent | |
![]() | tabChildren : Boolean
确定对象的子项是否支持 Tab 键。 | DisplayObjectContainer | |
![]() | tabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | |
![]() | tabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | |
![]() | textSnapshot : TextSnapshot []
返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。 | DisplayObjectContainer | |
![]() | toolTip : String
要在 ToolTip 中显示的文本。 | UIComponent | |
![]() | transform : Transform
一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | DisplayObject | |
![]() | 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 | ||
![]() | verticalScrollPolicy : String
指示垂直滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。 | ScrollControlBase | |
![]() | verticalScrollPosition : Number
顶边到内容的偏移量。 | ScrollControlBase | |
![]() | viewMetrics : EdgeMetrics []
考虑滚动条(如果可见)的 EdgeMetrics 对象。 | ScrollControlBase | |
![]() | visible : Boolean
控制此 UIComponent 的可见性。 | UIComponent | |
![]() | width : Number
指定组件在父坐标中的宽度的数字(以像素为单位)。 | UIComponent | |
| wordWrap : Boolean
一个标志,指示行中的文本是否应自动换行。 | ListBase | ||
![]() | x : Number
指定组件在其父容器中的水平位置(以像素为单位)的数字。 | UIComponent | |
![]() | y : Number
指定组件在其父容器中的垂直位置(以像素为单位)的数字。 | 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 | ||
| 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 | ||
| 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 [] Review Needed.
从 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 | |
![]() |
指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
返回将放置项目添加到放置目标中的位置的索引。 | ListBase | ||
![]() |
排队稍后调用的函数。 | UIComponent | |
![]() |
删除此组件实例中的样式属性。 | UIComponent | |
![]() |
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
![]() |
将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | |
![]() |
将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | |
![]() |
返回标识此容器中的子项的一组属性。 | UIComponent | |
创建一个给定了数据对象的项目渲染器
| ListBase | ||
![]() |
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | |
![]() |
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | |
![]() |
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | |
![]() |
将事件调度到事件流中。 | UIComponent | |
![]() |
在此组件周围显示或隐藏焦点指示符。 | UIComponent | |
![]() | drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void
通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | |
![]() |
停止在组件上播放效果实例时,由效果实例调用。 | UIComponent | |
![]() |
开始在组件上播放效果实例时,由效果实例调用。 | UIComponent | |
![]() |
结束组件上当前播放的所有效果。 | UIComponent | |
![]() |
将数据绑定到此 UIComponent 对象。 | UIComponent | |
根据 String 查找列表中的项目,并将所选内容移至该项目。 | ListBase | ||
![]() |
打印完成后调用。 | UIComponent | |
![]() |
在指定的索引位置提供自动化对象。 | UIComponent | |
![]() |
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
![]() |
返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | |
![]() |
返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
![]() |
返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | |
![]() |
查找此 UIComponent 实例的类型选择器。 | UIComponent | |
![]() |
返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | |
![]() |
确定是使用显式高度还是测量高度的一种简便方法
| UIComponent | |
![]() |
确定是使用显式宽度还是测量宽度的一种简便方法
| UIComponent | |
![]() |
获取当前具有焦点的对象。 | UIComponent | |
返回相应的工厂;如果尚未指定,则使用默认工厂。 | ListBase | ||
![]() |
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | |
![]() |
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | |
返回 true 或 false 以指示是否应在目标上播放效果。 | ListBase | ||
![]() |
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | |
![]() |
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
![]() |
将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | |
![]() |
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | |
![]() |
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
![]() |
指示对象是否已经定义了指定的属性。 | Object | |
在鼠标指针下方隐藏指示允许执行拖放操作的放置指示符。 | ListBase | ||
![]() |
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | |
![]() |
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
![]() |
返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | |
针对数据提供程序中某个项目的索引获取项目渲染器(如果存在)。 | ListBase | ||
计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。 | ListBase | ||
![]() |
初始化此组件的内部结构。 | UIComponent | |
![]() |
初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | |
![]() |
标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
在下次更新时刷新所有行。 | ListBase | ||
![]() |
标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
![]() |
标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
确定是否加亮显示数据提供程序项目的项目渲染器(当鼠标滑过它,或者通过键盘导航使它位于尖号下方时)。 | ListBase | ||
确定数据提供程序项目的项目渲染器是否可选。 | ListBase | ||
确定是否已选中数据提供程序项目的项目渲染器。 | ListBase | ||
确定渲染器是否显示某个项目。 | ListBase | ||
![]() |
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
确定渲染器是否包含(或拥有)显示对象。 | ListBase | ||
返回通过此项目渲染器呈现的该项目在数据提供程序中的项目索引。 | ListBase | ||
返回渲染器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。 | ListBase | ||
根据 iconField 和 iconFunction 属性返回表示数据项目图标的类(如果存在)。 | ListBase | ||
返回数据提供程序中给定项目的项目渲染器(如果存在)。 | ListBase | ||
返回渲染器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。 | ListBase | ||
![]() |
将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | |
![]() |
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | |
使用当前项目渲染器测量数据提供程序中的一组项目,并返回这些项目的高度之和。 | ListBase | ||
![]() |
测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标记),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | |
![]() |
测量指定的文本,假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | |
使用当前项目渲染器测量数据提供程序中的一组项目,并返回找到的最大宽度。 | ListBase | ||
![]() |
将组件移动到其父项内的指定位置。 | UIComponent | |
![]() |
将样式更改传播到子项。 | UIComponent | |
![]() |
如果 owner 属性链从 child 指向此 UIComponent,则返回 true。 | UIComponent | |
![]() |
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | |
![]() |
准备 IFlexDisplayObject 用于打印。 | UIComponent | |
![]() |
指示指定的属性是否存在、是否可枚举。 | Object | |
![]() |
为此组件构建或重新构建 CSS 样式缓存;如果 recursive 参数为 true,还会为此组件的所有后代执行同样的操作。 | UIComponent | |
![]() |
针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | |
![]() |
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | |
![]() |
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | |
如果正在运行数据更改效果,则移除项目渲染器。 | ListBase | ||
![]() |
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
![]() |
重放指定的事件。 | UIComponent | |
![]() |
使用提供的 ID 解析子项。 | UIComponent | |
![]() | []
在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
确保给定索引处的数据提供程序项目可见。 | ListBase | ||
![]() |
调整对象大小。 | UIComponent | |
![]() |
更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | |
![]() |
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | |
![]() |
设置当前状态。 | UIComponent | |
![]() |
设置此组件的焦点。 | UIComponent | |
![]() |
设置循环操作动态属性的可用性。 | Object | |
![]() |
对此组件实例设置样式属性。 | UIComponent | |
![]() |
当 visible 属性发生更改时调用。 | UIComponent | |
在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。 | ListBase | ||
![]() |
允许用户拖动指定的 Sprite。 | Sprite | |
![]() |
结束 startDrag() 方法。 | Sprite | |
![]() |
检测对样式属性的更改。 | UIComponent | |
![]() |
首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | |
![]() | []
阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
![]() |
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。 | DisplayObjectContainer | |
![]() |
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。 | DisplayObjectContainer | |
![]() |
返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | |
如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外,则将作为数据更改效果的一部分由 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 | ||
设置应用选择指示符的效果。 | ListBase | ||
![]() |
这是一个内部方法,供 Flex 框架用于支持 Dissolve 效果。 | UIComponent | |
在执行拖放操作时计算放置指示符的 y 位置。 | ListBase | ||
![]() |
创建子对象后执行任何最终处理。 | 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 | ||
处理 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 | |
当数据提供程序中发生更改时应用数据更改效果。 | ListBase | ||
![]() |
通常由包含 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 | |
移动引用多行的数组中的某一行
| ListBase | ||
确定所请求的行集的高度
| ListBase | ||
从用于存储对行的引用的数组末端删除所有剩余行
| ListBase | ||
Find an item renderer based on its UID if it is visible
| ListBase | ||
当可显示的项目数发生更改时添加或移除项目渲染器。 | ListBase | ||
立即刷新所有行。 | ListBase | ||
| 事件 | 摘要 | 定义方 | ||
|---|---|---|---|---|
![]() | Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时调度。 | EventDispatcher | ||
![]() | 使用 addChild() 或 addChildAt() 方法将组件作为内容子项添加到容器时调度。 | UIComponent | ||
![]() | 将显示对象添加到显示列表中时调度。 | DisplayObject | ||
![]() | 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | ||
| 当用户操作导致 selectedIndex 或 selectedItem 属性更改时调度此事件。 | ListBase | |||
![]() | 用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | ||
![]() | 当组件完成其构建、属性处理、测量、布置和绘制时调度。 | UIComponent | ||
![]() | 视图状态更改后调度。 | UIComponent | ||
![]() | 在 currentState 属性更改后但视图状态更改前调度。 | UIComponent | ||
| 当 data 属性更改时进行调度。 | ListBase | |||
![]() | Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时调度。 | EventDispatcher | ||
![]() | 如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | ||
![]() | 在拖动操作完成时(将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时)由拖动启动器(作为要拖动的数据源的组件)调度。 | UIComponent | ||
![]() | 用户在放置目标上释放鼠标时由放置目标调度。 | UIComponent | ||
![]() | 当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时,由该组件调度。 | UIComponent | ||
![]() | 用户在组件外拖动但没有将数据放置到目标时,由组件调度。 | UIComponent | ||
![]() | 在拖动操作期间,当用户在鼠标位于组件上方的情况下移动鼠标时,由组件调度。 | UIComponent | ||
![]() | 启动拖动操作时,由拖动启动器调度。 | UIComponent | ||
![]() | 在一个效果结束后调度。 | UIComponent | ||
![]() | 在即将开始播放效果前调度。 | UIComponent | ||
![]() | 播放头进入新帧时调度。 | DisplayObject | ||
![]() | 组件返回到根视图状态之后调度。 | UIComponent | ||
![]() | 组件退出根视图状态之前调度。 | UIComponent | ||
![]() | 显示对象获得焦点后调度。 | InteractiveObject | ||
![]() | 显示对象失去焦点后调度。 | InteractiveObject | ||
![]() | 当对象的状态从可见变为不可见时调度。 | UIComponent | ||
![]() | 当组件完成构建并设置了所有初始化属性后调度。 | 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 | ||
![]() | 在组件初始化序列开始时调度。 | UIComponent | ||
![]() | 使用 removeChild() 或 removeChildAt() 方法将组件作为内容子项从容器中删除时调度。 | UIComponent | ||
![]() | 将要从显示列表中删除显示对象时调度。 | DisplayObject | ||
![]() | 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | ||
![]() | 将要更新和呈现显示列表时调度。 | DisplayObject | ||
![]() | 在调整组件大小时调度。 | UIComponent | ||
![]() | 当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
![]() | 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | ||
![]() | 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
![]() | 当滚动内容时调度。 | ScrollControlBase | ||
![]() | 当对象的状态从不可见变为可见时调度。 | UIComponent | ||
![]() | 对象的 tabChildren 标志值发生更改时调度。 | InteractiveObject | ||
![]() | 对象的 tabEnabled 标志发生更改时调度。 | InteractiveObject | ||
![]() | 对象的 tabIndex 属性值发生更改时调度。 | InteractiveObject | ||
![]() | 要创建 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 已隐藏组件的 ToolTip 并要将其放弃时由组件调度。 | UIComponent | ||
![]() | 要隐藏组件的 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 要显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 用户将鼠标移动到设置了 toolTip 属性的组件上方后,由该组件调度。 | UIComponent | ||
![]() | 当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度(如果需要)。 | UIComponent | ||
![]() | 当组件由 Validator 监控并且成功通过验证时调度。 | UIComponent | ||
![]() | 当以编程方式或通过用户交互更改值时调度。 | UIComponent | ||
| 样式 | 说明 | 定义方 | ||
|---|---|---|---|---|
alternatingItemColors | 类型: Array 格式: Color CSS 继承: yes 列表中项目使用的背景色。此值是由两种或更多种颜色组成的数组。列表项目的背景色将从数组中的各种颜色之间选取。 对于 DataGrid 控件,行中的所有项目都使用相同的背景色,而每行的背景色都由颜色数组确定。 对于只使用一个列表填充二维显示的 TileList 控件,此样式可根据指定的列数、行数和颜色数生成棋盘外观、条纹或其它图案。TileList 循环使用各种颜色,根据布局方向设置各个项目的背景色。如果您的 TileList 为水平布局,并且颜色数和列数均为偶数,则显示条纹图案。如果列数为奇数,则显示棋盘图案。 仅当未指定 undefined. | ListBase | ||
![]() | 类型: Number CSS 继承: nobackgroundColor 属性定义的颜色和 backgroundImage 样式定义的图像或 SWF 文件的 Alpha 级别。有效值范围为从 0. | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: no 组件的背景颜色。您可以同时设置 backgroundColor 和 backgroundImage。一些组件没有背景。DataGrid 控件会忽略此样式。默认值为 undefined,即不进行设置。如果此样式和 backgroundImage 样式都为 undefined,则控件将采用透明背景。 对于 Application 容器,此样式指定应用程序加载时的背景色以及运行该应用程序时的背景渐变。Flex 计算比指定颜色略深的颜色和比指定颜色略浅的颜色之间的渐变。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景颜色将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx:Container backgroundColor="0x66CC66"/> <mx:ControlName ... | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用组件时的组件的背景颜色。全局默认值为 undefined。List 控件的默认值为 0xDDDDDD(浅灰)。如果禁用了容器,背景将变暗,而暗淡程度由 disabledOverlayAlpha 样式控制。. | ScrollControlBase | ||
![]() | 类型: Object 格式: File CSS 继承: no 组件的背景图像。此样式可以是绝对或相对 URL 或类。您可以同时设置 backgroundColor 和 backgroundImage。背景图像显示在背景色上面。默认值为 undefined,表示“未设置”。如果此样式和 backgroundColor 样式都未定义,则控件将采用透明背景。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景图像将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx:Container backgroundColor="0x66CC66"/> <mx:ControlName ... | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 将 backgroundImage 指定的图像缩放到不同的百分比大小。"100%" 值将拉抻该图像以适应整个组件。要指定百分比值,您必须输入百分号 (%)。Application 容器的默认值为 100%。所有其它容器的默认值为 auto,此值将保持图像的原始大小。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位)。如果设置此样式,则组件的基线锚定在其内容区域的上边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: uint 格式: Color CSS 继承: no 边框颜色。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 0xB7BABC。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 边框边。指定要显示的边框边的以空格分隔的 String。此 String 可以任意顺序包含 "left"、"top"、"right" 和 "bottom"。默认值为 "left top right bottom",此值会显示所有四条边。仅当 borderStyle 为 "solid" 时才使用此样式。. | ScrollControlBase | ||
![]() | 类型: Class CSS 继承: no 组件的边框外观类。mx. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 边框样式。可能值为 "none"、"solid"、"inset" 和 "outset"。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 "inset"。大多数容器的默认值为 "none"。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 边框厚度。仅在将 borderStyle 设置为 "solid" 时使用。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从组件的下边缘到其内容区域的下边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的下边缘锚定在其内容区域的下边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 组件中文本(包括组件标签)的颜色。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 组件角的半径。默认值取决于组件类;如果未覆盖类的默认值,则默认值为 0。对于 ApplicationControlBar,默认值为 5。. | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用时组件中文本的颜色。. | ScrollControlBase | ||
dropIndicatorSkin | 类型: Class CSS 继承: no 用于指示所拖动项目的放置位置的外观。如果拖放操作的目标位置可能是 ListBase-derived 组件,则调用 showDropFeedback() 方法将产生此类的实例,并将该实例定位在所放置项目之后项目的 itemRenderer 上方一个像素处(如果进行放置)。
默认值为 mx.controls.listClasses.ListDropIndicator. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 投影颜色。. | ScrollControlBase | ||
![]() | 类型: Boolean CSS 继承: no 指定组件是否具有可见投影的布尔值属性。此样式与 borderStyle="solid" 一起使用。默认值为 false。 注意:对于显示在容器上的投影,需设置 | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 验证失败时,组件加亮部分的颜色。验证失败时,Flex 还会将组件的 borderColor 样式设置为 errorColor。. | UIComponent | ||
focusAlpha | 类型: Number CSS 继承: no 指定焦点外观的 alpha 透明度值。 默认值为 0.4. | ListBase | ||
![]() | 类型: String CSS 继承: no 焦点矩形使用的混合模式。有关详细信息,请参阅 flash. | UIComponent | ||
focusRoundedCorners | 类型: String CSS 继承: no 指定焦点矩形的哪些角应该是圆角。此值是使用空格分隔的 String,该 String 可以是 "tl"、"tr"、"bl" 和 "br" 的任意组合。例如,要指定右侧的角为圆角,左侧的角为直角,应使用 "tr br"。cornerRadius 样式属性指定圆角的半径。默认值取决于组件类;如果未覆盖该类的默认值,则默认值为 "tl tr bl br"。
| ListBase | ||
![]() | 类型: Class CSS 继承: no 用于绘制焦点矩形的外观。. | UIComponent | ||
![]() | 类型: Number 格式: Length CSS 继承: no 焦点矩形轮廓的粗细,以像素为单位。. | UIComponent | ||
![]() | 类型: String CSS 继承: yes 设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash. | ScrollControlBase | ||
![]() | 类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 .另请参见 | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 确定文本是否使用斜体。可识别的值为 "normal" 和 "italic"。. | ScrollControlBase | ||
![]() | 类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 .另请参见 | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 确定文本是否使用粗体。可识别的值为 normal 和 bold。Button 控件的默认值为 bold。所有其它控件的默认值为 normal。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的水平距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整组件容器大小后,这两个中心将保持它们的水平间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: String CSS 继承: no 水平 scrollbar 的样式名称。通过它,可以更精细地控制滚动条的外观。. | ScrollControlBase | ||
![]() | 类型: Boolean CSS 继承: yes 一个布尔值,指示是启用 ( true) 还是禁用 (false) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本行之间附加的垂直空间。 默认值为 2。 ComboBox 控件的默认值为 0。 . | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的左边缘到组件左边缘的水平距离(以像素为单位)。如果设置此样式,则组件的左边缘锚定在其内容区域的左边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: Number CSS 继承: yes 各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。. | ScrollControlBase | ||
paddingBottom | 类型: Number 格式: Length CSS 继承: no 行的底部与该行中渲染器底部之间的像素数目。 默认值为 2. | ListBase | ||
paddingLeft | 类型: Number 格式: Length CSS 继承: no 组件左边框与其内容区域左边缘之间的像素数目。 默认值为 0。 Button 控件的默认值为 10。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 Tree 控件的默认值为 2。 | ListBase | ||
paddingRight | 类型: Number 格式: Length CSS 继承: no 组件右边框与其内容区域右边缘之间的像素数目。 默认值为 0。 Button 控件的默认值为 10。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 | ListBase | ||
paddingTop | 类型: Number 格式: Length CSS 继承: no 行的顶部与该行中渲染器顶部之间的像素数目。 默认值为 2. | ListBase | ||
![]() | 类型: String CSS 继承: no 从组件的右边缘到其内容区域的右边缘的水平距离(以像素为单位)。如果设置此样式,则组件的右边缘锚定在其内容区域的右边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
rollOverColor | 类型: uint 格式: Color CSS 继承: yes 用户滚过鼠标时渲染器的背景色。 默认值为 0xEEFEE6. | ListBase | ||
selectionColor | 类型: uint 格式: Color CSS 继承: yes 用户选中此组件时渲染器的背景色。 默认值为 0x7FCEFF. | ListBase | ||
selectionDisabledColor | 类型: uint 格式: Color CSS 继承: yes 禁用此组件时渲染器的背景色。 默认值为 0xDDDDDD. | ListBase | ||
selectionDuration | 类型: Number 格式: Time CSS 继承: no 选择效果的持续时间。如果选中了某个项目,则在背景着色时会播放相应的效果。设置为 0 可禁用此效果。 默认值为 250. | ListBase | ||
selectionEasingFunction | 类型: Function CSS 继承: no 针对选项效果的 easingFunction。如果选中了某个项目,则在背景着色时会播放相应的效果。默认效果为颜色的线性淡入淡出。easingFunction 可用于控制选择效果。 默认值为 undefined. | ListBase | ||
![]() | 类型: String CSS 继承: no 投影方向。可能值包括 "left"、"center" 和 "right"。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 投影距离。如果将此属性设置为负值,此阴影将出现在组件的上方。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 容器内文本的对齐情况。可能值有: "left"、"right" 或 "center"。 大多数组件的默认值为 | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 确定文本是否加下划线。可能值有: "none" 和 "underline"。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本第一行偏离容器左侧的距离(以像素为单位)。. | ScrollControlBase | ||
textRollOverColor | 类型: uint 格式: Color CSS 继承: yes 用户滚过鼠标时渲染器文本的颜色。 默认值为 0x2B333C. | ListBase | ||
textSelectedColor | 类型: uint 格式: Color CSS 继承: yes 用户选中渲染器时其文本的颜色。 默认值为 0x2B333C. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示,但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值,但首选值为 haloGreen、haloBlue、haloOrange 和 haloSilver。 | UIComponent | ||
![]() | 类型: String CSS 继承: no 从控件内容区域的上边缘到组件上边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的上边缘锚定在其内容区域的上边缘;调整其容器大小后,这两个边缘将保持其间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
useRollOver | 类型: Boolean CSS 继承: no 一个标志,控制当鼠标滚过项目时是否加亮显示该项目。如果为 true,则当鼠标滚过行时加亮显示这些行。如果为 false,则只在选中行时才进行加亮显示。
默认值为 true. | ListBase | ||
verticalAlign | 类型: String CSS 继承: no 垂直对齐行中的渲染器。可能值包括 "top"、"middle" 和 "bottom"。DataGrid 根据此样式以及 paddingTop 和 paddingBottom 样式在行中定位渲染器。如果某一行上各列中项目的高度不等,则其它列表类不使用 verticalAlign,但项目渲染器可以检查此样式属性,并根据检查结果调整其布局。
默认值为 "top". | ListBase | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的垂直距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整其容器大小后,这两个中心将保持其垂直间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: String CSS 继承: no 垂直 scrollbar 的样式名称。通过它,可以更精细地控制滚动条的外观。. | ScrollControlBase | ||
| actualCollection | 属性 |
protected var actualCollection:ICollectionView
通常存储于运行数据更改效果时使用的 collection 中的值副本。当数据更改效果未运行时,此值应为空。
| actualIterator | 属性 |
protected var actualIterator:IViewCursor
通常存储于运行数据更改效果时使用的 iterator 中的值副本。
| allowDragSelection | 属性 |
public var allowDragSelection:Boolean = false一个标志,指示是否启用拖动选择。拖动选择能够通过拖动至某个项目来选中该项目;而在普通选择中,当鼠标悬停在要选择的项目上方时,不能按下鼠标按键。此功能适用于 ComboBox 下拉项,支持以下操作:当鼠标悬停在下拉按钮上方时按下鼠标按键,然后将鼠标拖动至下拉项选择一个项目。
默认值为 false.
| allowItemSizeChangeNotification | 属性 |
allowItemSizeChangeNotification:Boolean [] 如果设置为 false,则渲染器无法使 List 的大小失效
protected function set allowItemSizeChangeNotification(value:Boolean):void| allowMultipleSelection | 属性 |
allowMultipleSelection:Boolean []
一个标志,指示是否允许您同时选择多个项目。如果为 true,则用户可以选择多个项目。没有禁止不连续选择的选项。标准的复杂选择选项始终有效(按住 Shift 单击,按住 Ctrl 单击)。
默认值为 false.
public function get allowMultipleSelection():Boolean public function set allowMultipleSelection(value:Boolean):void| anchorBookmark | 属性 |
protected var anchorBookmark:CursorBookmark作为锚点的项目的书签。借助书签,该组件可快速搜索项目集合中的某个位置。当选择锚点与尖号或加亮显示的项目之间的一组项目时,或在应用 Sort 或 Filter 后查找所选项目时,使用此属性。
| anchorIndex | 属性 |
protected var anchorIndex:int = -1作为选择锚点的数据提供程序中项目的偏移量。
| cachedItemsChangeEffect | 属性 |
protected var cachedItemsChangeEffect:IEffect = null当控件的数据提供程序中发生更改时播放的效果,通过 itemsChangeEffect 样式设置。
| caretBookmark | 属性 |
protected var caretBookmark:CursorBookmark尖号下方项目的书签。借助书签,该组件可快速搜索项目集合中的某个位置。
| caretIndex | 属性 |
| caretIndicator | 属性 |
protected var caretIndicator:Sprite包含图形的 DisplayObject,该图形指示哪个渲染器是尖号。
| caretItemRenderer | 属性 |
protected var caretItemRenderer:IListItemRenderer尖号下方项目的渲染器。选择模型中包含一个锚点、一个尖号和一个加亮显示的项目。如果正在使用鼠标进行选择,则当鼠标滚过时,鼠标下方的项目将加亮显示。如果单击鼠标时不使用功能键(Shift 或 Ctrl),将清除所选项目组,加亮显示的项目将被选中并变为锚点。使用鼠标选择时不使用尖号。如果已存在一个锚点并使用 Shift 键选中了另一个项目,则将清除旧的所选项目组,并选中此项目与锚点之间的所有项目。当按住 Ctrl 键单击项目时,可切换单个项目的选择但不移动锚点。
使用键盘选择项目时,如果箭头键未与功能键配合使用,则将清除旧选择并选择新项目,新项目将成为锚点和尖号,同时在加亮显示的选中内容周围显示尖号指示符。如果用户结合使用箭头键和 Shift 键,将清除旧的选择并选择锚点与新项目之间的项目。此时尖号将移至新项目。如果将箭头键和 Ctrl 键同时使用,则只移动尖号。用户可以使用空格键切换尖号下的项目的选择。
| caretUID | 属性 |
protected var caretUID:String尖号下方项目的 UID。
| collection | 属性 |
protected var collection:ICollectionView
用于提供数据提供程序的 ICollectionView。当设置 dataProvider 属性时,Flex 将根据需要包装数据提供程序以支持 ICollectionView 接口,并将此属性设置为该结果。然后,ListBase 类使用此属性访问提供程序中的数据。获取 dataProvider 属性后,Flex 将返回此值。
| columnCount | 属性 |
columnCount:int [] 在 TileList 控件中显示的列数,或在 HorizontalList 控件中显示的项目数。对于 DataGrid 而言,这是可见列的数目。注意:设置此属性对 DataGrid 控件不起任何作用,此控件基于控件的宽度和各列的宽度来确定列数。
默认值为 4.
public function get columnCount():int public function set columnCount(value:int):void| columnWidth | 属性 |
columnWidth:Number [] 控件中列的宽度。此属性用于 TileList 和 HorizontalList 控件;该属性对可以设置各 DataGridColumn 宽度的 DataGrid 控件不起作用。
默认值为 50.
public function get columnWidth():Number public function set columnWidth(value:Number):void| data | 属性 |
data:Object [] 将此组件用作项目渲染器或项目编辑器时,此组件应呈现的数据提供程序中的项目。列表类将在各个渲染器或编辑器上设置此属性,并且组件将显示数据。ListBase-derived 类支持将此属性用于复杂情况,例如存在 DataGrid 列表或者 DataGrid(其中一列就是一个 List)的情况。
除了 data 属性外,列表类还使用 listData 属性,用以确定显示内容。如果列表类位于 DataGrid 中,则它需要将列的 dataField 属性映射到数据中的某个属性,并为该属性设置 selectedItem 值。如果列表类位于 List 或 TileList 控件中,则它需要将列表的 labelField 属性映射到数据中的某个属性,并为该属性设置 selectedItem 值。否则,它会将 selectedItem 设置为数据本身。
此属性使用数据提供程序,但不对其进行设置。在任何情况下,都必须以其它方式设置数据提供程序。
不要以 MXML 方式设置此属性。
此属性可用作数据绑定的源。
public function get data():Object public function set data(value:Object):void另请参见
| dataEffectCompleted | 属性 |
protected var dataEffectCompleted:Boolean = false
一个标志,指示数据更改效果已完成。组件的响应方式通常是在下次调用 updateDisplayList() 时清除各种内部数据结构。
| dataItemWrappersByRenderer | 属性 |
protected var dataItemWrappersByRenderer:Dictionary将项目渲染器映射到 ItemWrappers(用于提供其数据)的 dictionary。仅当运行数据效果时才适用。
| dataProvider | 属性 |
dataProvider:Object []
要查看的数据集。此属性允许您将大多数类型的对象用作数据提供程序。如果将 dataProvider 属性设置为 Array,则会将其转换为 ArrayCollection。如果将该属性设置为 XML 对象,则会将其转换为仅包含一个项目的 XMLListCollection。如果将该属性设置为 XMLList,则会将其转换为 XMLListCollection。如果将该属性设置为实现 IList 或 ICollectionView 接口的对象,则可直接应用此对象。
受转换操作的影响,在您获取 dataProvider 属性时,该属性值将始终为 ICollectionView,所以此值不一定是您设置的对象类型。如果要修改数据提供程序中的数据,则了解以下行为非常重要:可能不会检测对原始数据所做的更改,但将检测对从 dataProvider 属性获取的 ICollectionView 对象所做的更改。
默认值为 null.
此属性可用作数据绑定的源。
public function get dataProvider():Object public function set dataProvider(value:Object):void另请参见
| dataTipField | 属性 |
dataTipField:String []
数据提供程序项目中作为数据提示显示的字段名称。默认情况下,该列表将在每个项目上查找 label 属性并将其显示出来。但是,如果数据对象中不包含 label 属性,则可以将 dataTipField 属性设置为使用数据对象中的其它属性。例如,在查看从数据库中检索的一组人名时,可以使用“FullName”。
默认值为 null.
此属性可用作数据绑定的源。
public function get dataTipField():String public function set dataTipField(value:String):void| dataTipFunction | 属性 |
dataTipFunction:Function []
用户提供的函数,在各个项目上运行以确定其数据提示。默认情况下,该列表将在每个数据提供程序项目上查找 label 属性并将其显示出来。但是,一些项目不包含 label 属性,也不包含可供在行中显示的其它属性。例如,数据集中包含 lastName 和 firstName 字段,但您希望显示全名。您可以提供一个 dataTipFunction,用于查找合适的字段并返回可显示的字符串。dataTipFunction 还非常适用于处理格式设置和本地化。
dataTipFunction 仅使用数据提供程序中的某个项目作为唯一参数,并返回一个 String:
默认值为 null.
此属性可用作数据绑定的源。
public function get dataTipFunction():Function public function set dataTipFunction(value:Function):void| defaultColumnCount | 属性 |
protected var defaultColumnCount:int = 4要显示的默认列数。当尝试根据大小或内容计算 columnCount 时,如果计算所得的列数值小于 1,则使用此值。
默认值为 4.
| defaultRowCount | 属性 |
protected var defaultRowCount:int = 4要显示的默认行数。当尝试根据大小或内容计算 rowCount 时,如果计算所得的列数值小于 1,则使用此值。
默认值为 4.
| dragEnabled | 属性 |
dragEnabled:Boolean []
一个标志,指示是否可以将项目拖出此控件并放到其它控件上。如果设置为 true,则表示可以在该控件中进行拖动。如果 dropEnabled 属性同样设置为 true,您就可以在该控件中拖放项目进行重新排序。
默认值为 false.
public function get dragEnabled():Boolean public function set dragEnabled(value:Boolean):void| dragImage | 属性 |
dragImage:IUIComponent [] 获取可显示拖放操作中的可视效果的类实例。
默认值为 mx.controls.listClasses.ListItemDragProxy.
protected function get dragImage():IUIComponent| dragImageOffsets | 属性 |
| dragMoveEnabled | 属性 |
dragMoveEnabled:Boolean []
一个标志,指示在拖放操作过程中是否可以移动控件中的项目,而不只是从控件中复制这些项目。如果此属性设置为 true,dragEnabled 属性设置为 true,就可以移动项目。通常情况下,不能或不应移除数据提供程序中的项目,因此在拖放过程中不应允许移动操作。
默认值为 false.
public function get dragMoveEnabled():Boolean public function set dragMoveEnabled(value:Boolean):void| dropEnabled | 属性 |
dropEnabled:Boolean [] 一个标志,指示是否可以将所拖动的项目放到此控件上。
如果将此属性设置为 true,则该控件将接受所有数据格式,并假定所拖动的数据与数据提供程序中数据的格式相匹配。如果要显式检查正在拖动的数据的数据格式,您必须处理一个或多个拖动事件(如 dragOver),并调用 DragEvent 的 preventDefault() 方法来自定义列表类接受拖放数据的方式。
将 dropEnabled 设置为 true 时,Flex 会自动调用 showDropFeedback() 和 hideDropFeedback() 方法来显示拖放指示符。
默认值为 false.
public function get dropEnabled():Boolean public function set dropEnabled(value:Boolean):void| explicitColumnCount | 属性 |
protected var explicitColumnCount:int = -1
显式设置 columnCount 属性时需要的列计数。
| explicitColumnWidth | 属性 |
protected var explicitColumnWidth:Number
显式设置 columnWidth 时需要的列宽。
| explicitRowCount | 属性 |
protected var explicitRowCount:int = -1
显式设置 rowCount 时需要的行计数。
| explicitRowHeight | 属性 |
protected var explicitRowHeight:Number
显式设置 rowHeight 时需要的行高。
| factoryMap | 属性 |
protected var factoryMap:Dictionary项目渲染器基于工厂的映射。此属性是一个基于 itemRenderer(其值为 IFactory)编制索引的 Dictionary
| freeItemRenderers | 属性 |
protected var freeItemRenderers:Array闲置项目渲染器的堆栈。多数列表类都会在滚动出可显示区域时回收已创建的渲染器;这样可在滚动期间节省时间。重复使用的渲染器都存储在该位置。
| freeItemRenderersByFactory | 属性 |
protected var freeItemRenderersByFactory:Dictionary空闲项目渲染器基于工厂的映射。此属性是一个基于工厂(其值为 itemRenderer 的 Dictionaries)编制索引的 Dictionary
| highlightIndicator | 属性 |
protected var highlightIndicator:Sprite包含图形的 DisplayObject,用以指示加亮哪个渲染器。
| highlightItemRenderer | 属性 |
protected var highlightItemRenderer:IListItemRenderer当前滚动到尖号上方或下方的渲染器。
| highlightUID | 属性 |
protected var highlightUID:String当前滚动到尖号上方或下方的项目的 UID。
| iconField | 属性 |
iconField:String [] 数据提供程序对象中字段的名称,该字段用于确定显示为图标的对象。默认情况下,列表类不会尝试将图标与行中的文本一起显示。但是,您可以通过指定图标字段来指定一个图形,将其作为图标创建并显示在行中。DataGrid 将忽略此属性。
渲染器将在数据提供程序对象中查找名为 iconField 的属性。如果该属性的值是类,将对此类进行实例化并使其成为 IFlexDisplayObject 实例。如果该属性的值是 String,将从应用程序中查找是否存在同名的类;如果没有,还将从文档中查找同名的属性,并将该属性映射到某个类中。
默认值为 null.
此属性可用作数据绑定的源。
public function get iconField():String public function set iconField(value:String):void| iconFunction | 属性 |
iconFunction:Function [] 用户提供的函数,在每个项目上运行以确定其图标。默认情况下,列表类不会尝试将图标与行中的文本一起显示。但是,您可以通过指定图标函数来为图形指定一个类,将其作为图标创建并显示在行中。DataGrid 将忽略此属性。
iconFunction 仅采用数据提供程序中的某个项目作为唯一参数,并返回一个类。
默认值为 null.
此属性可用作数据绑定的源。
public function get iconFunction():Function public function set iconFunction(value:Function):void| itemRenderer | 属性 |
itemRenderer:IFactory [] 控件的自定义项目渲染器。您可以指定嵌入式、内嵌或自定义项目渲染器。
默认的项目渲染器取决于组件类。TileList 和 HorizontalList 类使用 TileListItemRenderer;List 类使用 ListItemRenderer。DataGrid 类使用 DataGridColumn 中的 DataGridItemRenderer。
public function get itemRenderer():IFactory public function set itemRenderer(value:IFactory):void| itemsNeedMeasurement | 属性 |
protected var itemsNeedMeasurement:Boolean = true
一个标志,指示是否需要计算 columnWidth 和 rowHeight 属性。如果样式更改可影响渲染器的测量结果,或数据提供程序发生更改,将设置此属性。
| itemsSizeChanged | 属性 |
protected var itemsSizeChanged:Boolean = false
一个标志,指示渲染器的大小可能已更改。组件的响应方式通常是在下次调用 updateDisplayList() 时,对所有渲染器重新应用数据项目。假定重新应用项目将使项目渲染器失效并重新进行测量。
| iterator | 属性 |
protected var iterator:IViewCursor主 IViewCursor,用于从数据提供程序中获取项目并将这些项目传递到渲染器。在任何代码顺序的结尾,都必须始终将其放置在所显示的最上方可视项目处。
| iteratorValid | 属性 |
protected var iteratorValid:Boolean = true
一个标志,指示发生页面错误和迭代器位置无效(未放置在所显示的最上方项目处)。如果组件出现页面错误(ItemPending 错误),它会将 iteratorValid 设置为 false。通常用于处理项目呈现问题的代码将检查此标志,并且直到从服务器传来数据页面才运行。
| keySelectionPending | 属性 |
protected var keySelectionPending:Boolean = false
一个标志,指示键盘选择是否由于页面错误而中断。组件的响应方式是暂停呈现项目,直到数据页面显示。显示分页的数据时,将调用 finishKeySelection() 方法
| labelField | 属性 |
labelField:String []
数据提供程序项目中作为标签显示的字段名称。默认情况下,列表将在每个项目上查找 label 属性并将其显示出来。但是,如果该数据对象不包含 label 属性,则可以将 labelField 属性设置为使用数据对象中的其它属性。例如,在查看从数据库中提取的一组人名时,可以使用“FullName”。
默认值为 "label".
此属性可用作数据绑定的源。
public function get labelField():String public function set labelField(value:String):void| labelFunction | 属性 |
labelFunction:Function []
用户提供的函数,在每个项目上运行以确定其标签。默认情况下,该列表将在每个数据提供程序项目上查找 label 属性并将其显示出来。但是,一些数据集不包含 label 属性,也不包含可用于显示的其它属性。例如,数据集中包含 lastName 和 firstName 字段,但您希望显示全名。
您可以提供一个 labelFunction,用于查找合适的字段并返回可显示的字符串。labelFunction 还非常适用于处理格式设置和本地化。
对于大多数组件而言,此标签函数仅使用数据提供程序中的某个项目作为唯一参数,并返回一个 String。
myLabelFunction(item:Object):String
DataGrid 和 DataGridColumn 类的方法签名是:
myLabelFunction(item:Object, column:DataGridColumn):String
其中,item 包含 DataGrid 项目对象,并且 column 指定 DataGrid 列。
默认值为 null.
此属性可用作数据绑定的源。
public function get labelFunction():Function public function set labelFunction(value:Function):void| lastDropIndex | 属性 |
protected var lastDropIndex:int最近计算出的索引,这是拖动项目在放置目标中的添加位置。
| lastSeekPending | 属性 |
protected var lastSeekPending:ListBaseSeekPending导致页面错误的最新一次搜寻。如果存在多个页面错误,则只考虑最近的页面错误,因为这是迭代器所处的位置,还是重新呈现行的开始位置。
| listContent | 属性 |
protected var listContent:ListBaseContentHolder
一个内部显示对象,是所有项目渲染器、选择内容、亮显指示符以及其它支持图形的父级。它大致与 Container 类中的 contentPane 相等,用于管理滚动。
| listContentStyleFilters | 属性 |
listContentStyleFilters:Object [] 从 ListBase 传递到 listContent 的一组样式。
protected function get listContentStyleFilters():Object另请参见
| listData | 属性 |
listData:BaseListData []
如果使用组件作为嵌入式项目渲染器或嵌入式项目编辑器,则 Flex 将使用 list 控件中的其它数据初始化组件的 listData 属性。然后,该组件可以使用 listData 属性和 data 属性显示作为嵌入式项目渲染器或嵌入式项目编辑器的相应信息。
您无需在 MXML 或 ActionScript 中设置此属性;将组件用作嵌入式项目渲染器或嵌入式项目编辑器时,Flex 会对其进行设置。
此属性可用作数据绑定的源。
public function get listData():BaseListData public function set listData(value:BaseListData):void另请参见
| listItems | 属性 |
listItems:Array [] 一个由数组组成的数组,其中包含用于呈现每个数据提供程序项目的 itemRenderer 实例。这是一个行主序的二维数组(由列数组组成的行数组)。
protected function get listItems():Array| menuSelectionMode | 属性 |
public var menuSelectionMode:Boolean = false一个标志,指示是否应使用菜单样式选择。在 Menu 中,从一个渲染器拖动到另一个渲染器将选择新渲染器并取消选择旧渲染器。
| modifiedCollectionView | 属性 |
protected var modifiedCollectionView:ModifiedCollectionView集合视图,用于暂时保留上次的数据提供程序状态,以方便运行数据更改效果。
| nullItemRenderer | 属性 |
nullItemRenderer:IFactory [] 控件的自定义项目渲染器。您可以指定嵌入式、内嵌或自定义项目渲染器。
默认的项目渲染器取决于组件类。TileList 和 HorizontalList 类使用 TileListItemRenderer;List 类使用 ListItemRenderer。DataGrid 类使用 DataGridColumn 中的 DataGridItemRenderer。
public function get nullItemRenderer():IFactory public function set nullItemRenderer(value:IFactory):void| offscreenExtraColumns | 属性 |
protected var offscreenExtraColumns:int = 0
用于控件布局的项目渲染器的额外列的目标数量。其中半数的列创建在屏幕上可见列的左侧;另一半创建在右侧。通常,设置 offscreenExtraRowsOrColumns 属性时将间接设置此属性。
默认值为 0.
| offscreenExtraColumnsLeft | 属性 |
protected var offscreenExtraColumnsLeft:int = 0
当前位于最左侧可视列左侧的屏幕外的列数。此值将为 <= offscreenExtraColumns / 2。
默认值为 0.
| offscreenExtraColumnsRight | 属性 |
protected var offscreenExtraColumnsRight:int = 0
当前位于最右侧可视列右侧的屏幕外的列数。此值将为 <= offscreenExtraColumns / 2。
默认值为 0.
| offscreenExtraRows | 属性 |
protected var offscreenExtraRows:int = 0
要用于控件布局的项目渲染器中额外行的目标数量。其中半数的行创建在屏幕上可见行的上方;另一半创建在下方。通常,设置 offscreenExtraRowsOrColumns 属性时将间接设置此属性。
默认值为 0.
| offscreenExtraRowsBottom | 属性 |
protected var offscreenExtraRowsBottom:int = 0
当前位于底部可视渲染器下方的屏幕外的项目数。此值将为 <= offscreenExtraRows / 2。
默认值为 0.
| offscreenExtraRowsOrColumns | 属性 |
offscreenExtraRowsOrColumns:int [] 项目渲染器的额外行或列的目标数量,供在控件布局中使用。其中半数的行/列在屏幕上可见行/列的顶部或左侧创建;另一半在其底部或右侧创建。
创建行还是列取决于控件及其属性。通常情况下将使用行,但 TileBase 组件除外,该组件的 direction 设置为 TileBaseDirection.VERTICAL。此时将创建列。
在对 List 或 TileList 控件应用数据效果时,通常将此属性设置为非零值。如果更改影响与当前可见项目对应的数据提供程序元素,或者影响数据提供程序元素中可见项目前后指定数目的项目,则所做的更改会触发数据效果。数据效果可能不会对此范围之外的数据提供程序元素进行完善的动画处理。
此属性很有用,因为数据效果的工作原理是:先确定基于列表的控件的“动画前”布局,然后确定“动画后”布局,最后设置效果的属性以创建从动画前布局到动画后布局的动画。由于许多效果都可以将当前不可见的项目更改为可见,或者将当前可见的项目更改为不可见,所以此属性将该控件配置为创建屏幕外项目渲染器,以便在播放数据效果时这些项目已然存在。
此属性的合理值可能是屏幕上的可见行数。如果将此值设置得过大,则在用于包含大量元素的数据提供程序时可能会导致性能问题。
默认值为 0.
public function get offscreenExtraRowsOrColumns():int public function set offscreenExtraRowsOrColumns(value:int):void| offscreenExtraRowsOrColumnsChanged | 属性 |
protected var offscreenExtraRowsOrColumnsChanged:Boolean = false一个标志,指示屏幕外的行数或列数可能已更改。
| offscreenExtraRowsTop | 属性 |
protected var offscreenExtraRowsTop:int = 0
当前位于最顶部可见行上方的屏幕外的行数。此值将为 <= offscreenExtraRows / 2。当计算 listItems 和 rowInfo 数组与数据提供程序中项目的关系时使用(与 verticalScrollPosition 属性配合使用)。
默认值为 0.
| rendererChanged | 属性 |
protected var rendererChanged:Boolean = false
一个标志,指示渲染器已更改。组件的响应方式通常是在下次调用 updateDisplayList() 时毁掉所有现有渲染器并重新绘制所有渲染器。
| reservedItemRenderers | 属性 |
protected var reservedItemRenderers:Object当前闲置但近期可能会用到的项目渲染器的哈希映射。当运行数据效果时使用。此映射按数据提供程序项目的 UID 编制索引。
| rowCount | 属性 |
rowCount:int [] 要显示的行数。如果已经显式设置该组件的高度,则此属性可能不会产生任何效果。
对于 DataGrid 控件,rowCount 属性包含标题行。因此,对于包含 3 个正文行和 1 个标题行的 DataGrid 控件,其 rowCount 属性为 4。
默认值为 4.
public function get rowCount():int public function set rowCount(value:int):void| rowHeight | 属性 |
rowHeight:Number []
行高(以像素为单位)。只有在 variableRowHeight 属性设置为 true 时,所有的行高才相等。如果未指定此属性,则行高基于字体大小和渲染器的其它属性而定。
public function get rowHeight():Number public function set rowHeight(value:Number):void| rowInfo | 属性 |
rowInfo:Array [] ListRowInfo 对象数组,这些对象用于缓存行高和 listItems 中行的其它跟踪信息。
protected function get rowInfo():Array| rowMap | 属性 |
protected var rowMap:Object项目渲染器与其各自 ListRowInfo 对象的哈希映射。ListRowInfo 对象按项目渲染器的 DisplayObject 名称编制索引。
| runDataEffectNextUpdate | 属性 |
protected var runDataEffectNextUpdate:Boolean = false一个标志,指示下次更新显示时是否应该启动数据效果。
| runningDataEffect | 属性 |
protected var runningDataEffect:Boolean = false一个标志,指示当前是否正在运行数据更改效果
| selectable | 属性 |
selectable:Boolean []
一个标志,指示列表是否将所选项目显示为选中状态。如果设置为 true,则控件支持选项。默认情况下,作为 ListBase 子类的 Menu 类将此属性设置为 false,因为它不会将所选菜单项显示为选中状态。
默认值为 true.
public function get selectable():Boolean public function set selectable(value:Boolean):void| selectedData | 属性 |
| selectedIndex | 属性 |
selectedIndex:int [] 所选项目的数据提供程序中的索引。
默认值是 -1(无选中项目)。
此属性可用作数据绑定的源。
public function get selectedIndex():int public function set selectedIndex(value:int):void| selectedIndices | 属性 |
selectedIndices:Array [] 数据提供程序中所选项目的索引的数组。这些项目的顺序与用户选择项目的顺序相反。
默认值为 [ ].
此属性可用作数据绑定的源。
public function get selectedIndices():Array public function set selectedIndices(value:Array):void| selectedItem | 属性 |
selectedItem:Object [] 对数据提供程序中所选项目的引用。
默认值为 null.
此属性可用作数据绑定的源。
public function get selectedItem():Object public function set selectedItem(value:Object):void| selectedItems | 属性 |
selectedItems:Array [] 对数据提供程序中所选项目的引用的数组。这些项目的顺序与用户选择项目的顺序相反。
默认值为 [ ].
此属性可用作数据绑定的源。
public function get selectedItems():Array public function set selectedItems(value:Array):void| selectionIndicators | 属性 |
protected var selectionIndicators:Object所选指示符的哈希表。当清除所选项目组后,此表允许组件快速查找和移除指示符。此表按项目的 UID 编制索引。
| selectionLayer | 属性 |
protected var selectionLayer:Sprite
listContent 中的图层,用于绘制所有选择内容和加亮指示符。
| selectionTweens | 属性 |
protected var selectionTweens:Object所选内容补间的哈希表。清除所选项目组后,此表允许组件快速查找和清除正在处理的任何补间。此表按项目的 UID 编制索引。
| showCaret | 属性 |
protected var showCaret:Boolean
一个标志,指示是否显示尖号。通常,当检测到鼠标活动时,此属性设置为 false;当使用键盘进行选择时,将重新设置为 true。
| showDataTips | 属性 |
showDataTips:Boolean []
一个标志,指示是否为行中的文本显示数据提示。如果为 true,则显示数据提示。数据提示是一些工具提示,用于显示对行而言过长的文本。如果设置了 dataTipFunction,则无论文本对行而言是否过长都会显示数据提示。
默认值为 false.
此属性可用作数据绑定的源。
public function get showDataTips():Boolean public function set showDataTips(value:Boolean):void| unconstrainedRenderers | 属性 |
protected var unconstrainedRenderers:Dictionary不受列表布局算法影响的项目渲染器的哈希映射
| value | 属性 |
value:Object [] 所选项目,或者所选项目的数据或标签字段。如果所选项目是 Number 或 String,则其值为此项目。如果所选项目是对象,则该值为 data 属性(如果存在)或 label 属性(如果存在)。
注意:通常首选使用 selectedItem。此属性可实现与旧应用程序的向后兼容性。
此属性可用作数据绑定的源。
public function get value():Object| variableRowHeight | 属性 |
variableRowHeight:Boolean []
一个标志,指示各行是否可以采用不同的高度。TileList 和 HorizontalList 将忽略此属性。如果设置为 true,则各行可以具有不同的高度值。
默认值为 false.
public function get variableRowHeight():Boolean public function set variableRowHeight(value:Boolean):void| visibleData | 属性 |
visibleData:Object [] 视图中当前使用的数据提供程序项目渲染器的哈希表。此表根据数据提供程序项目的 UID 编入索引,可从中快速获得显示特定项目所使用的渲染器。
protected function get visibleData():Object| wordWrap | 属性 |
wordWrap:Boolean []
一个标志,指示行中的文本是否应自动换行。如果设置为 true,则对行中文本启用自动换行。只有在 variableRowHeight 属性也设置为 true 时才会起作用。
默认值为 false.
public function get wordWrap():Boolean public function set wordWrap(value:Boolean):void| wordWrapChanged | 属性 |
protected var wordWrapChanged:Boolean = false
一个标志,指示自上次更新显示列表后 wordWrap 属性值是否已更改。更改 wordWrap 属性值时将设置此属性,并可通过 updateDisplayList() 方法将属性重置为 false。组件的响应方式通常是在下次调用 updateDisplayList() 时,对所有渲染器重新应用数据项目。这与 itemsSizeChanged 不同,它可以进一步指示将数据项目重新应用到渲染器不会使其失效,因为唯一发生变化的是,计算渲染器大小时是否应计入 wordWrap
| ListBase | () | 构造函数 |
public function ListBase()构造函数。
| addDataEffectItem | () | 方法 |
public function addDataEffectItem(target:Object):void如果正在运行数据更改效果,则添加项目渲染器。项目渲染器应与数据提供程序集合中最近添加但尚未显示的数据项目对应。
此函数将作为数据更改效果的一部分由 AddItemAction 效果调用,用以指定使用项目渲染器的控件开始显示添加到集合中的项目的时间点。
参数
target:Object — 要添加到控件布局中的项目渲染器。
|
| addDragData | () | 方法 |
protected function addDragData(ds:Object):void作为拖放操作的一部分,将所选项目添加到 DragSource 对象。覆盖此方法可将其它数据添加到拖动源。
参数
ds:Object — 在其中添加数据的 DragSource 对象。
|
| addToFreeItemRenderers | () | 方法 |
protected function addToFreeItemRenderers(item:IListItemRenderer):void将渲染器添加到循环使用的渲染器列表,使其不可见并清除对该渲染器的引用。如果正在运行某个数据效果,则将保留该渲染器以供那些数据以后使用。否则,会将其添加到常规 freeItemRenderers 堆栈中。
参数
item:IListItemRenderer — IListItemRenderer
|
| addToRowArrays | () | 方法 |
protected function addToRowArrays():void从用于存储对行的引用的数组开头添加一个空白行
| adjustListContent | () | 方法 |
protected function adjustListContent(unscaledWidth:Number = -1, unscaledHeight:Number = -1):void从 updateDisplayList() 调用此方法,以调整 listContent 的大小和位置。
参数
unscaledWidth:Number (default = -1) | |
unscaledHeight:Number (default = -1) |
| applySelectionEffect | () | 方法 |
protected function applySelectionEffect(indicator:Sprite, uid:String, itemRenderer:IListItemRenderer):void设置应用选择指示符的效果。默认为基本的 alpha 补间。
参数
indicator:Sprite — 一个 Sprite,其中包含表示选中内容的图形
| |
uid:String — 所选项目的 UID,可用于在表中编制索引并跟踪多个选择效果
| |
itemRenderer:IListItemRenderer — 显示为选中状态的项目渲染器
|
| calculateDropIndex | () | 方法 |
public function calculateDropIndex(event:DragEvent = null):int返回将放置项目添加到放置目标中的位置的索引。
参数
event:DragEvent (default = null) — 包含鼠标位置相关信息的 DragEvent。如果为 null,此方法应从最后的有效事件中返回 dropIndex 值。
|
int — 指示放置项目的添加位置的索引。
|
| calculateDropIndicatorY | () | 方法 |
protected function calculateDropIndicatorY(rowCount:Number, rowNum:int):Number在执行拖放操作时计算放置指示符的 y 位置。
参数
rowCount:Number — 控件中可视行的数目。
| |
rowNum:int — 放置指示符应在控件中出现的位置的行编号。
|
Number — 放置指示符的 y 轴坐标。
|
| clearCaretIndicator | () | 方法 |
protected function clearCaretIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void清除给定 Sprite 中的尖号指示符。
参数
indicator:Sprite — 一个 Sprite 对象,其中应该包含图形以使渲染器呈现加亮效果
| |
itemRenderer:IListItemRenderer — 正在加亮显示的项目渲染器
|
| clearHighlightIndicator | () | 方法 |
protected function clearHighlightIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void清除给定 Sprite 中的加亮指示符
参数
indicator:Sprite — 一个 Sprite 对象,其中应该包含图形以使渲染器呈现加亮效果
| |
itemRenderer:IListItemRenderer — 正在加亮显示的项目渲染器
|
| clearIndicators | () | 方法 |
protected function clearIndicators():void删除所有选定、加亮显示和尖号指示符。
| clearSelected | () | 方法 |
protected function clearSelected(transition:Boolean = false):void清除所选项目组,并移除表示那些项目的选定状态的所有图形。
参数
transition:Boolean (default = false) — 如果图形应该显示淡出效果,则返回 true。
|
| clearVisibleData | () | 方法 |
protected function clearVisibleData():void清空 visibleData 哈希表
| collectionChangeHandler | () | 方法 |
protected function collectionChangeHandler(event:Event):void当数据发生更改时,处理从数据提供程序中调度的 CollectionEvent。根据需要,更新渲染器、所选索引和滚动条。
参数
event:Event — CollectionEvent。
|
| commitProperties | () | 方法 |
override protected function commitProperties():void
根据是否已显式设置 columnCount columnWidth、rowHeight 和 rowCount 等属性来计算列宽、行高以及行数和列数。
另请参见
| configureScrollBars | () | 方法 |
protected function configureScrollBars():void
根据行数、列数以及可查看的行和列配置 ScrollBar。更新了行和列之后,将从 updateDisplayList() 方法调用此方法。此方法应指出向 setScrollBarProperties() 传入哪些参数来正确设置 ScrollBar。
| copyItemWithUID | () | 方法 |
protected function copyItemWithUID(item:Object):Object
通过调用 ObjectUtil.copy() 方法为此对象制作一个深层副本,然后通过调用 UIDUtil.createUID() 方法用一个新值替代该副本的 uid 属性(如果存在)。
此方法用于拖放副本
参数
item:Object — 要复制的项目
|
Object |
另请参见
| copySelectedItems | () | 方法 |
protected function copySelectedItems(useDataField:Boolean = true):Array按所选项目的选择顺序为其制作副本。
参数
useDataField:Boolean (default = true) — 如果应使用实际项目填充该数组,则为 true;如果应使用项目索引填充数组,则为 false。
|
Array — 所选择项目的数组
|
| createChildren | () | 方法 |
override protected function createChildren():void
创建对象作为此 ListBase 的子对象,在这种情况下为将控制所有项目渲染器的 listContent 对象。请注意,项目渲染器不会立即创建,而是稍后在 Flex 调用 updateDisplayList() 方法时创建。
| createItemRenderer | () | 方法 |
public function createItemRenderer(data:Object):IListItemRenderer创建一个给定了数据对象的项目渲染器
参数
data:Object — 数据对象
|
IListItemRenderer — 项目渲染器
|
| destroyRow | () | 方法 |
protected function destroyRow(i:int, numCols:int):void回收我们不再需要的行并删除其指示符
参数
i:int — 行的索引
| |
numCols:int — 行中的列数
|
| dragCompleteHandler | () | 方法 |
protected function dragCompleteHandler(event:DragEvent):void
处理 DragEvent.DRAG_COMPLETE 事件。此方法从数据提供程序中删除项目。
参数
event:DragEvent — DragEvent 对象。
|
| dragDropHandler | () | 方法 |
protected function dragDropHandler(event:DragEvent):void
处理 DragEvent.DRAG_DROP 事件。此方法通过调用 hideDropFeedback() 方法隐藏放置反馈。
如果此操作为 COPY,则此方法将调用 ObjectUtil.copy() 方法为此对象制作一个深层副本,然后通过调用 UIDUtil.createUID() 方法用一个新值替代该副本的 uid 属性(如果存在)。
参数
event:DragEvent — DragEvent 对象。
|
另请参见
| dragEnterHandler | () | 方法 |
protected function dragEnterHandler(event:DragEvent):void
处理 DragEvent.DRAG_ENTER 事件。此方法可确定 DragSource 对象是否包含有效的元素,并使用 showDropFeedback() 方法来设置 UI 反馈。
参数
event:DragEvent — DragEvent 对象。
|
| dragExitHandler | () | 方法 |
protected function dragExitHandler(event:DragEvent):void
处理 DragEvent.DRAG_EXIT 事件。此方法通过调用 hideDropFeedback() 方法隐藏 UI 反馈。
参数
event:DragEvent — DragEvent 对象。
|
| dragOverHandler | () | 方法 |
protected function dragOverHandler(event:DragEvent):void
处理 DragEvent.DRAG_OVER 事件。此方法确定 DragSource 对象是否包含有效元素,并使用 showDropFeedback() 方法设置 UI 反馈。
参数
event:DragEvent — DragEvent 对象。
|
| dragScroll | () | 方法 |
protected function dragScroll():voidInterval 函数,用于在鼠标位于列表上方或下方时上下滚动列表。
| dragStartHandler | () | 方法 |
protected function dragStartHandler(event:DragEvent):void
dragStart 事件的默认处理函数。
参数
event:DragEvent — DragEvent 对象。
|
| drawCaretIndicator | () | 方法 |
protected function drawCaretIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void使用指定的颜色在给定的 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使用指定的颜色在给定的 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绘制带有指示符(加亮显示的或选中的)或尖号的渲染器。
参数
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绘制行中所有交替行的颜色、边框和背景。
| drawSelectionIndicator | () | 方法 |
protected function drawSelectionIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制选择指示符。
参数
indicator:Sprite — 一个 Sprite 对象,其中应该包含图形以使渲染器呈现加亮效果
| |
x:Number — 建议的指示符 x 位置
| |
y:Number — 建议的指示符 y 位置
| |
width:Number — 建议的指示符宽度
| |
height:Number — 建议的指示符高度
| |
color:uint — 建议的指示符颜色
| |
itemRenderer:IListItemRenderer — 正在加亮显示的项目渲染器
|
| findKey | () | 方法 |
protected function findKey(eventCode:int):Boolean
尝试在数据提供程序中查找下一个以 eventCode 参数中的字符开头的项目。您可以覆盖此方法以执行联想式预键入查找。搜索从 selectedIndex 位置开始;如果到达数据提供程序的末端,则将从起始处开始。
参数
eventCode:int — 键盘上按下的键
|
Boolean — 如果找到匹配项,则为 true
|
| findString | () | 方法 |
public function findString(str:String):Boolean
根据 String 查找列表中的项目,并将所选内容移至该项目。搜索从 selectedIndex 位置开始;如果到达数据提供程序的末端,则将从起始处开始。
对于 DataGrid 控件,此方法将默认搜索控件中的第一列。要搜索其它列,请将填充控件时使用的集合的 sort 属性设置为要搜索的一个或多个特定字段。每个字段都对应于控件中的一列。
参数
str:String — 匹配的 String。
|
Boolean — 如果找到匹配项,则为 true。
|
另请参见
| finishDataChangeEffect | () | 方法 |
protected function finishDataChangeEffect(event:EffectEvent):void在数据更改效果运行完毕后,通过恢复原始集合和迭代器并移除此效果使用的所有缓存值进行清理。此方法由 Flex 框架调用;您无需从自己的代码中调用。
参数
event:EffectEvent — EffectEvent
|
| finishKeySelection | () | 方法 |
protected function finishKeySelection():void
基于 caretIndex 和 anchorIndex 属性设置所选项目。如果键盘选择处理函数在滚动以获得更多项目时发生页面错误,就会由键盘选择处理函数和 updateDisplayList 方法调用。
| getItemRendererFactory | () | 方法 |
public function getItemRendererFactory(data:Object):IFactory返回相应的工厂;如果尚未指定,则使用默认工厂。
参数
data:Object — 供项目渲染器显示的数据。
|
IFactory — 如果 data 为空,则返回默认的项目渲染器;否则,返回自定义的项目渲染器。
|
| getRendererSemanticValue | () | 方法 |
public function getRendererSemanticValue(target:Object, semanticProperty:String):Object
返回 true 或 false 以指示是否应在目标上播放效果。当您在数据效果上设置 filter 属性时,EffectTargetFilter 类调用此方法。例如,将 filter 属性设置为 addItem 或 removeItem。
参数
target:Object — 项目渲染器
| |
semanticProperty:String — 要返回其值的渲染器的语义属性。
|
Object — true 或 false,指示是否应在目标对象中播放效果。
|
| getReservedOrFreeItemRenderer | () | 方法 |
protected function getReservedOrFreeItemRenderer(data:Object):IListItemRenderer检索已创建但当前未使用的项目渲染器。如果正在运行某个数据效果,则将首先尝试从 reservedItemRenderers 映射中检索。否则(或如果未找到保留的渲染器),将从 freeItemRenderers 堆栈中检索。
参数
data:Object — Object,项目渲染器要显示的数据
|
IListItemRenderer |
| hideDropFeedback | () | 方法 |
public function hideDropFeedback(event:DragEvent):void在鼠标指针下方隐藏指示允许执行拖放操作的放置指示符。
参数
event:DragEvent — 包含鼠标位置信息的 DragEvent 对象。
|
| indexToColumn | () | 方法 |
protected function indexToColumn(index:int):int给定索引处数据提供程序项目所在的列。
参数
index:int — 数据提供程序中的偏移量。
|
int — 组件中显示此项目的列,如果无法在 listContent 容器中显示,则返回 -1。
|
| indexToItemRenderer | () | 方法 |
public function indexToItemRenderer(index:int):IListItemRenderer针对数据提供程序中某个项目的索引获取项目渲染器(如果存在)。因为只有可查看行项目组中的项目才有项目渲染器,所以无法对不可见的项目使用此方法。
参数
index:int — 某个项目的数据提供程序中的偏移量
|
IListItemRenderer — 用于显示项目的项目渲染器;如果当前未显示此项目,则为 null。
|
| indexToRow | () | 方法 |
protected function indexToRow(index:int):int给定索引处数据提供程序项目所在的行。
参数
index:int — 数据提供程序中的偏移量。
|
int — 组件中显示此项目的行,如果无法在 listContent 容器中显示,则返回 -1。
|
| indicesToIndex | () | 方法 |
public function indicesToIndex(rowIndex:int, colIndex:int):int计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。根据平铺布局的方向以及 TileList 中的行数和列数,TileList 中第 3 列第 9 行的项目可能与数据提供程序中对应位置的项目不同。
参数
rowIndex:int — 行从零开始的索引,包括从顶部滚离的行。因此,如果 verticalScrollPosition 为 2,则第一个可见行的 rowIndex 为 2。
| |
colIndex:int — 列从零开始的索引,包括滚离左侧的列。如果 horizontalScrollPosition 为 2,则左侧第一列的 columnIndex 为 2。
|
int — 数据提供程序中的偏移量。
|
| initiateDataChangeEffect | () | 方法 |
protected function initiateDataChangeEffect(unscaledWidth:Number, unscaledHeight:Number):void当数据提供程序中发生更改时应用数据更改效果。
参数
unscaledWidth:Number | |
unscaledHeight:Number |
| invalidateList | () | 方法 |
public function invalidateList():void在下次更新时刷新所有行。
| isItemHighlighted | () | 方法 |
public function isItemHighlighted(data:Object):Boolean确定是否加亮显示数据提供程序项目的项目渲染器(当鼠标滑过它,或者通过键盘导航使它位于尖号下方时)。
参数
data:Object — 数据提供程序项目
|
Boolean — 如果项目加亮显示,则返回 true
|
| isItemSelectable | () | 方法 |
public function isItemSelectable(data:Object):Boolean确定数据提供程序项目的项目渲染器是否可选。
参数
data:Object — 数据提供程序项目
|
Boolean — 如果可以选择此项目,则返回 true
|
| isItemSelected | () | 方法 |
public function isItemSelected(data:Object):Boolean确定是否已选中数据提供程序项目的项目渲染器。
参数
data:Object — 数据提供程序项目
|
Boolean — 如果已选中此项目,则返回 true
|
| isItemVisible | () | 方法 |
public function isItemVisible(item:Object):Boolean确定渲染器是否显示某个项目。
参数
item:Object — 数据提供程序项目。
|
Boolean — 如果正在显示此项目,则返回 true。
|
| isRendererUnconstrained | () | 方法 |
protected function isRendererUnconstrained(item:Object):Boolean
如果项目渲染器不再根据列表的布局算法定位,则返回 true,尽管由于调用 unconstrainRenderer() 正在运行数据更改效果。
参数
item:Object — 项目渲染器
|
Boolean |
| itemRendererContains | () | 方法 |
public function itemRendererContains(renderer:IListItemRenderer, object:DisplayObject):Boolean确定渲染器是否包含(或拥有)显示对象。所有权表示显示对象实际上并非渲染器的子项,而是在一定程度上与之相关联。渲染器应该包含弹出框,以便弹出框中的活动与渲染器相关联,并且在其它组件中不作为活动显示。
参数
renderer:IListItemRenderer — 可能包含或拥有显示对象的渲染器。
| |
object:DisplayObject — 可能与渲染器相关联的显示对象。
|
Boolean — 如果渲染器中包含或拥有显示对象,则返回 true。
|
| itemRendererToIndex | () | 方法 |
public function itemRendererToIndex(itemRenderer:IListItemRenderer):int返回通过此项目渲染器呈现的该项目在数据提供程序中的项目索引。因为只有可查看行组中的项目才有项目渲染器,所以无法对不可见的项目使用此方法。
参数
itemRenderer:IListItemRenderer — 项目渲染器,其中显示了您希望获知其数据提供程序索引的项目。
|
int — 数据提供程序中的项目索引
|
| itemRendererToIndices | () | 方法 |
protected function itemRendererToIndices(item:IListItemRenderer):Point返回一个包含项目渲染器的 columnIndex 和 rowIndex 的点。由于只为可查看行组中的项目创建项目渲染器,所以您无法使用此方法获得不可见项目的索引。另请注意,项目渲染器可循环使用。因此当重新使用某个项目渲染器来显示其它项目时,您获得的项目索引可能会发生变化。通常,在使用鼠标和键盘执行处理期间项目渲染器显示的数据集未更改的情况下调用此方法。
参数
item:IListItemRenderer — 项目渲染器
|
Point — 点。x 属性是 columnIndex,y 属性是 rowIndex。
|
| itemToDataTip | () | 方法 |
public function itemToDataTip(data:Object):String返回渲染器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。如果该方法无法将参数转换为字符串,则会返回一个空格。
仅供创建 ListBase 子类或其子项的开发人员使用,而不适用于应用程序开发人员。
参数
data:Object — 要呈现的对象。
|
String — String,基于数据的可显示字符串。
|
| itemToIcon | () | 方法 |
public function itemToIcon(data:Object):Class根据 iconField 和 iconFunction 属性返回表示数据项目图标的类(如果存在)。项目中的字段可以返回一个字符串,前提是该字符串表示应用程序中某个类的名称。项目中的字段还可以是表示包含图标类的文档中某个变量名称的字符串。
参数
data:Object — 从中提取图标类的项目
|
Class — 项目的图标,采用类引用的形式;如果不存在,则返回 null。
|
| itemToItemRenderer | () | 方法 |
public function itemToItemRenderer(item:Object):IListItemRenderer
返回数据提供程序中给定项目的项目渲染器(如果存在)。因为只有可查看行组中的项目才有项目渲染器,所以当项目不可见时,此方法将返回 null。对于 DataGrid,将返回第一列的渲染器。
参数
item:Object — 数据提供程序项目
|
IListItemRenderer — 项目渲染器;如果当前未显示项目,则为 null。
|
| itemToLabel | () | 方法 |
public function itemToLabel(data:Object):String返回渲染器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。如果该方法无法将参数转换为字符串,则会返回一个空格。
参数
data:Object — 要呈现的对象。
|
String — 根据数据要显示的字符串。
|
| itemToUID | () | 方法 |
protected function itemToUID(data:Object):String确定数据提供程序项目的 UID。数据提供程序中的所有项目都必须具有唯一的 ID (UID),或生成一个与之相关的 ID。这意味着您无法在数据提供程序中两次显示对象或标量值。例如,以下数据提供程序将不受支持,因为“foo”值出现了两次,而且字符串的 UID 是字符串本身。 如果简单动态对象是两个不同的实例,则可以显示两次。以下数据提供程序是受支持的,因为由于每个实例是不同的对象而将赋予不同的 UID。 请注意,以下数据提供程序不受支持,因为同一实例出现了两次。
参数
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
创建足够的行和列以填充左侧、顶部、右侧和底部描述的区域。这将创建渲染器,并在 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) — 如果为 true,则创建 rowsNeeded 行,并忽略 bottom 参数。
| |
rowsNeeded:uint (default = 0) — byCount 为 true 时要创建的行数。
|
Point — 包含所创建的行数和列数的点。
|
| measure | () | 方法 |
override protected function measure():void
根据 rowCount、columnCount、rowHeight 和 columnWidth 属性计算组件的度量宽度和高度。
另请参见
| measureHeightOfItems | () | 方法 |
public function measureHeightOfItems(index:int = -1, count:int = 0):Number使用当前项目渲染器测量数据提供程序中的一组项目,并返回这些项目的高度之和。
此方法无法在 ListBase 类中实现,而是必须在子类中实现。
如果 index 值为负,则指定在计算高度时包含所有标题。
参数
index:int (default = -1) — 第一个进行高度测量的数据提供程序项目。
| |
count:int (default = 0) — 计算高度时需要测量的项目数。
|
Number — 所测量项目的高度之和。
|
| measureWidthOfItems | () | 方法 |
public function measureWidthOfItems(index:int = -1, count:int = 0):Number使用当前项目渲染器测量数据提供程序中的一组项目,并返回找到的最大宽度。此方法用于计算组件的宽度。各种 ListBase-derived 类的实现之间存在细微差异。DataGrid 将测量其列而非数据提供程序项目,而 TileList 只测量第一个项目并假定所有项目大小相同。
此方法无法在 ListBase 类中实现,而是必须在子类中实现。
如果 index 值为负,则指定在计算宽度时包含所有标题。
参数
index:int (default = -1) — 第一个进行宽度测量的数据提供程序项目。
| |
count:int (default = 0) — 计算宽度时需要测量的项目数。
|
Number — 所测量项目的最大宽度。
|
| mouseClickHandler | () | 方法 |
protected function mouseClickHandler(event:MouseEvent):void
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_CLICK 事件。此方法确定单击了哪个渲染器,并调度 ListEvent.ITEM_CLICK 事件。
参数
event:MouseEvent — MouseEvent 对象。
|
| mouseDoubleClickHandler | () | 方法 |
protected function mouseDoubleClickHandler(event:MouseEvent):void
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_DOUBLE_CLICK 事件。此方法确定单击了哪个渲染器,并调度 ListEvent.ITEM_DOUBLE_CLICK 事件。
参数
event:MouseEvent — MouseEvent 对象。
|
| mouseDownHandler | () | 方法 |
protected function mouseDownHandler(event:MouseEvent):void
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_DOWN 事件。此方法查找被按下的渲染器,并准备接收 MouseEvent.MOUSE_UP 事件。
参数
event:MouseEvent — MouseEvent 对象。
|
| mouseEventToItemRenderer | () | 方法 |
protected function mouseEventToItemRenderer(event:MouseEvent):IListItemRenderer确定哪种项目渲染器位于鼠标下方。项目渲染器可由多个鼠标目标组成,也可以包含鼠标目标范围之外的可见区域。此方法既检查鼠标目标又检查鼠标位置,以便从用户角度确定鼠标下方是哪种项目渲染器,这可能与鼠标事件提供的信息有所不同。
参数
event:MouseEvent — 包含鼠标位置及其下方对象的 MouseEvent。
|
IListItemRenderer — 位于鼠标下方的项目渲染器;如果不存在,则为 null。
|
| mouseMoveHandler | () | 方法 |
protected function mouseMoveHandler(event:MouseEvent):void
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_MOVE 事件。此方法监视导致开始拖放并发送 DragEvent.DRAG_START 事件的动作。它还检查鼠标是否位于渲染器的非目标区域,以便 Flex 尽量使渲染器看起来像目标一样。
参数
event:MouseEvent — MouseEvent 对象。
|
| mouseOutHandler | () | 方法 |
protected function mouseOutHandler(event:MouseEvent):void
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_OUT 事件。此方法查找鼠标离开的渲染器并删除其加亮效果。
参数
event:MouseEvent — MouseEvent 对象。
|
| mouseOverHandler | () | 方法 |
protected function mouseOverHandler(event:MouseEvent):void
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_OVER 事件。此方法查找鼠标到达的渲染器并加亮该渲染器。
列表类还会从 MouseEvent.MOUSE_MOVE 事件调用此方法。此事件用于检测渲染器中非目标区域以及渲染器周围填充区域中的移动。
参数
event:MouseEvent — MouseEvent 对象。
|
| mouseUpHandler | () | 方法 |
protected function mouseUpHandler(event:MouseEvent):void
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_DOWN 事件。此方法查找被按下的渲染器,并准备接收 MouseEvent.MOUSE_UP 事件。
参数
event:MouseEvent — MouseEvent 对象。
|
| mouseWheelHandler | () | 方法 |
override protected function mouseWheelHandler(event:MouseEvent):void
通过更改滚动位置处理 mouseWheel 事件。这是 ScrollControlBase 类中的版本副本,可以对其进行修改以便水平运行目标时更改 horizontalScrollPosition。
参数
event:MouseEvent — MouseEvent 对象。
|
另请参见
| moveIndicatorsHorizontally | () | 方法 |
protected function moveIndicatorsHorizontally(uid:String, moveBlockDistance:Number):void水平移动所选项目并加亮指示符
参数
uid:String — 用于查找指示符的 UID
| |
moveBlockDistance:Number — 水平移动距离
|
| moveIndicatorsVertically | () | 方法 |
protected function moveIndicatorsVertically(uid:String, moveBlockDistance:Number):void垂直移动所选项目并加亮指示符
参数
uid:String — 用于查找指示符的 UID
| |
moveBlockDistance:Number — 垂直移动距离
|
| moveRowVertically | () | 方法 |
protected function moveRowVertically(i:int, numCols:int, moveBlockDistance:Number):void垂直移动行,并更新 rowInfo 记录
参数
i:int — 行的索引
| |
numCols:int — 行中的列数
| |
moveBlockDistance:Number — 移动的距离
|
| moveSelectionHorizontally | () | 方法 |
protected function moveSelectionHorizontally(code:uint, shiftKey:Boolean, ctrlKey:Boolean):void
沿水平方向移动所选项目,以响应用户使用向左箭头或向右箭键头以及功能键(如 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
沿垂直方向移动所选项目,以响应用户使用向上箭头或向下箭头键以及功能键(如 Shift 和 Ctrl 键)选择项目的操作。此方法可以更改 horizontalScrollPosition、verticalScrollPosition 和 caretIndex 属性,并调用 finishKeySelection() 方法更新所选内容
参数
code:uint — 按下的键(如 Keyboard.DOWN)
| |
shiftKey:Boolean — 如果在按下键盘键的同时按住 Shift 键,则为 true。
| |
ctrlKey:Boolean — 如果在按下键盘键的同时按住 Ctrl 键,则为 true。
|
| prepareDataEffect | () | 方法 |
| purgeItemRenderers | () | 方法 |
protected function purgeItemRenderers():void当渲染器发生更改时,updateDisplayList() 将调用此方法,用来移除现有的项目渲染器并清理各种缓存结构。
| reKeyVisibleData | () | 方法 |
protected function reKeyVisibleData():void更新 visibleData 哈希表中的键
| removeDataEffectItem | () | 方法 |
public function removeDataEffectItem(target:Object):void
如果正在运行数据更改效果,则移除项目渲染器。项目渲染器必须与从数据提供程序集合中移除的数据对应。此函数将作为数据更改效果的一部分由 RemoveItemAction 效果调用,用以指定使用项目渲染器的控件停止显示数据项目的时间点。
参数
target:Object — 要从控件布局中删除的项目渲染器。
|
| removeFromRowArrays | () | 方法 |
| removeIndicators | () | 方法 |
protected function removeIndicators(uid:String):void清理数据提供程序中给定项目的选项亮显及其它关联图形。
参数
uid:String — 数据提供程序项目的 UID
|
| restoreRowArrays | () | 方法 |
protected function restoreRowArrays(modDeltaPos:int):void从用于存储对行的引用的数组开头删除请求的行数
参数
modDeltaPos:int — 要删除的行数
|
| scrollHorizontally | () | 方法 |
protected function scrollHorizontally(pos:int, deltaPos:int, scrollUp:Boolean):void调整渲染器以响应滚动位置的更改。
当滚动位置的更改量低于可见行数时,列表类将尝试优化滚动。此时,一些行只需进行移动即可而无需进行其它更改,另一些行则需要删除,然后添加新行。如果滚动位置更改量过大,将删除所有旧行,并调用 makeRowsAndColumns() 方法在整个可查看区域添加新行。
此操作无法在 ListBase 中实现,因为默认列表只有一列,无法水平滚动。
参数
pos:int — 新的滚动位置。
| |
deltaPos:int — 位置的变化。该值始终为正数。
| |
scrollUp:Boolean — 如果滚动位置正在逐渐缩小,则为 true。
|
| scrollPositionToIndex | () | 方法 |
protected function scrollPositionToIndex(horizontalScrollPosition:int, verticalScrollPosition:int):int返回给定滚动位置第一个可见行和列处的项目的数据提供程序索引。
参数
horizontalScrollPosition:int — 与滚动位置相对应的 horizontalScrollPosition 属性值。
| |
verticalScrollPosition:int — 与滚动位置相对应的 verticalScrollPosition 属性值。
|
int — 数据提供程序索引。
|
| scrollToIndex | () | 方法 |
public function scrollToIndex(index:int):Boolean
确保给定索引处的数据提供程序项目可见。如果此项目可见,则 verticalScrollPosition 属性将保持不变,即使该项目并非第一个可见项目也不例外。如果此项目当前不可见,则会更改 verticalScrollPosition 属性以将该项目设为第一个可见项目;但行数不足时除外,因为 verticalScrollPosition 值受 maxVerticalScrollPosition 属性限制。
参数
index:int — 数据提供程序中项目的索引。
|
Boolean — 如果更改了 verticalScrollPosition,则返回 true。
|
| scrollVertically | () | 方法 |
protected function scrollVertically(pos:int, deltaPos:int, scrollUp:Boolean):void调整渲染器以响应滚动位置的更改。
当滚动位置的更改量低于可见行数时,列表类将尝试优化滚动。此时,一些行只需进行移动即可而无需进行其它更改,另一些行则需要删除,然后添加新行。如果滚动位置更改量过大,将删除所有旧行,并调用 makeRowsAndColumns() 方法在整个可查看区域添加新行。
参数
pos:int — 新的滚动位置。
| |
deltaPos:int — 位置的变化。该值始终为正数。
| |
scrollUp:Boolean — 如果滚动位置正在逐渐缩小,则为 true。
|
| seekPendingFailureHandler | () | 方法 |
protected function seekPendingFailureHandler(data:Object, info:ListBaseSeekPending):void当由于页面错误而导致寻找失败时的默认故障处理函数。
参数
data:Object | |
info:ListBaseSeekPending |
| seekPendingResultHandler | () | 方法 |
protected function seekPendingResultHandler(data:Object, info:ListBaseSeekPending):void当由于页面错误而导致寻找失败时的默认结果处理函数。此方法将检查是否存在最新页面的错误结果:如果没有,则退出;如果有,则将迭代器设置到正确的位置。
参数
data:Object | |
info:ListBaseSeekPending |
| seekPositionSafely | () | 方法 |
protected function seekPositionSafely(index:int):Boolean搜寻位置,并在必要时处理 ItemPendingError。
参数
index:int — 编制索引到集合中。
|
Boolean — 如果引发 ItemPendingError,则返回 FALSE。
|
| selectItem | () | 方法 |
protected function selectItem(item:IListItemRenderer, shiftKey:Boolean, ctrlKey:Boolean, transition:Boolean = true):Boolean如果使用鼠标单击提供的项目渲染器,并且键盘功能键处于给定状态,则更新所选项目组。此方法也可以根据项目渲染器更新后的选定状态更新其显示。
参数
item:IListItemRenderer — 单击的项目渲染器
| |
shiftKey:Boolean — 如果在单击鼠标的同时按下 Shift 键,则返回 true。
| |
ctrlKey:Boolean — 如果在单击鼠标的同时按下 Ctrl 键,则返回 true。
| |
transition:Boolean (default = true) — 如果在使用某种效果时,处于选定状态的图形应该显示淡入效果,则返回 true。
|
Boolean — 如果所选项目组发生更改,则返回 true。单击已选项目通常不会更改所选项目组。
|
| setRowCount | () | 方法 |
protected function setRowCount(v:int):void
设置 rowCount 属性不会导致 invalidation,也不会设置将永久锁定行数的 explicitRowCount 属性。
参数
v:int — 行计数。
|
| setRowHeight | () | 方法 |
protected function setRowHeight(v:Number):void
设置 rowHeight 属性不会导致 invalidation,也不会设置将永久锁定行高的 explicitRowHeight。
参数
v:Number — 行高(以像素为单位)。
|
| shiftRow | () | 方法 |
protected function shiftRow(oldIndex:int, newIndex:int, numCols:int, shiftItems:Boolean):void移动引用多行的数组中的某一行
参数
oldIndex:int — 数组中的旧索引
| |
newIndex:int — 数组中的新索引
| |
numCols:int — 行中的列数
| |
shiftItems:Boolean — 如果实际移动了项目,则为 TRUE;如果只更改了项目 rowIndex,则为 FALSE
|
| showDropFeedback | () | 方法 |
public function showDropFeedback(event:DragEvent):void在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。
参数
event:DragEvent — 包含鼠标位置相关信息的 DragEvent 对象。
|
| sumRowHeights | () | 方法 |
protected function sumRowHeights(startRowIdx:int, endRowIdx:int):Number确定所请求的行集的高度
参数
startRowIdx:int — 第一行的索引
| |
endRowIdx:int — 最后一行的索引
|
Number — 行的总高度
|
| truncateRowArrays | () | 方法 |
protected function truncateRowArrays(numRows:int):void从用于存储对行的引用的数组末端删除所有剩余行
参数
numRows:int — 截断位置的行索引
|
| UIDToItemRenderer | () | 方法 |
protected function UIDToItemRenderer(uid:String):IListItemRendererFind an item renderer based on its UID if it is visible
参数
uid:String — 项目的 UID
|
IListItemRenderer — 项目渲染器
|
| unconstrainRenderer | () | 方法 |
public function unconstrainRenderer(item:Object):void
如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外,则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。该控件不会尝试定位效果的持续时间的项目渲染器。
参数
item:Object — 作为效果目标的项目渲染器。
|
| updateDisplayList | () | 方法 |
override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void当可显示的项目数发生更改时添加或移除项目渲染器。如果项目渲染器可能已发生更改,请刷新它们。如果是以编程方式进行的更改,请应用此选项。
参数
unscaledWidth:Number — 指定组件在组件坐标中的宽度(以像素为单位),而不考虑该组件的 scaleX 属性值。
| |
unscaledHeight:Number — 指定组件在组件坐标中的高度(以像素为单位),而不考虑该组件的 scaleY 属性值。
|
另请参见
| updateList | () | 方法 |
protected function updateList():void立即刷新所有行。调用此方法可能需要后续处理,因为完全重绘列表中所有的渲染器代价非常高,而且直到完成后才能够返回。
| change | 事件 |
mx.events.ListEventmx.events.ListEvent.CHANGE
当用户操作导致 selectedIndex 或 selectedItem 属性更改时调度此事件。
change 事件定义 ListEvent 对象的 type 属性的值,指示由于用户交互所选内容已发生更改。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
itemRenderer | 单击的项目渲染器。 |
reason | null |
rowIndex | 与事件相关联的项目的从零开始的索引。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
类型 | ListEvent.CHANGE |
| dataChange | 事件 |
mx.events.FlexEventmx.events.FlexEvent.DATA_CHANGE
当 data 属性更改时进行调度。
当您使用组件作为项目渲染器时,data 属性将包含要显示的数据。您可以侦听此事件,并在 data 属性更改时更新组件。
FlexEvent.DATA_CHANGE 常数可为 dataChange 事件定义事件对象的 type 属性值。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
| itemClick | 事件 |
mx.events.ListEventmx.events.ListEvent.ITEM_CLICK当用户单击控件中的某个项目时调度此事件。
ListEvent.ITEM_CLICK 常数可为itemClick 事件定义 ListEvent 对象的 type 属性的值,指示用户在控件中某个可视项目上单击了鼠标。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
itemRenderer | 单击的项目渲染器。 |
reason | null |
rowIndex | 与事件相关联的项目的从零开始的索引。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
类型 | ListEvent.ITEM_CLICK |
| itemDoubleClick | 事件 |
mx.events.ListEventmx.events.ListEvent.ITEM_DOUBLE_CLICK当用户双击控件中的某个项目时调度此事件。
ListEvent.ITEM_DOUBLE_CLICK 常数可为itemDoubleClick 事件定义 ListEvent 对象的 type 属性的值,指示用户在控件中某个可视项目上双击了鼠标。
若要接收 itemDoubleClick 事件,必须将组件的 doubleClickEnabled 属性设置为 true。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
itemRenderer | 双击的项目渲染器。 |
reason | null |
rowIndex | 与事件相关联的项目的从零开始的索引。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
类型 | ListEvent.ITEM_DOUBLE_CLICK |
| itemRollOut | 事件 |
mx.events.ListEventmx.events.ListEvent.ITEM_ROLL_OUT当用户将鼠标指针移出控件中的某个项目时调度此事件。
ListEvent.ITEM_ROLL_OUT 常数可为itemRollOut 事件定义 ListEvent 对象的 type 属性的值,指示用户执行了将鼠标指针从控件中某个可视项目上移开的操作。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
itemRenderer | 被移开的项目渲染器。 |
reason | null |
rowIndex | 与事件相关联的项目的从零开始的索引。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
类型 | ListEvent.ITEM_ROLL_OUT |
| itemRollOver | 事件 |
mx.events.ListEventmx.events.ListEvent.ITEM_ROLL_OVER当用户将鼠标指针滚至控件中的某个项目时调度此方法。
ListEvent.ITEM_ROLL_OVER 常数可为itemRollOver 事件定义 ListEvent 对象的 type 属性的值,指示用户执行了将鼠标指针滑过控件中某个可视项目的操作。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
columnIndex | 与事件相关联的列的从零开始的索引。 |
currentTarget | 用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
itemRenderer | 滑过的项目渲染器。 |
reason | null |
rowIndex | 与事件相关联的项目的从零开始的索引。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
类型 | ListEvent.ITEM_ROLL_OVER |
当前页: http://livedocs.adobe.com/flex/3_cn/mx/controls/listClasses/ListBase.html