mx.controls.listClasses
Classpublic class ListBase
继承ListBase Inheritance ScrollControlBase Inheritance UIComponent Inheritance FlexSprite Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Implements IDataRenderer, IFocusManagerComponent, IListItemRenderer, IDropInListItemRenderer, IEffectTargetHost
Subclasses DataGridBase, List, TileBase

ListBase 类是提供项目列表的控件的基类,可以从该列表中选择一个或多个项目,也可以在各项目之间滚动。这些项目由 dataProvider 属性提供,并通过项目渲染器显示。

在模型/视图体系结构中,ListBase-derived 类提供视图,dataProvider 对象提供模型。

MXML 语法expanded隐藏 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"
   />
  

另请参见

mx.collections.ICollectionView


公共属性
 属性定义方
 InheritedaccessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
DisplayObject
 InheritedactiveEffects : Array
[] 组件上当前播放的效果列表,如 EffectInstance 实例的 Array。
UIComponent
  allowDragSelection : Boolean = false
一个标志,指示是否启用拖动选择。
ListBase
  allowMultipleSelection : Boolean
一个标志,指示是否允许您同时选择多个项目。
ListBase
 Inheritedalpha : Number
指示指定对象的 Alpha 透明度值。
DisplayObject
 InheritedautomationDelegate : Object
处理自动化相关功能的委托对象。
UIComponent
 InheritedautomationName : String
可用作此对象的标识符的名称。
UIComponent
 InheritedautomationTabularData : Object
[] IAutomationTabularData 接口的实现,可用于检索数据。
UIComponent
 InheritedautomationValue : Array
[] 此值通常对应于对象的经渲染的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。
UIComponent
 InheritedbaselinePosition : Number
[] 组件第一行文本的基线的 y 坐标。
UIComponent
 InheritedblendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。
DisplayObject
 InheritedborderMetrics : EdgeMetrics
[] 返回 EdgeMetrics 对象,它具有四个属性:left、top、right 和 bottom。
ScrollControlBase
 InheritedbuttonMode : Boolean
指定此 sprite 的按钮模式。
Sprite
 InheritedcacheAsBitmap : Boolean
如果设置为 true,则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。
DisplayObject
 InheritedcacheHeuristic : Boolean
[] 供 Flex 使用,表示建议为对象实施位图缓存。
UIComponent
 InheritedcachePolicy : String
指定此对象的位图缓存策略。
UIComponent
 InheritedclassName : String
[] 此实例的类的名称,如“Button”。
UIComponent
  columnCount : int
在 TileList 控件中显示的列数,或在 HorizontalList 控件中显示的项目数。
ListBase
  columnWidth : Number
控件中列的宽度。
ListBase
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcontentMouseX : Number
[] 返回鼠标在内容坐标系中的 x 位置。
UIComponent
 InheritedcontentMouseY : Number
[] 返回内容坐标系中鼠标的 y 位置。
UIComponent
 InheritedcontextMenu : NativeMenu
指定与此对象相关联的上下文菜单。
InteractiveObject
 InheritedcurrentState : String
组件的当前视图状态。
UIComponent
 InheritedcursorManager : ICursorManager
[] 获取控制此组件及其同级组件的光标的 CursorManager。
UIComponent
  data : Object
将此组件用作项目渲染器或项目编辑器时,此组件应呈现的数据提供程序中的项目。
ListBase
  dataProvider : Object
要查看的数据集。
ListBase
  dataTipField : String
数据提供程序项目中作为数据提示显示的字段名称。
ListBase
  dataTipFunction : Function
用户提供的函数,在各个项目上运行以确定其数据提示。
ListBase
 Inheriteddescriptor : UIComponentDescriptor
引用 UIComponentDescriptor(如果有),过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。
UIComponent
 Inheriteddocument : Object
引用与此 UIComponent 相关联的文档对象。
UIComponent
 InheriteddoubleClickEnabled : Boolean
指定 UIComponent 对象是否接收 doubleClick 事件。
UIComponent
  dragEnabled : Boolean
一个标志,指示是否可以将项目拖出此控件并放到其它控件上。
ListBase
  dragMoveEnabled : Boolean
一个标志,指示在拖放操作过程中是否可以移动控件中的项目,而不只是从控件中复制这些项目。
ListBase
  dropEnabled : Boolean
一个标志,指示是否可以将所拖动的项目放到此控件上。
ListBase
 InheriteddropTarget : DisplayObject
[] 指定拖动 sprite 时经过的显示对象,或放置 sprite 的显示对象。
Sprite
 Inheritedenabled : Boolean
组件是否可以接受用户交互。
UIComponent
 InheritederrorString : String
当验证程序监视组件并且验证失败时,组件的错误提示中将显示的文本。
UIComponent
 InheritedexplicitHeight : Number
指定该组件在组件坐标中显式高度(以像素为单位)的数字。
UIComponent
 InheritedexplicitMaxHeight : Number
在组件坐标中指定组件最大高度的数字(以像素为单位)。
UIComponent
 InheritedexplicitMaxWidth : Number
在组件坐标中指定组件最大宽度的数字(以像素为单位)。
UIComponent
 InheritedexplicitMinHeight : Number
在组件坐标中指定组件最小高度的数字(以像素为单位)。
UIComponent
 InheritedexplicitMinWidth : Number
在组件坐标中指定组件最小宽度的数字(以像素为单位)。
UIComponent
 InheritedexplicitWidth : Number
指定该组件在组件坐标中显式宽度(以像素为单位)的数字。
UIComponent
 Inheritedfilters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。
DisplayObject
 InheritedflexContextMenu : IFlexContextMenu
此 UIComponent 的上下文菜单。
UIComponent
 InheritedfocusEnabled : Boolean
指示切换到此组件时,是否可以接收焦点。
UIComponent
 InheritedfocusManager : IFocusManager
获取控制此组件及其同级组件的焦点的 FocusManager。
UIComponent
 InheritedfocusPane : Sprite
与此对象相关联的焦点窗格。
UIComponent
 InheritedfocusRect : Object
指定此对象是否显示焦点矩形。
InteractiveObject
 Inheritedgraphics : Graphics
[] 指定属于此 sprite 的 Graphics 对象,在此 sprite 中可执行矢量绘画命令。
Sprite
 Inheritedheight : Number
指定组件在父坐标中的高度的数字(以像素为单位)。
UIComponent
 InheritedhitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。
Sprite
 InheritedhorizontalScrollPolicy : String
指示水平滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。
ScrollControlBase
 InheritedhorizontalScrollPosition : Number
内容与左边缘的偏移量。
ScrollControlBase
  iconField : String
数据提供程序对象中字段的名称,该字段用于确定显示为图标的对象。
ListBase
  iconFunction : Function
用户提供的函数,在每个项目上运行以确定其图标。
ListBase
 Inheritedid : String
组件 ID。
UIComponent
 InheritedincludeInLayout : Boolean
指定此组件是否包含在父容器的布局中。
UIComponent
 InheritedinheritingStyles : Object
此组件的继承样式链的开头内容。
UIComponent
 Inheritedinitialized : Boolean
一个标志,用于确定某个对象是否已通过布局的所有三个阶段:提交、测量和布局(假设每个阶段都是必需的)。
UIComponent
 InheritedinstanceIndex : int
[] 重复组件的索引。
UIComponent
 InheritedinstanceIndices : Array
一个 Array,包含从此 UIComponent 对象的父文档引用该对象所需的索引。
UIComponent
 InheritedisDocument : Boolean
[] 确定此 UIComponent 实例是否为文档对象,也就是说它是否位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。
UIComponent
 InheritedisPopUp : Boolean
PopUpManager 将其设置为 true 以指示已弹出该组件。
UIComponent
  itemRenderer : IFactory
控件的自定义项目渲染器。
ListBase
  labelField : String
数据提供程序项目中作为标签显示的字段名称。
ListBase
  labelFunction : Function
用户提供的函数,在每个项目上运行以确定其标签。
ListBase
  listData : BaseListData
如果使用组件作为嵌入式项目渲染器或嵌入式项目编辑器,则 Flex 将使用 list 控件中的其它数据初始化组件的 listData 属性。
ListBase
 InheritedliveScrolling : Boolean = true
一个标志,指示移动滚动栏滑块时实时滚动视图,还是释放滑块后才更新视图。
ScrollControlBase
 InheritedloaderInfo : LoaderInfo
[] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。
DisplayObject
 Inheritedmask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
DisplayObject
 InheritedmaxHeight : Number
在组件坐标中指定组件最大高度的数字(以像素为单位)。
UIComponent
 InheritedmaxHorizontalScrollPosition : Number
horizontalScrollPosition 属性的最大值。
ScrollControlBase
 InheritedmaxVerticalScrollPosition : Number
verticalScrollPosition 属性的最大值。
ScrollControlBase
 InheritedmaxWidth : Number
在组件坐标中指定组件最大宽度的数字(以像素为单位)。
UIComponent
 InheritedmeasuredHeight : Number
组件的默认高度(以像素为单位)。
UIComponent
 InheritedmeasuredMinHeight : Number
组件的默认最小高度(以像素为单位)。
UIComponent
 InheritedmeasuredMinWidth : Number
组件的默认最小宽度(以像素为单位)。
UIComponent
 InheritedmeasuredWidth : Number
组件的默认宽度(以像素为单位)。
UIComponent
  menuSelectionMode : Boolean = false
一个标志,指示是否应使用菜单样式选择。
ListBase
 InheritedminHeight : Number
在组件坐标中指定组件最小高度的数字(以像素为单位)。
UIComponent
 InheritedminWidth : Number
在组件坐标中指定组件最小宽度的数字(以像素为单位)。
UIComponent
 InheritedmoduleFactory : IFlexModuleFactory
用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。
UIComponent
 InheritedmouseChildren : Boolean
确定对象的子项是否支持鼠标。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
指定此对象是否接收鼠标消息。
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
单击时是否可接收焦点。
UIComponent
 InheritedmouseX : Number
[] 指示鼠标位置的 x 坐标,以像素为单位。
DisplayObject
 InheritedmouseY : Number
[] 指示鼠标位置的 y 坐标,以像素为单位。
DisplayObject
 Inheritedname : String
指示 DisplayObject 的实例名称。
DisplayObject
 InheritednestLevel : int
此对象在所属关系层次结构中的深度。
UIComponent
 InheritednonInheritingStyles : Object
此组件的非继承样式链的开头内容。
UIComponent
  nullItemRenderer : IFactory
控件的自定义项目渲染器。
ListBase
 InheritednumAutomationChildren : int
[] 此容器包含的自动化子项数。
UIComponent
 InheritednumChildren : int
[] 返回此对象的子项数目。
DisplayObjectContainer
  offscreenExtraRowsOrColumns : int
项目渲染器的额外行或列的目标数量,供在控件布局中使用。
ListBase
 InheritedopaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
DisplayObject
 Inheritedowner : DisplayObjectContainer
此 UIComponent 的所有者。
UIComponent
 Inheritedparent : DisplayObjectContainer
[] 此组件的父容器或组件。
UIComponent
 InheritedparentApplication : Object
[] 引用包含此 UIComponent 实例的 Application 对象。
UIComponent
 InheritedparentDocument : Object
[] 引用此 UIComponent 的父文档对象。
UIComponent
 InheritedpercentHeight : Number
以组件父项大小百分比的方式指定组件高度的数字。
UIComponent
 InheritedpercentWidth : Number
以组件父项大小百分比形式指定其宽度的数字。
UIComponent
 InheritedprocessedDescriptors : Boolean
临时或延迟子项创建操作后设置为 true,具体取决于发生对象。
UIComponent
 Inheritedprototype : Object
[] 对类或函数对象的原型对象的引用。
Object
 Inheritedrepeater : IRepeater
[] 对生成此 UIComponent 的父文档中 Repeater 对象的引用。
UIComponent
 InheritedrepeaterIndex : int
[] 项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。
UIComponent
 InheritedrepeaterIndices : Array
一个 Array,包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。
UIComponent
 Inheritedrepeaters : Array
一个 Array,包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。
UIComponent
 Inheritedroot : DisplayObject
[] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。
DisplayObject
 Inheritedrotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。
DisplayObject
  rowCount : int
要显示的行数。
ListBase
  rowHeight : Number
行高(以像素为单位)。
ListBase
 Inheritedscale9Grid : Rectangle
当前有效的缩放网格。
DisplayObject
 InheritedscaleX : Number
用于指定水平缩放系数的数字。
UIComponent
 InheritedscaleY : Number
用于指定垂直缩放系数的数字。
UIComponent
 Inheritedscreen : Rectangle
[] 返回包含此对象的基本绘图表面大小和位置的对象。
UIComponent
 InheritedscrollRect : Rectangle
显示对象的滚动矩形范围。
DisplayObject
 InheritedscrollTipFunction : Function
将要显示的字符串作为 ScrollTip 计算的函数。
ScrollControlBase
  selectable : Boolean
一个标志,指示列表是否将所选项目显示为选中状态。
ListBase
  selectedIndex : int
所选项目的数据提供程序中的索引。
ListBase
  selectedIndices : Array
数据提供程序中所选项目的索引的数组。
ListBase
  selectedItem : Object
对数据提供程序中所选项目的引用。
ListBase
  selectedItems : Array
对数据提供程序中所选项目的引用的数组。
ListBase
  showDataTips : Boolean
一个标志,指示是否为行中的文本显示数据提示。
ListBase
 InheritedshowInAutomationHierarchy : Boolean
用于确定自动化对象是否显示在自动化层次中的标志。
UIComponent
 InheritedshowScrollTips : Boolean = false
一个标志,指示拖动滚动滑块时是否应在其旁边显示工具提示。
ScrollControlBase
 InheritedsoundTransform : SoundTransform
控制此 sprite 中的声音。
Sprite
 Inheritedstage : Stage
[] 显示对象的舞台。
DisplayObject
 Inheritedstates : Array
为此组件定义的视图状态。
UIComponent
 InheritedstyleDeclaration : CSSStyleDeclaration
存储此对象的内嵌继承样式。
UIComponent
 InheritedstyleName : Object
此组件使用的类样式。
UIComponent
 InheritedsystemManager : ISystemManager
返回此组件使用的 SystemManager 对象。
UIComponent
 InheritedtabChildren : Boolean
确定对象的子项是否支持 Tab 键。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。
InteractiveObject
 InheritedtabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。
DisplayObjectContainer
 InheritedtoolTip : String
要在 ToolTip 中显示的文本。
UIComponent
 Inheritedtransform : Transform
一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。
DisplayObject
 Inheritedtransitions : Array
一个 Transition 对象 Array,其中的每个 Transition 对象都定义一组效果,用于在视图状态发生更改时播放。
UIComponent
 InheritedtweeningProperties : Array
当前在此对象上进行补间的属性数组。
UIComponent
 Inheriteduid : String
对象的唯一标识符。
UIComponent
 InheritedupdateCompletePendingFlag : Boolean
一个标志,确定某个对象是否已通过所有三个阶段的布局验证(假设需要通过所有验证)。
UIComponent
 InheriteduseHandCursor : Boolean
布尔值,指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形(手形光标)。
Sprite
 InheritedvalidationSubField : String
供验证程序用来将子字段与此组件相关联。
UIComponent
  value : Object
[] 所选项目,或者所选项目的数据或标签字段。
ListBase
  variableRowHeight : Boolean
一个标志,指示各行是否可以采用不同的高度。
ListBase
 InheritedverticalScrollPolicy : String
指示垂直滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。
ScrollControlBase
 InheritedverticalScrollPosition : Number
顶边到内容的偏移量。
ScrollControlBase
 InheritedviewMetrics : EdgeMetrics
[] 考虑滚动条(如果可见)的 EdgeMetrics 对象。
ScrollControlBase
 Inheritedvisible : Boolean
控制此 UIComponent 的可见性。
UIComponent
 Inheritedwidth : Number
指定组件在父坐标中的宽度的数字(以像素为单位)。
UIComponent
  wordWrap : Boolean
一个标志,指示行中的文本是否应自动换行。
ListBase
 Inheritedx : Number
指定组件在其父容器中的水平位置(以像素为单位)的数字。
UIComponent
 Inheritedy : Number
指定组件在其父容器中的垂直位置(以像素为单位)的数字。
UIComponent
受保护的属性
 属性定义方
  actualCollection : ICollectionView
通常存储于运行数据更改效果时使用的 collection 中的值副本。
ListBase
  actualIterator : IViewCursor
通常存储于运行数据更改效果时使用的 iterator 中的值副本。
ListBase
  allowItemSizeChangeNotification : Boolean
[] 如果设置为 false,则渲染器无法使 List 的大小失效
ListBase
  anchorBookmark : CursorBookmark
作为锚点的项目的书签。
ListBase
  anchorIndex : int = -1
作为选择锚点的数据提供程序中项目的偏移量。
ListBase
 Inheritedborder : 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
 InheritedhorizontalScrollBar : 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
 InheritedmaskShape : 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
 InheritedresourceManager : IResourceManager
[] 引用管理所有应用程序本地化资源的对象。
UIComponent
  rowInfo : Array
[] ListRowInfo 对象数组,这些对象用于缓存行高和 listItems 中行的其它跟踪信息。
ListBase
  rowMap : Object
项目渲染器与其各自 ListRowInfo 对象的哈希映射。
ListBase
  runDataEffectNextUpdate : Boolean = false
一个标志,指示下次更新显示时是否应该启动数据效果。
ListBase
  runningDataEffect : Boolean = false
一个标志,指示当前是否正在运行数据更改效果
ListBase
 InheritedscrollAreaChanged : Boolean
一个标志,指示滚动区域随滚动条的出现或消失进行更改。
ScrollControlBase
  selectedData : Object
用于跟踪当前所选项目的 ListBaseSelectionData 对象的哈希表。
ListBase
  selectionIndicators : Object
所选指示符的哈希表。
ListBase
  selectionLayer : Sprite
listContent 中的图层,用于绘制所有选择内容和加亮指示符。
ListBase
  selectionTweens : Object
所选内容补间的哈希表。
ListBase
  showCaret : Boolean
一个标志,指示是否显示尖号。
ListBase
  unconstrainedRenderers : Dictionary
不受列表布局算法影响的项目渲染器的哈希映射
ListBase
 InheritedunscaledHeight : Number
[] 用于确定组件的未缩放高度的简便方法。
UIComponent
 InheritedunscaledWidth : Number
[] 用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成,还应将此宽度作为参数传递到 updateDisplayList() 中。
UIComponent
 InheritedverticalScrollBar : ScrollBar
垂直滚动条。
ScrollControlBase
  visibleData : Object
[] 视图中当前使用的数据提供程序项目渲染器的哈希表。
ListBase
  wordWrapChanged : Boolean = false
一个标志,指示自上次更新显示列表后 wordWrap 属性值是否已更改。
ListBase
公共方法
 方法定义方
  
构造函数。
ListBase
 Inherited
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
 Inherited
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
  
如果正在运行数据更改效果,则添加项目渲染器。
ListBase
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。
DisplayObjectContainer
  
返回将放置项目添加到放置目标中的位置的索引。
ListBase
 Inherited
callLater(method:Function, args:Array = null):void
排队稍后调用的函数。
UIComponent
 Inherited
删除此组件实例中的样式属性。
UIComponent
 Inherited
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。
DisplayObjectContainer
 Inherited
将 Point 对象由内容坐标转换为全局坐标。
UIComponent
 Inherited
将 Point 对象由内容坐标转换为本地坐标。
UIComponent
 Inherited
返回标识此容器中的子项的一组属性。
UIComponent
  
创建一个给定了数据对象的项目渲染器
ListBase
 Inherited
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。
UIComponent
 Inherited
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。
UIComponent
 Inherited
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。
UIComponent
 Inherited
将事件调度到事件流中。
UIComponent
 Inherited
在此组件周围显示或隐藏焦点指示符。
UIComponent
 Inherited
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
 Inherited
停止在组件上播放效果实例时,由效果实例调用。
UIComponent
 Inherited
开始在组件上播放效果实例时,由效果实例调用。
UIComponent
 Inherited
结束组件上当前播放的所有效果。
UIComponent
 Inherited
executeBindings(recurse:Boolean = false):void
将数据绑定到此 UIComponent 对象。
UIComponent
  
根据 String 查找列表中的项目,并将所选内容移至该项目。
ListBase
 Inherited
打印完成后调用。
UIComponent
 Inherited
在指定的索引位置提供自动化对象。
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
DisplayObject
 Inherited
返回位于指定索引处的子显示对象实例。
DisplayObjectContainer
 Inherited
返回具有指定名称的子显示对象。
DisplayObjectContainer
 Inherited
返回 DisplayObject 的 child 实例的索引位置。
DisplayObjectContainer
 Inherited
查找此 UIComponent 实例的类型选择器。
UIComponent
 Inherited
getConstraintValue(constraintName:String):*
返回一个约束布局值,这与获取此组件的约束样式的方式类似。
UIComponent
 Inherited
确定是使用显式高度还是测量高度的一种简便方法
UIComponent
 Inherited
确定是使用显式宽度还是测量宽度的一种简便方法
UIComponent
 Inherited
获取当前具有焦点的对象。
UIComponent
  
返回相应的工厂;如果尚未指定,则使用默认工厂。
ListBase
 Inherited
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。
DisplayObject
  
getRendererSemanticValue(target:Object, semanticProperty:String):Object
返回 true 或 false 以指示是否应在目标上播放效果。
ListBase
 Inherited
getRepeaterItem(whichRepeater:int = -1):Object
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。
UIComponent
 Inherited
getStyle(styleProp:String):*
获取已在此组件的样式查找链中的某个位置设置过的样式属性。
UIComponent
 Inherited
将 Point 对象由全局坐标转换为内容坐标。
UIComponent
 Inherited
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。
DisplayObject
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
  
在鼠标指针下方隐藏指示允许执行拖放操作的放置指示符。
ListBase
 Inherited
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。
DisplayObject
 Inherited
返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。
UIComponent
  
针对数据提供程序中某个项目的索引获取项目渲染器(如果存在)。
ListBase
  
indicesToIndex(rowIndex:int, colIndex:int):int
计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。
ListBase
 Inherited
初始化此组件的内部结构。
UIComponent
 Inherited
初始化用于跟踪此组件的重复实例的各个属性。
UIComponent
 Inherited
标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。
UIComponent
  
在下次更新时刷新所有行。
ListBase
 Inherited
标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。
UIComponent
 Inherited
标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。
UIComponent
  
确定是否加亮显示数据提供程序项目的项目渲染器(当鼠标滑过它,或者通过键盘导航使它位于尖号下方时)。
ListBase
  
确定数据提供程序项目的项目渲染器是否可选。
ListBase
  
确定是否已选中数据提供程序项目的项目渲染器。
ListBase
  
确定渲染器是否显示某个项目。
ListBase
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
确定渲染器是否包含(或拥有)显示对象。
ListBase
  
返回通过此项目渲染器呈现的该项目在数据提供程序中的项目索引。
ListBase
  
返回渲染器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。
ListBase
  
根据 iconField 和 iconFunction 属性返回表示数据项目图标的类(如果存在)。
ListBase
  
返回数据提供程序中给定项目的项目渲染器(如果存在)。
ListBase
  
返回渲染器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。
ListBase
 Inherited
将 Point 对象由本地坐标转换为内容坐标。
UIComponent
 Inherited
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。
DisplayObject
  
measureHeightOfItems(index:int = -1, count:int = 0):Number
使用当前项目渲染器测量数据提供程序中的一组项目,并返回这些项目的高度之和。
ListBase
 Inherited
测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标记),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。
UIComponent
 Inherited
测量指定的文本,假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。
UIComponent
  
measureWidthOfItems(index:int = -1, count:int = 0):Number
使用当前项目渲染器测量数据提供程序中的一组项目,并返回找到的最大宽度。
ListBase
 Inherited
将组件移动到其父项内的指定位置。
UIComponent
 Inherited
将样式更改传播到子项。
UIComponent
 Inherited
如果 owner 属性链从 child 指向此 UIComponent,则返回 true。
UIComponent
 Inherited
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。
UIComponent
 Inherited
准备 IFlexDisplayObject 用于打印。
UIComponent
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
为此组件构建或重新构建 CSS 样式缓存;如果 recursive 参数为 true,还会为此组件的所有后代执行同样的操作。
UIComponent
 Inherited
针对每个效果事件,将 EffectManager 注册为一个事件侦听器。
UIComponent
 Inherited
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。
DisplayObjectContainer
 Inherited
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。
DisplayObjectContainer
  
如果正在运行数据更改效果,则移除项目渲染器。
ListBase
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
重放指定的事件。
UIComponent
 Inherited
使用提供的 ID 解析子项。
UIComponent
 Inherited
[] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。
UIComponent
  
确保给定索引处的数据提供程序项目可见。
ListBase
 Inherited
调整对象大小。
UIComponent
 Inherited
更改现有子项在显示对象容器中的位置。
DisplayObjectContainer
 Inherited
setConstraintValue(constraintName:String, value:*):void
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。
UIComponent
 Inherited
setCurrentState(stateName:String, playTransition:Boolean = true):void
设置当前状态。
UIComponent
 Inherited
设置此组件的焦点。
UIComponent
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
对此组件实例设置样式属性。
UIComponent
 Inherited
setVisible(value:Boolean, noEvent:Boolean = false):void
当 visible 属性发生更改时调用。
UIComponent
  
在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。
ListBase
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
允许用户拖动指定的 Sprite。
Sprite
 Inherited
结束 startDrag() 方法。
Sprite
 Inherited
检测对样式属性的更改。
UIComponent
 Inherited
首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。
UIComponent
 Inherited
[] 阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。
UIComponent
 Inherited
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。
DisplayObjectContainer
 Inherited
返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。
FlexSprite
  
如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外,则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。
ListBase
 Inherited
验证子项的位置和大小,并绘制其它可视内容。
UIComponent
 Inherited
验证并更新此对象的属性和布局,如果需要的话重绘对象。
UIComponent
 Inherited
由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。
UIComponent
 Inherited
validateSize(recursive:Boolean = false):void
如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。
UIComponent
 Inherited
处理分配给此组件的验证程序调度的 valid 和 invalid 事件。
UIComponent
 Inherited
返回指定对象的原始值。
Object
 Inherited
返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。
UIComponent
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法定义方
  
作为拖放操作的一部分,将所选项目添加到 DragSource 对象。
ListBase
  
将渲染器添加到循环使用的渲染器列表,使其不可见并清除对该渲染器的引用。
ListBase
  
从用于存储对行的引用的数组开头添加一个空白行
ListBase
 Inherited
调整焦点矩形。
UIComponent
  
adjustListContent(unscaledWidth:Number = -1, unscaledHeight:Number = -1):void
从 updateDisplayList() 调用此方法,以调整 listContent 的大小和位置。
ListBase
  
设置应用选择指示符的效果。
ListBase
 Inherited
这是一个内部方法,供 Flex 框架用于支持 Dissolve 效果。
UIComponent
  
在执行拖放操作时计算放置指示符的 y 位置。
ListBase
 Inherited
创建子对象后执行任何最终处理。
UIComponent
  
清除给定 Sprite 中的尖号指示符。
ListBase
  
清除给定 Sprite 中的加亮指示符
ListBase
  
删除所有选定、加亮显示和尖号指示符。
ListBase
  
clearSelected(transition:Boolean = false):void
清除所选项目组,并移除表示那些项目的选定状态的所有图形。
ListBase
  
清空 visibleData 哈希表
ListBase
  
当数据发生更改时,处理从数据提供程序中调度的 CollectionEvent。
ListBase
  
根据是否已显式设置 columnCountcolumnWidth、rowHeight 和 rowCount 等属性来计算列宽、行高以及行数和列数。
ListBase
  
根据行数、列数以及可查看的行和列配置 ScrollBar。
ListBase
  
通过调用 ObjectUtil.copy() 方法为此对象制作一个深层副本,然后通过调用 UIDUtil.createUID() 方法用一个新值替代该副本的 uid 属性(如果存在)。
ListBase
  
copySelectedItems(useDataField:Boolean = true):Array
按所选项目的选择顺序为其制作副本。
ListBase
 Inherited
为此组件创建边框。
ScrollControlBase
  
创建对象作为此 ListBase 的子对象,在这种情况下为将控制所有项目渲染器的 listContent 对象。
ListBase
 Inherited
根据所用的嵌入字体使用上下文创建新对象。
UIComponent
 Inherited
使用给定的 moduleFactory 创建对象。
UIComponent
  
destroyRow(i:int, numCols:int):void
回收我们不再需要的行并删除其指示符
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
  
findKey(eventCode:int):Boolean
尝试在数据提供程序中查找下一个以 eventCode 参数中的字符开头的项目。
ListBase
  
在数据更改效果运行完毕后,通过恢复原始集合和迭代器并移除此效果使用的所有缓存值进行清理。
ListBase
  
基于 caretIndex 和 anchorIndex 属性设置所选项目。
ListBase
 Inherited
当 UIComponent 对象获得焦点时调用的事件处理函数。
UIComponent
 Inherited
当 UIComponent 对象失去焦点时调用的事件处理函数。
UIComponent
  
检索已创建但当前未使用的项目渲染器。
ListBase
  
给定索引处数据提供程序项目所在的列。
ListBase
  
给定索引处数据提供程序项目所在的行。
ListBase
 Inherited
完成对此组件的初始化。
UIComponent
 Inherited
初始化此组件的辅助功能代码。
UIComponent
  
initiateDataChangeEffect(unscaledWidth:Number, unscaledHeight:Number):void
当数据提供程序中发生更改时应用数据更改效果。
ListBase
 Inherited
通常由包含 UITextField 对象的组件覆盖,其中 UITextField 对象获取焦点。
UIComponent
  
如果项目渲染器不再根据列表的布局算法定位,则返回 true,尽管由于调用 unconstrainRenderer() 正在运行数据更改效果。
ListBase
  
返回一个包含项目渲染器的 columnIndex 和 rowIndex 的点。
ListBase
  
确定数据提供程序项目的 UID。
ListBase
 Inherited
为 keyDown 事件调用的事件处理函数。
UIComponent
 Inherited
为 keyUp 事件调用的事件处理函数。
UIComponent
 Inherited
layoutChrome(unscaledWidth:Number, unscaledHeight:Number):void
通过设置此控件边框的位置和大小来响应大小更改。
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
  
moveIndicatorsVertically(uid:String, moveBlockDistance:Number):void
垂直移动所选项目并加亮指示符
ListBase
  
moveRowVertically(i:int, numCols:int, moveBlockDistance:Number):void
垂直移动行,并更新 rowInfo 记录
ListBase
  
沿水平方向移动所选项目,以响应用户使用向左箭头或向右箭键头以及功能键(如 Shift 和 Ctrl 键)选择项目的操作。
ListBase
  
沿垂直方向移动所选项目,以响应用户使用向上箭头或向下箭头键以及功能键(如 Shift 和 Ctrl 键)选择项目的操作。
ListBase
  
准备集合事件的数据效果
ListBase
  
当渲染器发生更改时,updateDisplayList() 将调用此方法,用来移除现有的项目渲染器并清理各种缓存结构。
ListBase
  
更新 visibleData 哈希表中的键
ListBase
  
从用于存储对行的引用的数组中删除一行
ListBase
  
清理数据提供程序中给定项目的选项亮显及其它关联图形。
ListBase
 Inherited
构建 UIComponent 时将调用此方法,并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时,都会再次调用此方法。
UIComponent
  
从用于存储对行的引用的数组开头删除请求的行数
ListBase
 Inherited
roomForScrollBar(bar:ScrollBar, unscaledWidth:Number, unscaledHeight:Number):Boolean
ScrollControlBase
 Inherited
scroll 事件的默认事件处理函数。
ScrollControlBase
  
scrollHorizontally(pos:int, deltaPos:int, scrollUp:Boolean):void
调整渲染器以响应滚动位置的更改。
ListBase
  
scrollPositionToIndex(horizontalScrollPosition:int, verticalScrollPosition:int):int
返回给定滚动位置第一个可见行和列处的项目的数据提供程序索引。
ListBase
  
scrollVertically(pos:int, deltaPos:int, scrollUp:Boolean):void
调整渲染器以响应滚动位置的更改。
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
 Inherited
setScrollBarProperties(totalColumns:int, visibleColumns:int, totalRows:int, visibleRows:int):void
使 ScrollControlBase 基于传递的参数显示或隐藏滚动条。
ScrollControlBase
  
shiftRow(oldIndex:int, newIndex:int, numCols:int, shiftItems:Boolean):void
移动引用多行的数组中的某一行
ListBase
  
sumRowHeights(startRowIdx:int, endRowIdx:int):Number
确定所请求的行集的高度
ListBase
  
从用于存储对行的引用的数组末端删除所有剩余行
ListBase
  
Find an item renderer based on its UID if it is visible
ListBase
  
updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void
当可显示的项目数发生更改时添加或移除项目渲染器。
ListBase
  
立即刷新所有行。
ListBase
事件
 事件 摘要 定义方
 InheritedFlash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时调度。EventDispatcher
 Inherited使用 addChild() 或 addChildAt() 方法将组件作为内容子项添加到容器时调度。UIComponent
 Inherited将显示对象添加到显示列表中时调度。DisplayObject
 Inherited在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。DisplayObject
  当用户操作导致 selectedIndex 或 selectedItem 属性更改时调度此事件。ListBase
 Inherited用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。InteractiveObject
 Inherited当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。InteractiveObject
 Inherited当组件完成其构建、属性处理、测量、布置和绘制时调度。UIComponent
 Inherited视图状态更改后调度。UIComponent
 Inherited在 currentState 属性更改后但视图状态更改前调度。UIComponent
  当 data 属性更改时进行调度。ListBase
 InheritedFlash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时调度。EventDispatcher
 Inherited如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。InteractiveObject
 Inherited在拖动操作完成时(将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时)由拖动启动器(作为要拖动的数据源的组件)调度。UIComponent
 Inherited用户在放置目标上释放鼠标时由放置目标调度。UIComponent
 Inherited当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时,由该组件调度。UIComponent
 Inherited用户在组件外拖动但没有将数据放置到目标时,由组件调度。UIComponent
 Inherited在拖动操作期间,当用户在鼠标位于组件上方的情况下移动鼠标时,由组件调度。UIComponent
 Inherited启动拖动操作时,由拖动启动器调度。UIComponent
 Inherited在一个效果结束后调度。UIComponent
 Inherited在即将开始播放效果前调度。UIComponent
 Inherited播放头进入新帧时调度。DisplayObject
 Inherited组件返回到根视图状态之后调度。UIComponent
 Inherited组件退出根视图状态之前调度。UIComponent
 Inherited显示对象获得焦点后调度。InteractiveObject
 Inherited显示对象失去焦点后调度。InteractiveObject
 Inherited当对象的状态从可见变为不可见时调度。UIComponent
 Inherited当组件完成构建并设置了所有初始化属性后调度。UIComponent
 Inherited当组件由 Validator 监控且未通过验证时调度。UIComponent
  当用户单击控件中的某个项目时调度此事件。ListBase
  当用户双击控件中的某个项目时调度此事件。ListBase
  当用户将鼠标指针移出控件中的某个项目时调度此事件。ListBase
  当用户将鼠标指针滚至控件中的某个项目时调度此方法。ListBase
 Inherited用户按下某个键时调度。InteractiveObject
 Inherited用户尝试使用键盘导航更改焦点时调度。InteractiveObject
 Inherited用户释放某个键时调度。InteractiveObject
 Inherited当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited当用户在使用 PopUpManager 打开的某个组件外部单击时,从该组件调度。UIComponent
 Inherited用户尝试使用指针设备更改焦点时调度。InteractiveObject
 Inherited用户移动 InteractiveObject 上的指针设备时调度。InteractiveObject
 Inherited用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited当鼠标滚轮滚动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时,从该组件调度。UIComponent
 Inherited移动对象后调度。UIComponent
 Inherited当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。InteractiveObject
 Inherited在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时,由目标 InteractiveObject 调度。InteractiveObject
 Inherited当拖动动作进入其边界时由 InteractiveObject 调度。InteractiveObject
 Inherited当拖动动作离开其边界时由 InteractiveObject 调度。InteractiveObject
 Inherited当拖动动作保持在其边界内时,由 InteractiveObject 持续调度。InteractiveObject
 Inherited在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。InteractiveObject
 Inherited在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。InteractiveObject
 Inherited在组件初始化序列开始时调度。UIComponent
 Inherited使用 removeChild() 或 removeChildAt() 方法将组件作为内容子项从容器中删除时调度。UIComponent
 Inherited将要从显示列表中删除显示对象时调度。DisplayObject
 Inherited在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。DisplayObject
 Inherited将要更新和呈现显示列表时调度。DisplayObject
 Inherited在调整组件大小时调度。UIComponent
 Inherited当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited当滚动内容时调度。ScrollControlBase
 Inherited当对象的状态从不可见变为可见时调度。UIComponent
 Inherited对象的 tabChildren 标志值发生更改时调度。InteractiveObject
 Inherited对象的 tabEnabled 标志发生更改时调度。InteractiveObject
 Inherited对象的 tabIndex 属性值发生更改时调度。InteractiveObject
 Inherited要创建 ToolTip 时由组件调度。UIComponent
 Inherited已隐藏组件的 ToolTip 并要将其放弃时由组件调度。UIComponent
 Inherited要隐藏组件的 ToolTip 时由组件调度。UIComponent
 Inherited要显示组件的 ToolTip 时由组件调度。UIComponent
 Inherited显示组件的 ToolTip 时由组件调度。UIComponent
 Inherited用户将鼠标移动到设置了 toolTip 属性的组件上方后,由该组件调度。UIComponent
 Inherited当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度(如果需要)。UIComponent
 Inherited当组件由 Validator 监控并且成功通过验证时调度。UIComponent
 Inherited当以编程方式或通过用户交互更改值时调度。UIComponent
样式
 样式 说明 定义方
  
alternatingItemColors
类型: Array 格式: Color CSS 继承: yes
列表中项目使用的背景色。此值是由两种或更多种颜色组成的数组。列表项目的背景色将从数组中的各种颜色之间选取。

对于 DataGrid 控件,行中的所有项目都使用相同的背景色,而每行的背景色都由颜色数组确定。

对于只使用一个列表填充二维显示的 TileList 控件,此样式可根据指定的列数、行数和颜色数生成棋盘外观、条纹或其它图案。TileList 循环使用各种颜色,根据布局方向设置各个项目的背景色。如果您的 TileList 为水平布局,并且颜色数和列数均为偶数,则显示条纹图案。如果列数为奇数,则显示棋盘图案。

仅当未指定 backgroundColor 时才会生效。

默认值为 undefined.
ListBase
 Inherited类型: Number CSS 继承: no
backgroundColor 属性定义的颜色和 backgroundImage 样式定义的图像或 SWF 文件的 Alpha 级别。有效值范围为从 0.
ScrollControlBase
 Inherited类型: uint 格式: Color CSS 继承: no
组件的背景颜色。您可以同时设置 backgroundColorbackgroundImage。一些组件没有背景。DataGrid 控件会忽略此样式。默认值为 undefined,即不进行设置。如果此样式和 backgroundImage 样式都为 undefined,则控件将采用透明背景。

对于 Application 容器,此样式指定应用程序加载时的背景色以及运行该应用程序时的背景渐变。Flex 计算比指定颜色略深的颜色和比指定颜色略浅的颜色之间的渐变。

大多数 Flex 控件的默认外观为半透明。因此,容器的背景颜色将在某种程度上“渗入”该容器中的控件。通过将控件的 fillAlphas 属性的 alpha 值设置为 1 可以避免此情况,如以下示例所示:

 <mx:Container backgroundColor="0x66CC66"/> <mx:ControlName ...
ScrollControlBase
 Inherited类型: uint 格式: Color CSS 继承: yes
禁用组件时的组件的背景颜色。全局默认值为 undefined。List 控件的默认值为 0xDDDDDD(浅灰)。如果禁用了容器,背景将变暗,而暗淡程度由 disabledOverlayAlpha 样式控制。.
ScrollControlBase
 Inherited类型: Object 格式: File CSS 继承: no
组件的背景图像。此样式可以是绝对或相对 URL 或类。您可以同时设置 backgroundColorbackgroundImage。背景图像显示在背景色上面。默认值为 undefined,表示“未设置”。如果此样式和 backgroundColor 样式都未定义,则控件将采用透明背景。

大多数 Flex 控件的默认外观为半透明。因此,容器的背景图像将在某种程度上“渗入”该容器中的控件。通过将控件的 fillAlphas 属性的 alpha 值设置为 1 可以避免此情况,如以下示例所示:

 <mx:Container backgroundColor="0x66CC66"/> <mx:ControlName ...
ScrollControlBase
 Inherited类型: String CSS 继承: no
backgroundImage 指定的图像缩放到不同的百分比大小。"100%" 值将拉抻该图像以适应整个组件。要指定百分比值,您必须输入百分号 (%)。Application 容器的默认值为 100%。所有其它容器的默认值为 auto,此值将保持图像的原始大小。.
ScrollControlBase
 Inherited类型: String CSS 继承: no
从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位)。如果设置此样式,则组件的基线锚定在其内容区域的上边缘;调整组件容器大小后,这两个边缘将保持它们的间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
 Inherited类型: uint 格式: Color CSS 继承: no
边框颜色。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 0xB7BABC。.
ScrollControlBase
 Inherited类型: String CSS 继承: no
边框边。指定要显示的边框边的以空格分隔的 String。此 String 可以任意顺序包含 "left""top""right""bottom"。默认值为 "left top right bottom",此值会显示所有四条边。仅当 borderStyle 为 "solid" 时才使用此样式。.
ScrollControlBase
 Inherited类型: Class CSS 继承: no
组件的边框外观类。mx.
ScrollControlBase
 Inherited类型: String CSS 继承: no
边框样式。可能值为 "none""solid""inset""outset"。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 "inset"。大多数容器的默认值为 "none"。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: no
边框厚度。仅在将 borderStyle 设置为 "solid" 时使用。.
ScrollControlBase
 Inherited类型: String CSS 继承: no
从组件的下边缘到其内容区域的下边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的下边缘锚定在其内容区域的下边缘;调整组件容器大小后,这两个边缘将保持它们的间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
 Inherited类型: uint 格式: Color CSS 继承: yes
组件中文本(包括组件标签)的颜色。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: no
组件角的半径。默认值取决于组件类;如果未覆盖类的默认值,则默认值为 0。对于 ApplicationControlBar,默认值为 5。.
ScrollControlBase
 Inherited类型: uint 格式: Color CSS 继承: yes
禁用时组件中文本的颜色。.
ScrollControlBase
  
dropIndicatorSkin
类型: Class CSS 继承: no
用于指示所拖动项目的放置位置的外观。如果拖放操作的目标位置可能是 ListBase-derived 组件,则调用 showDropFeedback() 方法将产生此类的实例,并将该实例定位在所放置项目之后项目的 itemRenderer 上方一个像素处(如果进行放置)。 默认值为 mx.controls.listClasses.ListDropIndicator.
ListBase
 Inherited类型: uint 格式: Color CSS 继承: yes
投影颜色。.
ScrollControlBase
 Inherited类型: Boolean CSS 继承: no
指定组件是否具有可见投影的布尔值属性。此样式与 borderStyle="solid" 一起使用。默认值为 false

注意:对于显示在容器上的投影,需设置 backgroundColorbackgroundImage 属性。否则,由于容器的背景默认为透明,阴影将显示在容器后。

.
ScrollControlBase
 Inherited类型: uint 格式: Color CSS 继承: yes
验证失败时,组件加亮部分的颜色。验证失败时,Flex 还会将组件的 borderColor 样式设置为 errorColor。.
UIComponent
  
focusAlpha
类型: Number CSS 继承: no
指定焦点外观的 alpha 透明度值。 默认值为 0.4.
ListBase
 Inherited类型: String CSS 继承: no
焦点矩形使用的混合模式。有关详细信息,请参阅 flash.
UIComponent
  
focusRoundedCorners
类型: String CSS 继承: no
指定焦点矩形的哪些角应该是圆角。此值是使用空格分隔的 String,该 String 可以是 "tl""tr""bl""br" 的任意组合。例如,要指定右侧的角为圆角,左侧的角为直角,应使用 "tr br"cornerRadius 样式属性指定圆角的半径。默认值取决于组件类;如果未覆盖该类的默认值,则默认值为 "tl tr bl br"
ListBase
 Inherited类型: Class CSS 继承: no
用于绘制焦点矩形的外观。.
UIComponent
 Inherited类型: Number 格式: Length CSS 继承: no
焦点矩形轮廓的粗细,以像素为单位。.
UIComponent
 Inherited类型: String CSS 继承: yes
设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash.

另请参见

ScrollControlBase
 Inherited类型: String CSS 继承: yes
使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。.
ScrollControlBase
 Inherited类型: String CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash.

另请参见

ScrollControlBase
 Inherited类型: Number CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。

仅当使用嵌入字体并将 fontAntiAliasType 属性设置为 "advanced" 时,才应用此属性。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。

.

另请参见

ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: yes
文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。.
ScrollControlBase
 Inherited类型: String CSS 继承: yes
确定文本是否使用斜体。可识别的值为 "normal""italic"。.
ScrollControlBase
 Inherited类型: Number CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。

仅当使用嵌入字体并将 fontAntiAliasType 属性设置为 "advanced" 时,才应用此属性。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。

.

另请参见

ScrollControlBase
 Inherited类型: String CSS 继承: yes
确定文本是否使用粗体。可识别的值为 normalbold。Button 控件的默认值为 bold。所有其它控件的默认值为 normal。.
ScrollControlBase
 Inherited类型: String CSS 继承: no
从组件内容区域的中心到组件中心的水平距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整组件容器大小后,这两个中心将保持它们的水平间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
 Inherited类型: String CSS 继承: no
水平 scrollbar 的样式名称。通过它,可以更精细地控制滚动条的外观。.
ScrollControlBase
 Inherited类型: Boolean CSS 继承: yes
一个布尔值,指示是启用 (true) 还是禁用 (false) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: yes
文本行之间附加的垂直空间。

默认值为 2。

ComboBox 控件的默认值为 0。

.
ScrollControlBase
 Inherited类型: String CSS 继承: no
从组件内容区域的左边缘到组件左边缘的水平距离(以像素为单位)。如果设置此样式,则组件的左边缘锚定在其内容区域的左边缘;调整组件容器大小后,这两个边缘将保持它们的间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
 Inherited类型: 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
 Inherited类型: String CSS 继承: no
从组件的右边缘到其内容区域的右边缘的水平距离(以像素为单位)。如果设置此样式,则组件的右边缘锚定在其内容区域的右边缘;调整组件容器大小后,这两个边缘将保持它们的间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
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
 Inherited类型: String CSS 继承: no
投影方向。可能值包括 "left""center""right"。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: no
投影距离。如果将此属性设置为负值,此阴影将出现在组件的上方。.
ScrollControlBase
 Inherited类型: String CSS 继承: yes
容器内文本的对齐情况。可能值有:"left""right""center"

大多数组件的默认值为 "left"。对于 FormItem 组件,默认值为 "right"。对于 Button、LinkButton 和 AccordionHeader 组件,默认值为 "center",且仅当将 labelPlacement 属性设置为 "left""right" 时,才能识别此属性。如果将 labelPlacement 设置为 "top""bottom",将居中文本及所有图标。

.
ScrollControlBase
 Inherited类型: String CSS 继承: yes
确定文本是否加下划线。可能值有:"none""underline"。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: yes
文本第一行偏离容器左侧的距离(以像素为单位)。.
ScrollControlBase
  
textRollOverColor
类型: uint 格式: Color CSS 继承: yes
用户滚过鼠标时渲染器文本的颜色。 默认值为 0x2B333C.
ListBase
  
textSelectedColor
类型: uint 格式: Color CSS 继承: yes
用户选中渲染器时其文本的颜色。 默认值为 0x2B333C.
ListBase
 Inherited类型: uint 格式: Color CSS 继承: yes
组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示,但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值,但首选值为 haloGreenhaloBluehaloOrangehaloSilver

rollOverColorselectionColor 样式的默认值基于 themeColor 值。

.
UIComponent
 Inherited类型: String CSS 继承: no
从控件内容区域的上边缘到组件上边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的上边缘锚定在其内容区域的上边缘;调整其容器大小后,这两个边缘将保持其间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
  
useRollOver
类型: Boolean CSS 继承: no
一个标志,控制当鼠标滚过项目时是否加亮显示该项目。如果为 true,则当鼠标滚过行时加亮显示这些行。如果为 false,则只在选中行时才进行加亮显示。 默认值为 true.
ListBase
  
verticalAlign
类型: String CSS 继承: no
垂直对齐行中的渲染器。可能值包括 "top""middle""bottom"。DataGrid 根据此样式以及 paddingToppaddingBottom 样式在行中定位渲染器。如果某一行上各列中项目的高度不等,则其它列表类不使用 verticalAlign,但项目渲染器可以检查此样式属性,并根据检查结果调整其布局。 默认值为 "top".
ListBase
 Inherited类型: String CSS 继承: no
从组件内容区域的中心到组件中心的垂直距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整其容器大小后,这两个中心将保持其垂直间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
 Inherited类型: String CSS 继承: no
垂直 scrollbar 的样式名称。通过它,可以更精细地控制滚动条的外观。.
ScrollControlBase
效果
 效果 说明 定义方
 Inherited 触发事件: added
将组件作为子项添加到 Container 时播放。
UIComponent
 Inherited 触发事件: creationComplete
创建组件时播放。
UIComponent
 Inherited 触发事件: focusIn
组件获得键盘焦点时播放。
UIComponent
 Inherited 触发事件: focusOut
组件失去键盘焦点时播放。
UIComponent
 Inherited 触发事件: hide
组件变为不可见时播放。
UIComponent
 Inherited 触发事件: mouseDown
用户在组件上方按下鼠标按键时播放。
UIComponent
 Inherited 触发事件: mouseUp
用户在组件上方释放鼠标按键时播放。
UIComponent
 Inherited 触发事件: move
移动组件时播放。
UIComponent
 Inherited 触发事件: removed
从 Container 中删除组件时播放。
UIComponent
 Inherited 触发事件: resize
调整组件大小时播放。
UIComponent
 Inherited 触发事件: rollOut
用户将鼠标指针滚离组件上方时播放。
UIComponent
 Inherited 触发事件: rollOver
用户将鼠标指针滚动到组件上方时播放。
UIComponent
 Inherited 触发事件: show
组件变为可见时播放。
UIComponent
公共常量
 常量定义方
 InheritedDEFAULT_MAX_HEIGHT : Number = 10000
[] maxHeight 属性的默认值。
UIComponent
 InheritedDEFAULT_MAX_WIDTH : Number = 10000
[] maxWidth 属性的默认值。
UIComponent
 InheritedDEFAULT_MEASURED_HEIGHT : Number = 22
[] measuredHeight 属性的默认值。
UIComponent
 InheritedDEFAULT_MEASURED_MIN_HEIGHT : Number = 22
[] measuredMinHeight 属性的默认值。
UIComponent
 InheritedDEFAULT_MEASURED_MIN_WIDTH : Number = 40
[] measuredMinWidth 属性的默认值。
UIComponent
 InheritedDEFAULT_MEASURED_WIDTH : Number = 160
[] measuredWidth 属性的默认值。
UIComponent
属性详细信息
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属性 
protected var caretIndex:int = -1

作为选择尖号点的数据提供程序中项目的偏移量。

另请参见

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属性 
dragImageOffsets:Point  []

获取所拖动图像在拖放后的偏移量。


实现
    protected function get dragImageOffsets():Point
dragMoveEnabled属性 
dragMoveEnabled:Boolean  []

一个标志,指示在拖放操作过程中是否可以移动控件中的项目,而不只是从控件中复制这些项目。如果此属性设置为 truedragEnabled 属性设置为 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

一个标志,指示是否需要计算 columnWidthrowHeight 属性。如果样式更改可影响渲染器的测量结果,或数据提供程序发生更改,将设置此属性。

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  []

Review Needed

从 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。当计算 listItemsrowInfo 数组与数据提供程序中项目的关系时使用(与 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属性 
protected var selectedData:Object

用于跟踪当前所选项目的 ListBaseSelectionData 对象的哈希表。此表按项目的 UID 编制索引。

另请参见

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 columnWidthrowHeightrowCount 等属性来计算列宽、行高以及行数和列数。

另请参见

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():void

Interval 函数,用于在鼠标位于列表上方或下方时上下滚动列表。

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

基于 caretIndexanchorIndex 属性设置所选项目。如果键盘选择处理函数在滚动以获得更多项目时发生页面错误,就会由键盘选择处理函数和 updateDisplayList 方法调用。

getItemRendererFactory()方法 
public function getItemRendererFactory(data:Object):IFactory

返回相应的工厂;如果尚未指定,则使用默认工厂。

参数

data:Object — 供项目渲染器显示的数据。

返回
IFactory — 如果 data 为空,则返回默认的项目渲染器;否则,返回自定义的项目渲染器。
getRendererSemanticValue()方法 
public function getRendererSemanticValue(target:Object, semanticProperty:String):Object

返回 truefalse 以指示是否应在目标上播放效果。当您在数据效果上设置 filter 属性时,EffectTargetFilter 类调用此方法。例如,将 filter 属性设置为 addItemremoveItem

参数

target:Object — 项目渲染器
 
semanticProperty:String — 要返回其值的渲染器的语义属性。

返回
Objecttruefalse,指示是否应在目标对象中播放效果。
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)( 开始向下插入。

如果已指定 byCountrowsNeeded,则只需创建指定的行数,并忽略 bottomright 参数。

参数

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

根据 rowCountcolumnCountrowHeightcolumnWidth 属性计算组件的度量宽度和高度。

另请参见

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 键)选择项目的操作。这种方法可能会更改 horizontalScrollPositionverticalScrollPositioncaretIndex 属性,并调用 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 键)选择项目的操作。此方法可以更改 horizontalScrollPositionverticalScrollPositioncaretIndex 属性,并调用 finishKeySelection() 方法更新所选内容

参数

code:uint — 按下的键(如 Keyboard.DOWN)
 
shiftKey:Boolean — 如果在按下键盘键的同时按住 Shift 键,则为 true
 
ctrlKey:Boolean — 如果在按下键盘键的同时按住 Ctrl 键,则为 true

prepareDataEffect()方法 
protected function prepareDataEffect(ce:CollectionEvent):void

准备集合事件的数据效果

参数

ce:CollectionEvent

purgeItemRenderers()方法 
protected function purgeItemRenderers():void

当渲染器发生更改时,updateDisplayList() 将调用此方法,用来移除现有的项目渲染器并清理各种缓存结构。

reKeyVisibleData()方法 
protected function reKeyVisibleData():void

更新 visibleData 哈希表中的键

removeDataEffectItem()方法 
public function removeDataEffectItem(target:Object):void

如果正在运行数据更改效果,则移除项目渲染器。项目渲染器必须与从数据提供程序集合中移除的数据对应。此函数将作为数据更改效果的一部分由 RemoveItemAction 效果调用,用以指定使用项目渲染器的控件停止显示数据项目的时间点。

参数

target:Object — 要从控件布局中删除的项目渲染器。

removeFromRowArrays()方法 
protected function removeFromRowArrays(i:int):void

从用于存储对行的引用的数组中删除一行

参数

i:int — 行的索引

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):IListItemRenderer

Find 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.ListEvent
ListEvent.type 属性 = mx.events.ListEvent.CHANGE

当用户操作导致 selectedIndexselectedItem 属性更改时调度此事件。

ListEvent.CHANGE 常数可为 change 事件定义 ListEvent 对象的 type 属性的值,指示由于用户交互所选内容已发生更改。

事件对象的属性有下列值:

属性
bubblesfalse
cancelablefalse
columnIndex 与事件相关联的列的从零开始的索引。
currentTarget用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
itemRenderer单击的项目渲染器。
reasonnull
rowIndex与事件相关联的项目的从零开始的索引。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
类型ListEvent.CHANGE
dataChange 事件  
事件对象类型: mx.events.FlexEvent
FlexEvent.type 属性 = mx.events.FlexEvent.DATA_CHANGE

data 属性更改时进行调度。

当您使用组件作为项目渲染器时,data 属性将包含要显示的数据。您可以侦听此事件,并在 data 属性更改时更新组件。

FlexEvent.DATA_CHANGE 常数可为 dataChange 事件定义事件对象的 type 属性值。

事件对象的属性有下列值:

属性
bubblesfalse
cancelablefalse
currentTarget用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
itemClick 事件  
事件对象类型: mx.events.ListEvent
ListEvent.type 属性 = mx.events.ListEvent.ITEM_CLICK

当用户单击控件中的某个项目时调度此事件。

ListEvent.ITEM_CLICK 常数可为 itemClick 事件定义 ListEvent 对象的 type 属性的值,指示用户在控件中某个可视项目上单击了鼠标。

事件对象的属性有下列值:

属性
bubblesfalse
cancelablefalse
columnIndex 与事件相关联的列的从零开始的索引。
currentTarget用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
itemRenderer单击的项目渲染器。
reasonnull
rowIndex与事件相关联的项目的从零开始的索引。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
类型ListEvent.ITEM_CLICK
itemDoubleClick 事件  
事件对象类型: mx.events.ListEvent
ListEvent.type 属性 = mx.events.ListEvent.ITEM_DOUBLE_CLICK

当用户双击控件中的某个项目时调度此事件。

ListEvent.ITEM_DOUBLE_CLICK 常数可为 itemDoubleClick 事件定义 ListEvent 对象的 type 属性的值,指示用户在控件中某个可视项目上双击了鼠标。

若要接收 itemDoubleClick 事件,必须将组件的 doubleClickEnabled 属性设置为 true

事件对象的属性有下列值:

属性
bubblesfalse
cancelablefalse
columnIndex 与事件相关联的列的从零开始的索引。
currentTarget用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
itemRenderer双击的项目渲染器。
reasonnull
rowIndex与事件相关联的项目的从零开始的索引。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
类型ListEvent.ITEM_DOUBLE_CLICK
itemRollOut 事件  
事件对象类型: mx.events.ListEvent
ListEvent.type 属性 = mx.events.ListEvent.ITEM_ROLL_OUT

当用户将鼠标指针移出控件中的某个项目时调度此事件。

ListEvent.ITEM_ROLL_OUT 常数可为 itemRollOut 事件定义 ListEvent 对象的 type 属性的值,指示用户执行了将鼠标指针从控件中某个可视项目上移开的操作。

事件对象的属性有下列值:

属性
bubblesfalse
cancelablefalse
columnIndex 与事件相关联的列的从零开始的索引。
currentTarget用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
itemRenderer被移开的项目渲染器。
reasonnull
rowIndex与事件相关联的项目的从零开始的索引。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
类型ListEvent.ITEM_ROLL_OUT
itemRollOver 事件  
事件对象类型: mx.events.ListEvent
ListEvent.type 属性 = mx.events.ListEvent.ITEM_ROLL_OVER

当用户将鼠标指针滚至控件中的某个项目时调度此方法。

ListEvent.ITEM_ROLL_OVER 常数可为 itemRollOver 事件定义 ListEvent 对象的 type 属性的值,指示用户执行了将鼠标指针滑过控件中某个可视项目的操作。

事件对象的属性有下列值:

属性
bubblesfalse
cancelablefalse
columnIndex 与事件相关联的列的从零开始的索引。
currentTarget用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
itemRenderer滑过的项目渲染器。
reasonnull
rowIndex与事件相关联的项目的从零开始的索引。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
类型ListEvent.ITEM_ROLL_OVER




 

评论添加到页面后给我发送电子邮件 | 评论报告

当前页: http://livedocs.adobe.com/flex/3_cn/mx/controls/listClasses/ListBase.html