mx.controls.List (Flex 3.2)

特征	说明
默认大小	足以适合前七个可见项目（如果项目少于七个，则为列表中所有可见项目）中最宽标签的宽度；高度为七行，其中每行高 20 个像素。
最小大小	0 个像素。
最大大小	5000 × 5000。

公共属性

	属性		定义方
		accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。	DisplayObject
		activeEffects : Array [只读 (read-only)] 组件上当前播放的效果列表，如 EffectInstance 实例的 Array。	UIComponent
		allowDragSelection : Boolean = false 一个标志，指示是否启用拖动选择。	ListBase
		allowMultipleSelection : Boolean 一个标志，指示是否允许您同时选择多个项目。	ListBase
		alpha : Number 指示指定对象的 Alpha 透明度值。	DisplayObject
		automationDelegate : Object 处理自动化相关功能的委托对象。	UIComponent
		automationName : String 可用作此对象的标识符的名称。	UIComponent
		automationTabularData : Object [只读 (read-only)] IAutomationTabularData 接口的实现，可用于检索数据。	UIComponent
		automationValue : Array [只读 (read-only)] 此值通常对应于对象的经渲染的外观，当对象在应用中以可视方式显示时，此值使标识符与该对象相关联。	UIComponent
		baselinePosition : Number [只读 (read-only)] 组件第一行文本的基线的 y 坐标。	UIComponent
		blendMode : String BlendMode 类中的一个值，用于指定要使用的混合模式。	DisplayObject
		blendShader : Shader [只写] 设置用于混合前景和背景的着色器。	DisplayObject
		borderMetrics : EdgeMetrics [只读 (read-only)] 返回 EdgeMetrics 对象，它具有四个属性：left、top、right 和 bottom。	ScrollControlBase
		buttonMode : Boolean 指定此 sprite 的按钮模式。	Sprite
		cacheAsBitmap : Boolean 如果设置为 true，则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。	DisplayObject
		cacheHeuristic : Boolean [只写] 供 Flex 使用，表示建议为对象实施位图缓存。	UIComponent
		cachePolicy : String 指定此对象的位图缓存策略。	UIComponent
		className : String [只读 (read-only)] 此实例的类的名称，如“Button”。	UIComponent
		columnCount : int 在 TileList 控件中显示的列数，或在 HorizontalList 控件中显示的项目数。	ListBase
		columnWidth : Number 控件中列的宽度。	ListBase
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		contentMouseX : Number [只读 (read-only)] 返回鼠标在内容坐标系中的 x 位置。	UIComponent
		contentMouseY : Number [只读 (read-only)] 返回内容坐标系中鼠标的 y 位置。	UIComponent
		contextMenu : NativeMenu 指定与此对象相关联的上下文菜单。	InteractiveObject
		currentState : String 组件的当前视图状态。	UIComponent
		cursorManager : ICursorManager [只读 (read-only)] 获取控制此组件及其同级组件的光标的 CursorManager。	UIComponent
		data : Object 将此组件用作项目渲染器或项目编辑器时，此组件应呈现的数据提供程序中的项目。	ListBase
		dataProvider : Object 要查看的数据集。	ListBase
		dataTipField : String 数据提供程序项目中作为数据提示显示的字段名称。	ListBase
		dataTipFunction : Function 用户提供的函数，在各个项目上运行以确定其数据提示。	ListBase
		descriptor : UIComponentDescriptor 引用 UIComponentDescriptor（如果有），过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。	UIComponent
		document : Object 引用与此 UIComponent 相关联的文档对象。	UIComponent
		doubleClickEnabled : Boolean 指定 UIComponent 对象是否接收 doubleClick 事件。	UIComponent
		dragEnabled : Boolean 一个标志，指示是否可以将项目拖出此控件并放到其它控件上。	ListBase
		dragMoveEnabled : Boolean 一个标志，指示在拖放操作过程中是否可以移动控件中的项目，而不只是从控件中复制这些项目。	ListBase
		dropEnabled : Boolean 一个标志，指示是否可以将所拖动的项目放到此控件上。	ListBase
		dropTarget : DisplayObject [只读 (read-only)] 指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。	Sprite
		editable : Boolean = false 一个标志，指示用户能否编辑数据提供程序中的项目。	List
		editedItemPosition : Object 正在编辑的数据提供程序项目的项目渲染器的列索引和行索引（如果有）。	List
		editedItemRenderer : IListItemRenderer [只读 (read-only)] 对当前正在编辑的项目所属的 DataGrid 控件中项目渲染器的引用。	List
		editorDataField : String = "text" 项目编辑器的属性名称，其中包含列表项目的新数据。	List
		editorHeightOffset : Number = 0 项目编辑器相对于项目渲染器大小的高度（以像素为单位）。	List
		editorUsesEnterKey : Boolean = false 指示项目编辑器是否使用 Enter 键的标志。	List
		editorWidthOffset : Number = 0 项目编辑器相对于项目渲染器大小的宽度（以像素为单位）。	List
		editorXOffset : Number = 0 项目编辑器左上角相对于项目左上角的 x 位置（以像素为单位）。	List
		editorYOffset : Number = 0 项目编辑器左上角相对于项目左上角的 y 位置（以像素为单位）。	List
		enabled : Boolean 组件是否可以接受用户交互。	UIComponent
		errorString : String 当验证程序监视组件并且验证失败时，组件的错误提示中将显示的文本。	UIComponent
		explicitHeight : Number 指定该组件在组件坐标中显式高度（以像素为单位）的数字。	UIComponent
		explicitMaxHeight : Number 布局过程中父级要考虑的组件最大建议高度。	UIComponent
		explicitMaxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。	UIComponent
		explicitMinHeight : Number 布局过程中父级要考虑的组件最小建议高度。	UIComponent
		explicitMinWidth : Number 布局过程中父级要考虑的组件最小建议宽度。	UIComponent
		explicitWidth : Number 指定该组件在组件坐标中显式宽度（以像素为单位）的数字。	UIComponent
		filters : Array 包含当前与显示对象关联的每个滤镜对象的索引数组。	DisplayObject
		flexContextMenu : IFlexContextMenu 此 UIComponent 的上下文菜单。	UIComponent
		focusEnabled : Boolean 指示切换到此组件时，是否可以接收焦点。	UIComponent
		focusManager : IFocusManager 获取控制此组件及其同级组件的焦点的 FocusManager。	UIComponent
		focusPane : Sprite 与此对象相关联的焦点窗格。	UIComponent
		focusRect : Object 指定此对象是否显示焦点矩形。	InteractiveObject
		graphics : Graphics [只读 (read-only)] 指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘画命令。	Sprite
		height : Number 指定组件在父坐标中的高度的数字（以像素为单位）。	UIComponent
		hitArea : Sprite 指定一个 sprite 用作另一个 sprite 的点击区域。	Sprite
		horizontalScrollPolicy : String 指示水平滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。	ScrollControlBase
		horizontalScrollPosition : Number 内容与左边缘的偏移量。	ScrollControlBase
		iconField : String 数据提供程序对象中字段的名称，该字段用于确定显示为图标的对象。	ListBase
		iconFunction : Function 用户提供的函数，在每个项目上运行以确定其图标。	ListBase
		id : String 组件 ID。	UIComponent
		imeMode : String 指定 IME（输入法编辑器）模式。	List
		includeInLayout : Boolean 指定此组件是否包含在父容器的布局中。	UIComponent
		inheritingStyles : Object 此组件的继承样式链的开头内容。	UIComponent
		initialized : Boolean 一个标志，用于确定某个对象是否已通过布局的所有三个阶段：提交、测量和布局（假设每个阶段都是必需的）。	UIComponent
		instanceIndex : int [只读 (read-only)] 重复组件的索引。	UIComponent
		instanceIndices : Array 一个 Array，包含从此 UIComponent 对象的父文档引用该对象所需的索引。	UIComponent
		isDocument : Boolean [只读 (read-only)] 确定此 UIComponent 实例是否为文档对象，也就是说它是否位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。	UIComponent
		isPopUp : Boolean PopUpManager 将其设置为 true 以指示已弹出该组件。	UIComponent
		itemEditor : IFactory 如果将可编辑属性设置为 true，则为用于控件的项目编辑器的类工厂。	List
		itemEditorInstance : IListItemRenderer 对项目编辑器的当前活动实例（如果有）的引用。	List
		itemRenderer : IFactory 控件的自定义项目渲染器。	ListBase
		labelField : String 数据提供程序项目中作为标签显示的字段名称。	ListBase
		labelFunction : Function 用户提供的函数，在每个项目上运行以确定其标签。	ListBase
		listData : BaseListData 如果使用组件作为嵌入式项目渲染器或嵌入式项目编辑器，则 Flex 将使用 list 控件中的其它数据初始化组件的 listData 属性。	ListBase
		liveScrolling : Boolean = true 一个标志，指示移动滚动栏滑块时实时滚动视图，还是释放滑块后才更新视图。	ScrollControlBase
		loaderInfo : LoaderInfo [只读 (read-only)] 返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。	DisplayObject
		mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。	DisplayObject
		maxHeight : Number 布局过程中父级要考虑的组件最大建议高度。	UIComponent
		maxHorizontalScrollPosition : Number horizontalScrollPosition 属性的最大值。	ScrollControlBase
		maxVerticalScrollPosition : Number verticalScrollPosition 属性的最大值。	ScrollControlBase
		maxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。	UIComponent
		measuredHeight : Number 组件的默认高度（以像素为单位）。	UIComponent
		measuredMinHeight : Number 组件的默认最小高度（以像素为单位）。	UIComponent
		measuredMinWidth : Number 组件的默认最小宽度（以像素为单位）。	UIComponent
		measuredWidth : Number 组件的默认宽度（以像素为单位）。	UIComponent
		menuSelectionMode : Boolean = false 一个标志，指示是否应使用菜单样式选择。	ListBase
		minHeight : Number 布局过程中父级要考虑的组件最小建议高度。	UIComponent
		minWidth : Number 布局过程中父级要考虑的组件最小建议宽度。	UIComponent
		moduleFactory : IFlexModuleFactory 用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。	UIComponent
		mouseChildren : Boolean 确定对象的子项是否支持鼠标。	DisplayObjectContainer
		mouseEnabled : Boolean 指定此对象是否接收鼠标消息。	InteractiveObject
		mouseFocusEnabled : Boolean 单击时是否可接收焦点。	UIComponent
		mouseX : Number [只读 (read-only)] 指示鼠标位置的 x 坐标，以像素为单位。	DisplayObject
		mouseY : Number [只读 (read-only)] 指示鼠标位置的 y 坐标，以像素为单位。	DisplayObject
		name : String 指示 DisplayObject 的实例名称。	DisplayObject
		nestLevel : int 此对象在所属关系层次结构中的深度。	UIComponent
		nonInheritingStyles : Object 此组件的非继承样式链的开头内容。	UIComponent
		nullItemRenderer : IFactory 控件的自定义项目渲染器。	ListBase
		numAutomationChildren : int [只读 (read-only)] 此容器包含的自动化子项数。	UIComponent
		numChildren : int [只读 (read-only)] 返回此对象的子项数目。	DisplayObjectContainer
		offscreenExtraRowsOrColumns : int 项目渲染器的额外行或列的目标数量，供在控件布局中使用。	ListBase
		opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。	DisplayObject
		owner : DisplayObjectContainer 此 UIComponent 的所有者。	UIComponent
		parent : DisplayObjectContainer [只读 (read-only)] 此组件的父容器或组件。	UIComponent
		parentApplication : Object [只读 (read-only)] 引用包含此 UIComponent 实例的 Application 对象。	UIComponent
		parentDocument : Object [只读 (read-only)] 引用此 UIComponent 的父文档对象。	UIComponent
		percentHeight : Number 以组件父项大小百分比的方式指定组件高度的数字。	UIComponent
		percentWidth : Number 以组件父项大小百分比形式指定其宽度的数字。	UIComponent
		processedDescriptors : Boolean 临时或延迟子项创建操作后设置为 true，具体取决于发生对象。	UIComponent
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		rendererIsEditor : Boolean = false 指定项目渲染器是否同时也是项目编辑器。	List
		repeater : IRepeater [只读 (read-only)] 对生成此 UIComponent 的父文档中 Repeater 对象的引用。	UIComponent
		repeaterIndex : int [只读 (read-only)] 项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。	UIComponent
		repeaterIndices : Array 一个 Array，包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。	UIComponent
		repeaters : Array 一个 Array，包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。	UIComponent
		root : DisplayObject [只读 (read-only)] 对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。	DisplayObject
		rotation : Number 指示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。	DisplayObject
		rotationX : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。	DisplayObject
		rotationY : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。	DisplayObject
		rotationZ : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。	DisplayObject
		rowCount : int 要显示的行数。	ListBase
		rowHeight : Number 行高（以像素为单位）。	ListBase
		scale9Grid : Rectangle 当前有效的缩放网格。	DisplayObject
		scaleX : Number 用于指定水平缩放系数的数字。	UIComponent
		scaleY : Number 用于指定垂直缩放系数的数字。	UIComponent
		scaleZ : Number 指示从对象的注册点开始应用的对象的深度缩放比例（百分比）。	DisplayObject
		screen : Rectangle [只读 (read-only)] 返回包含此对象的基本绘图表面大小和位置的对象。	UIComponent
		scrollRect : Rectangle 显示对象的滚动矩形范围。	DisplayObject
		scrollTipFunction : Function 将要显示的字符串作为 ScrollTip 计算的函数。	ScrollControlBase
		selectable : Boolean 一个标志，指示列表是否将所选项目显示为选中状态。	ListBase
		selectedIndex : int 所选项目的数据提供程序中的索引。	ListBase
		selectedIndices : Array 数据提供程序中所选项目的索引的数组。	ListBase
		selectedItem : Object 对数据提供程序中所选项目的引用。	ListBase
		selectedItems : Array 对数据提供程序中所选项目的引用的数组。	ListBase
		showDataTips : Boolean 一个标志，指示是否为行中的文本显示数据提示。	ListBase
		showInAutomationHierarchy : Boolean 用于确定自动化对象是否显示在自动化层次中的标志。	UIComponent
		showScrollTips : Boolean = false 一个标志，指示拖动滚动滑块时是否应在其旁边显示工具提示。	ScrollControlBase
		soundTransform : SoundTransform 控制此 sprite 中的声音。	Sprite
		stage : Stage [只读 (read-only)] 显示对象的舞台。	DisplayObject
		states : Array 为此组件定义的视图状态。	UIComponent
		styleDeclaration : CSSStyleDeclaration 存储此对象的内嵌继承样式。	UIComponent
		styleName : Object 此组件使用的类样式。	UIComponent
		systemManager : ISystemManager 返回此组件使用的 SystemManager 对象。	UIComponent
		tabChildren : Boolean 确定对象的子项是否支持 Tab 键。	DisplayObjectContainer
		tabEnabled : Boolean 指定此对象是否遵循 Tab 键顺序。	InteractiveObject
		tabIndex : int 指定 SWF 文件中的对象按 Tab 键顺序排列。	InteractiveObject
		textSnapshot : TextSnapshot [只读 (read-only)] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。	DisplayObjectContainer
		toolTip : String 要在 ToolTip 中显示的文本。	UIComponent
		transform : Transform 一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。	DisplayObject
		transitions : Array 一个 Transition 对象 Array，其中的每个 Transition 对象都定义一组效果，用于在视图状态发生更改时播放。	UIComponent
		tweeningProperties : Array 当前在此对象上进行补间的属性数组。	UIComponent
		uid : String 对象的唯一标识符。	UIComponent
		updateCompletePendingFlag : Boolean 一个标志，确定某个对象是否已通过所有三个阶段的布局验证（假设需要通过所有验证）。	UIComponent
		useHandCursor : Boolean 布尔值，指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形（手形光标）。	Sprite
		validationSubField : String 供验证程序用来将子字段与此组件相关联。	UIComponent
		value : Object [只读 (read-only)] 所选项目，或者所选项目的数据或标签字段。	ListBase
		variableRowHeight : Boolean 一个标志，指示各行是否可以采用不同的高度。	ListBase
		verticalScrollPolicy : String 指示垂直滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。	ScrollControlBase
		verticalScrollPosition : Number 顶边到内容的偏移量。	ScrollControlBase
		viewMetrics : EdgeMetrics [只读 (read-only)] 考虑滚动条（如果可见）的 EdgeMetrics 对象。	ScrollControlBase
		visible : Boolean 控制此 UIComponent 的可见性。	UIComponent
		width : Number 指定组件在父坐标中的宽度的数字（以像素为单位）。	UIComponent
		wordWrap : Boolean 一个标志，指示行中的文本是否应自动换行。	ListBase
		x : Number 指定组件在其父容器中的水平位置（以像素为单位）的数字。	UIComponent
		y : Number 指定组件在其父容器中的垂直位置（以像素为单位）的数字。	UIComponent
		z : Number 指示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。	DisplayObject

	属性	定义方
		actualCollection : ICollectionView 通常存储于运行数据更改效果时使用的 collection 中的值副本。	ListBase
		actualIterator : IViewCursor 通常存储于运行数据更改效果时使用的 iterator 中的值副本。	ListBase
		allowItemSizeChangeNotification : Boolean [只写] 如果设置为 false，则渲染器无法使 List 的大小失效.	ListBase
		anchorBookmark : CursorBookmark 作为锚点的项目的书签。	ListBase
		anchorIndex : int = -1 作为选择锚点的数据提供程序中项目的偏移量。	ListBase
		border : IFlexDisplayObject 边框对象。	ScrollControlBase
		cachedItemsChangeEffect : IEffect = null 当控件的数据提供程序中发生更改时播放的效果，通过 itemsChangeEffect 样式设置。	ListBase
		caretBookmark : CursorBookmark 尖号下方项目的书签。	ListBase
		caretIndex : int = -1 作为选择尖号点的数据提供程序中项目的偏移量。	ListBase
		caretIndicator : Sprite 包含图形的 DisplayObject，该图形指示哪个渲染器是尖号。	ListBase
		caretItemRenderer : IListItemRenderer 尖号下方项目的渲染器。	ListBase
		caretUID : String 尖号下方项目的 UID。	ListBase
		collection : ICollectionView 用于提供数据提供程序的 ICollectionView。	ListBase
		dataEffectCompleted : Boolean = false 一个标志，指示数据更改效果已完成。	ListBase
		dataItemWrappersByRenderer : Dictionary 将项目渲染器映射到 ItemWrappers（用于提供其数据）的 dictionary。	ListBase
		defaultColumnCount : int = 4 要显示的默认列数。	ListBase
		defaultRowCount : int = 4 要显示的默认行数。	ListBase
		dragImage : IUIComponent [只读 (read-only)] 获取可显示拖放操作中的可视效果的类实例。	ListBase
		dragImageOffsets : Point [只读 (read-only)] 获取所拖动图像在拖放后的偏移量。	ListBase
		explicitColumnCount : int = -1 显式设置 columnCount 属性时需要的列计数。	ListBase
		explicitColumnWidth : Number 显式设置 columnWidth 时需要的列宽。	ListBase
		explicitRowCount : int = -1 显式设置 rowCount 时需要的行计数。	ListBase
		explicitRowHeight : Number 显式设置 rowHeight 时需要的行高。	ListBase
		factoryMap : Dictionary 项目渲染器基于工厂的映射。	ListBase
		freeItemRenderers : Array 闲置项目渲染器的堆栈。	ListBase
		freeItemRenderersByFactory : Dictionary 空闲项目渲染器基于工厂的映射。	ListBase
		highlightIndicator : Sprite 包含图形的 DisplayObject，用以指示加亮哪个渲染器。	ListBase
		highlightItemRenderer : IListItemRenderer 当前滚动到尖号上方或下方的渲染器。	ListBase
		highlightUID : String 当前滚动到尖号上方或下方的项目的 UID。	ListBase
		horizontalScrollBar : ScrollBar 水平滚动条。	ScrollControlBase
		itemsNeedMeasurement : Boolean = true 一个标志，指示是否需要计算 columnWidth 和 rowHeight 属性。	ListBase
		itemsSizeChanged : Boolean = false 一个标志，指示渲染器的大小可能已更改。	ListBase
		iterator : IViewCursor 主 IViewCursor，用于从数据提供程序中获取项目并将这些项目传递到渲染器。	ListBase
		iteratorValid : Boolean = true 一个标志，指示发生页面错误和迭代器位置无效（未放置在所显示的最上方项目处）。	ListBase
		keySelectionPending : Boolean = false 一个标志，指示键盘选择是否由于页面错误而中断。	ListBase
		lastDropIndex : int 最近计算出的索引，这是拖动项目在放置目标中的添加位置。	ListBase
		lastSeekPending : ListBaseSeekPending 导致页面错误的最新一次搜寻。	ListBase
		listContent : ListBaseContentHolder 一个内部显示对象，是所有项目渲染器、选择内容、亮显指示符以及其它支持图形的父级。	ListBase
		listContentStyleFilters : Object [只读 (read-only)] 从 ListBase 传递到 listContent 的一组样式。	ListBase
		listItems : Array [只读 (read-only)] 一个由数组组成的数组，其中包含用于呈现每个数据提供程序项目的 itemRenderer 实例。	ListBase
		maskShape : Shape 遮罩。	ScrollControlBase
		measuringObjects : Dictionary 工厂设置的度量对象的缓存	List
		modifiedCollectionView : ModifiedCollectionView 集合视图，用于暂时保留上次的数据提供程序状态，以方便运行数据更改效果。	ListBase
		offscreenExtraColumns : int = 0 用于控件布局的项目渲染器的额外列的目标数量。	ListBase
		offscreenExtraColumnsLeft : int = 0 当前位于最左侧可视列左侧的屏幕外的列数。	ListBase
		offscreenExtraColumnsRight : int = 0 当前位于最右侧可视列右侧的屏幕外的列数。	ListBase
		offscreenExtraRows : int = 0 要用于控件布局的项目渲染器中额外行的目标数量。	ListBase
		offscreenExtraRowsBottom : int = 0 当前位于底部可视渲染器下方的屏幕外的项目数。	ListBase
		offscreenExtraRowsOrColumnsChanged : Boolean = false 一个标志，指示屏幕外的行数或列数可能已更改。	ListBase
		offscreenExtraRowsTop : int = 0 当前位于最顶部可见行上方的屏幕外的行数。	ListBase
		rendererChanged : Boolean = false 一个标志，指示渲染器已更改。	ListBase
		reservedItemRenderers : Object 当前闲置但近期可能会用到的项目渲染器的哈希映射。	ListBase
		resourceManager : IResourceManager [只读 (read-only)] 引用管理所有应用程序本地化资源的对象。	UIComponent
		rowInfo : Array [只读 (read-only)] ListRowInfo 对象数组，这些对象用于缓存行高和 listItems 中行的其它跟踪信息。	ListBase
		rowMap : Object 项目渲染器与其各自 ListRowInfo 对象的哈希映射。	ListBase
		runDataEffectNextUpdate : Boolean = false 一个标志，指示下次更新显示时是否应该启动数据效果。	ListBase
		runningDataEffect : Boolean = false 一个标志，指示当前是否正在运行数据更改效果.	ListBase
		scrollAreaChanged : Boolean 一个标志，指示滚动区域随滚动条的出现或消失进行更改。	ScrollControlBase
		selectedData : Object 用于跟踪当前所选项目的 ListBaseSelectionData 对象的哈希表。	ListBase
		selectionIndicators : Object 所选指示符的哈希表。	ListBase
		selectionLayer : Sprite listContent 中的图层，用于绘制所有选择内容和加亮指示符。	ListBase
		selectionTweens : Object 所选内容补间的哈希表。	ListBase
		showCaret : Boolean 一个标志，指示是否显示尖号。	ListBase
		unconstrainedRenderers : Dictionary 不受列表布局算法影响的项目渲染器的哈希映射.	ListBase
		unscaledHeight : Number [只读 (read-only)] 用于确定组件的未缩放高度的简便方法。	UIComponent
		unscaledWidth : Number [只读 (read-only)] 用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成，还应将此宽度作为参数传递到 updateDisplayList() 中。	UIComponent
		verticalScrollBar : ScrollBar 垂直滚动条。	ScrollControlBase
		visibleData : Object [只读 (read-only)] 视图中当前使用的数据提供程序项目渲染器的哈希表。	ListBase
		wordWrapChanged : Boolean = false 一个标志，指示自上次更新显示列表后 wordWrap 属性值是否已更改。	ListBase

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		List() 构造函数。	List
		addChild(child:DisplayObject):DisplayObject 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。	DisplayObjectContainer
		addDataEffectItem(target:Object):void 如果正在运行数据更改效果，则添加项目渲染器。	ListBase
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 指示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。	DisplayObjectContainer
		calculateDropIndex(event:DragEvent = null):int 返回将放置项目添加到放置目标中的位置的索引。	ListBase
		callLater(method:Function, args:Array = null):void 排队稍后调用的函数。	UIComponent
		clearStyle(styleProp:String):void 删除此组件实例中的样式属性。	UIComponent
		contains(child:DisplayObject):Boolean 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。	DisplayObjectContainer
		contentToGlobal(point:Point):Point 将 Point 对象由内容坐标转换为全局坐标。	UIComponent
		contentToLocal(point:Point):Point 将 Point 对象由内容坐标转换为本地坐标。	UIComponent
		createAutomationIDPart(child:IAutomationObject):Object 返回标识此容器中的子项的一组属性。	UIComponent
		createItemEditor(colIndex:int, rowIndex:int):void 使用由 itemEditor 属性指定的编辑器在 editedItemPosition 为项目渲染器创建项目编辑器。	List
		createItemRenderer(data:Object):IListItemRenderer 获取适当的渲染器，如果未指定渲染器，则使用默认渲染器。	List
		createReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void 在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。	UIComponent
		deleteReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void 在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。	UIComponent
		destroyItemEditor():void 关闭当前在某个项目上打开的项目编辑器。	List
		determineTextFormatFromStyles():UITextFormat 返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。	UIComponent
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	UIComponent
		drawFocus(isFocused:Boolean):void 在此组件周围显示或隐藏焦点指示符。	UIComponent
		drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void 通过编程方式在此外观的 Graphics 对象中绘制一个矩形。	UIComponent
		effectFinished(effectInst:IEffectInstance):void 停止在组件上播放效果实例时，由效果实例调用。	UIComponent
		effectStarted(effectInst:IEffectInstance):void 开始在组件上播放效果实例时，由效果实例调用。	UIComponent
		endEffectsStarted():void 结束组件上当前播放的所有效果。	UIComponent
		executeBindings(recurse:Boolean = false):void 将数据绑定到此 UIComponent 对象。	UIComponent
		findString(str:String):Boolean 根据 String 查找列表中的项目，并将所选内容移至该项目。	ListBase
		finishPrint(obj:Object, target:IFlexDisplayObject):void 打印完成后调用。	UIComponent
		getAutomationChildAt(index:int):IAutomationObject 在指定的索引位置提供自动化对象。	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。	DisplayObject
		getChildAt(index:int):DisplayObject 返回位于指定索引处的子显示对象实例。	DisplayObjectContainer
		getChildByName(name:String):DisplayObject 返回具有指定名称的子显示对象。	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int 返回 DisplayObject 的 child 实例的索引位置。	DisplayObjectContainer
		getClassStyleDeclarations():Array 查找此 UIComponent 实例的类型选择器。	UIComponent
		getConstraintValue(constraintName:String):* 返回一个约束布局值，这与获取此组件的约束样式的方式类似。	UIComponent
		getExplicitOrMeasuredHeight():Number 确定是使用显式高度还是测量高度的一种简便方法	UIComponent
		getExplicitOrMeasuredWidth():Number 确定是使用显式宽度还是测量宽度的一种简便方法	UIComponent
		getFocus():InteractiveObject 获取当前具有焦点的对象。	UIComponent
		getItemRendererFactory(data:Object):IFactory 返回相应的工厂；如果尚未指定，则使用默认工厂。	ListBase
		getObjectsUnderPoint(point:Point):Array 返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。	DisplayObject
		getRendererSemanticValue(target:Object, semanticProperty:String):Object 返回 true 或 false 以指示是否应在目标上播放效果。	ListBase
		getRepeaterItem(whichRepeater:int = -1):Object 返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目；如果此 Repeater 未重复，则返回 null。	UIComponent
		getStyle(styleProp:String):* 获取已在此组件的样式查找链中的某个位置设置过的样式属性。	UIComponent
		globalToContent(point:Point):Point 将 Point 对象由全局坐标转换为内容坐标。	UIComponent
		globalToLocal(point:Point):Point 将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。	DisplayObject
		globalToLocal3D(point:Point):Vector3D 将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。	DisplayObject
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		hideDropFeedback(event:DragEvent):void 在鼠标指针下方隐藏指示允许执行拖放操作的放置指示符。	ListBase
		hitTestObject(obj:DisplayObject):Boolean 计算显示对象，以确定它是否与 obj 显示对象重叠或相交。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。	DisplayObject
		horizontalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix 返回一个框 Matrix，在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。	UIComponent
		indexToItemRenderer(index:int):IListItemRenderer 针对数据提供程序中某个项目的索引获取项目渲染器（如果存在）。	ListBase
		indicesToIndex(rowIndex:int, colIndex:int):int 计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。	ListBase
		initialize():void 初始化此组件的内部结构。	UIComponent
		initializeRepeaterArrays(parent:IRepeaterClient):void 初始化用于跟踪此组件的重复实例的各个属性。	UIComponent
		invalidateDisplayList():void 标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。	UIComponent
		invalidateList():void 在下次更新时刷新所有行。	ListBase
		invalidateProperties():void 标记组件，以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。	UIComponent
		invalidateSize():void 标记组件，以便在稍后屏幕更新期间调用该组件的 measure() 方法。	UIComponent
		isItemEditable(data:Object):Boolean 确定数据提供程序项目的项目渲染器是否可编辑。	List
		isItemHighlighted(data:Object):Boolean 确定是否加亮显示数据提供者项目的项目渲染器（当鼠标滑过它，或者通过键盘导航使它位于尖号下方时）。	ListBase
		isItemSelectable(data:Object):Boolean 确定数据提供程序项目的项目渲染器是否可选。	ListBase
		isItemSelected(data:Object):Boolean 确定是否已选中数据提供程序项目的项目渲染器。	ListBase
		isItemVisible(item:Object):Boolean 确定渲染器是否显示某个项目。	ListBase
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		itemRendererContains(renderer:IListItemRenderer, object:DisplayObject):Boolean 确定渲染器是否包含（或拥有）显示对象。	ListBase
		itemRendererToIndex(itemRenderer:IListItemRenderer):int 返回通过此项目渲染器呈现的该项目在数据提供程序中的项目索引。	ListBase
		itemToDataTip(data:Object):String 返回渲染器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。	ListBase
		itemToIcon(data:Object):Class 根据 iconField 和 iconFunction 属性返回表示数据项目图标的类（如果存在）。	ListBase
		itemToItemRenderer(item:Object):IListItemRenderer 返回数据提供程序中给定项目的项目渲染器（如果存在）。	ListBase
		itemToLabel(data:Object):String 返回渲染器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。	ListBase
		local3DToGlobal(point3d:Vector3D):Point 将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。	DisplayObject
		localToContent(point:Point):Point 将 Point 对象由本地坐标转换为内容坐标。	UIComponent
		localToGlobal(point:Point):Point 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。	DisplayObject
		measureHeightOfItems(index:int = -1, count:int = 0):Number 使用当前项目渲染器测量数据提供程序中的一组项目，并返回这些项目的高度之和。	ListBase
		measureHTMLText(htmlText:String):TextLineMetrics 测量指定的 HTML 文本（该文本中可能包含 <font> 和 <b> 等 HTML 标记），假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。	UIComponent
		measureText(text:String):TextLineMetrics 测量指定的文本，假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。	UIComponent
		measureWidthOfItems(index:int = -1, count:int = 0):Number 使用当前项目渲染器测量数据提供程序中的一组项目，并返回找到的最大宽度。	ListBase
		move(x:Number, y:Number):void 将组件移动到其父项内的指定位置。	UIComponent
		notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void 将样式更改传播到子项。	UIComponent
		owns(child:DisplayObject):Boolean 如果 owner 属性链从 child 指向此 UIComponent，则返回 true。	UIComponent
		parentChanged(p:DisplayObjectContainer):void 当在父项中添加或删除 UIComponent 对象时由 Flex 调用。	UIComponent
		prepareToPrint(target:IFlexDisplayObject):Object 准备 IFlexDisplayObject 用于打印。	UIComponent
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		regenerateStyleCache(recursive:Boolean):void 为此组件构建或重新构建 CSS 样式缓存；如果 recursive 参数为 true，还会为此组件的所有后代执行同样的操作。	UIComponent
		registerEffects(effects:Array):void 针对每个效果事件，将 EffectManager 注册为一个事件侦听器。	UIComponent
		removeChild(child:DisplayObject):DisplayObject 从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject 从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。	DisplayObjectContainer
		removeDataEffectItem(target:Object):void 如果正在运行数据更改效果，则移除项目渲染器。	ListBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		replayAutomatableEvent(event:Event):Boolean 重放指定的事件。	UIComponent
		resolveAutomationIDPart(criteria:Object):Array 使用提供的 ID 解析子项。	UIComponent
		resumeBackgroundProcessing():void [静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。	UIComponent
		scrollToIndex(index:int):Boolean 确保给定索引处的数据提供程序项目可见。	ListBase
		setActualSize(w:Number, h:Number):void 调整对象大小。	UIComponent
		setChildIndex(child:DisplayObject, index:int):void 更改现有子项在显示对象容器中的位置。	DisplayObjectContainer
		setConstraintValue(constraintName:String, value:*):void 设置一个布局约束值的方式，与设置此组件的约束样式的方式相同。	UIComponent
		setCurrentState(stateName:String, playTransition:Boolean = true):void 设置当前状态。	UIComponent
		setFocus():void 设置此组件的焦点。	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setStyle(styleProp:String, newValue:*):void 对此组件实例设置样式属性。	UIComponent
		setVisible(value:Boolean, noEvent:Boolean = false):void 当 visible 属性发生更改时调用。	UIComponent
		showDropFeedback(event:DragEvent):void 在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。	ListBase
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void 允许用户拖动指定的 Sprite。	Sprite
		stopDrag():void 结束 startDrag() 方法。	Sprite
		styleChanged(styleProp:String):void 检测对样式属性的更改。	UIComponent
		stylesInitialized():void 首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。	UIComponent
		suspendBackgroundProcessing():void [静态] 阻止对使用 callLater() 排队的方法进行背景处理，直到调用 resumeBackgroundProcessing() 为止。	UIComponent
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 交换两个指定子对象的 Z 轴顺序（从前到后顺序）。	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。	DisplayObjectContainer
		toString():String 返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。	FlexSprite
		unconstrainRenderer(item:Object):void 如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外，则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。	ListBase
		validateDisplayList():void 验证子项的位置和大小，并绘制其它可视内容。	UIComponent
		validateNow():void 验证并更新此对象的属性和布局，如果需要的话重绘对象。	UIComponent
		validateProperties():void 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。	UIComponent
		validateSize(recursive:Boolean = false):void 如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法，随后在测量时调用了 validateSize() 方法，则验证组件的度量大小。	UIComponent
		validationResultHandler(event:ValidationResultEvent):void 处理分配给此组件的验证程序调度的 valid 和 invalid 事件。	UIComponent
		valueOf():Object 返回指定对象的原始值。	Object
		verticalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix 返回一个框 Matrix，在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。	UIComponent
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

显示继承的受保护方法

	方法		定义方
		addDragData(ds:Object):void 作为拖放操作的一部分，将所选项目添加到 DragSource 对象。	ListBase
		addToFreeItemRenderers(item:IListItemRenderer):void 将渲染器添加到循环使用的渲染器列表，使其不可见并清除对该渲染器的引用。	ListBase
		addToRowArrays():void 从用于存储对行的引用的数组开头添加一个空白行.	ListBase
		adjustFocusRect(obj:DisplayObject = null):void 调整焦点矩形。	UIComponent
		adjustListContent(unscaledWidth:Number = -1, unscaledHeight:Number = -1):void 从 updateDisplayList() 方法中调用，用以调整 listContent 的大小和位置。	ListBase
		applySelectionEffect(indicator:Sprite, uid:String, itemRenderer:IListItemRenderer):void 设置应用选择指示符的效果。	ListBase
		attachOverlay():void 这是一个内部方法，供 Flex 框架用于支持 Dissolve 效果。	UIComponent
		calculateDropIndicatorY(rowCount:Number, rowNum:int):Number 在执行拖放操作时计算放置指示符的 y 位置。	ListBase
		childrenCreated():void 创建子对象后执行任何最终处理。	UIComponent
		clearCaretIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void 清除给定 Sprite 中的尖号指示符。.	ListBase
		clearHighlightIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void 清除给定 Sprite 中的加亮指示符.	ListBase
		clearIndicators():void 删除所有选定、加亮显示和尖号指示符。	ListBase
		clearSelected(transition:Boolean = false):void 清除所选项目组，并移除表示那些项目的选定状态的所有图形。	ListBase
		clearVisibleData():void 清空 visibleData 哈希表.	ListBase
		collectionChangeHandler(event:Event):void 当数据发生更改时，处理从数据提供程序中调度的 CollectionEvent。	ListBase
		commitProperties():void 根据是否已显式设置 columnCountcolumnWidth、rowHeight 和 rowCount 等属性来计算列宽、行高以及行数和列数。	ListBase
		configureScrollBars():void 根据行数、列数以及可查看的行和列配置 ScrollBar。	ListBase
		copyItemWithUID(item:Object):Object 通过调用 ObjectUtil.copy() 方法为此对象制作一个深层副本，然后通过调用 UIDUtil.createUID() 方法用一个新值替代该副本的 uid 属性（如果存在）。	ListBase
		copySelectedItems(useDataField:Boolean = true):Array 按照选择时的顺序复制所选项目。	ListBase
		createBorder():void 为此组件创建边框。	ScrollControlBase
		createChildren():void 创建对象作为此 ListBase 的子对象，在这种情况下为将容纳所有项目渲染器的 listContent 对象。	ListBase
		createInFontContext(classObj:Class):Object 根据所用的嵌入字体使用上下文创建新对象。	UIComponent
		createInModuleContext(moduleFactory:IFlexModuleFactory, className:String):Object 使用给定的 moduleFactory 创建对象。	UIComponent
		destroyRow(i:int, numCols:int):void 循环使用不再需要的行，并删除其指示符。	ListBase
		dragCompleteHandler(event:DragEvent):void 处理 DragEvent.DRAG_COMPLETE 事件。	ListBase
		dragDropHandler(event:DragEvent):void 处理 DragEvent.DRAG_DROP 事件。	ListBase
		dragEnterHandler(event:DragEvent):void 处理 DragEvent.DRAG_ENTER 事件。	ListBase
		dragExitHandler(event:DragEvent):void 处理 DragEvent.DRAG_EXIT 事件。	ListBase
		dragOverHandler(event:DragEvent):void 处理 DragEvent.DRAG_OVER 事件。	ListBase
		dragScroll():void Interval 函数，用于在鼠标位于列表上方或下方时上下滚动列表。	ListBase
		dragStartHandler(event:DragEvent):void 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
		drawRowBackground(s:Sprite, rowIndex:int, y:Number, height:Number, color:uint, dataIndex:int):void 在指定的位置以指定高度绘制行背景。	List
		drawRowBackgrounds():void 绘制行中所有交替行的颜色、边框和背景。	ListBase
		drawSelectionIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void 使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制选择指示符。	ListBase
		endEdit(reason:String):Boolean 停止编辑数据提供程序中的项目。	List
		findKey(eventCode:int):Boolean 尝试在数据提供程序中查找下一个以 eventCode 参数中的字符开头的项目。	ListBase
		finishDataChangeEffect(event:EffectEvent):void 在数据更改效果运行完毕后，通过恢复原始集合和迭代器并移除此效果使用的所有缓存值进行清理。	ListBase
		finishKeySelection():void 基于 caretIndex 和 anchorIndex 属性设置所选项目。	ListBase
		focusInHandler(event:FocusEvent):void 当 UIComponent 对象获得焦点时调用的事件处理函数。	UIComponent
		focusOutHandler(event:FocusEvent):void 当 UIComponent 对象失去焦点时调用的事件处理函数。	UIComponent
		getReservedOrFreeItemRenderer(data:Object):IListItemRenderer 检索已创建但当前未使用的项目渲染器。	ListBase
		indexToColumn(index:int):int 给定索引处数据提供程序项目所在的列。	ListBase
		indexToRow(index:int):int 给定索引处数据提供程序项目所在的行。	ListBase
		initializationComplete():void 完成对此组件的初始化。	UIComponent
		initializeAccessibility():void 初始化此组件的辅助功能代码。	UIComponent
		initiateDataChangeEffect(unscaledWidth:Number, unscaledHeight:Number):void 当数据提供程序中发生更改时应用数据更改效果。	ListBase
		isOurFocus(target:DisplayObject):Boolean 通常由包含 UITextField 对象的组件覆盖，其中 UITextField 对象获取焦点。	UIComponent
		isRendererUnconstrained(item:Object):Boolean 如果项目渲染器不再根据列表的布局算法定位，则返回 true，尽管由于调用 unconstrainRenderer() 方法正在运行数据更改效果。	ListBase
		itemRendererToIndices(item:IListItemRenderer):Point 返回一个包含项目渲染器的 columnIndex 和 rowIndex 的点。	ListBase
		itemToUID(data:Object):String 确定数据提供程序项目的 UID。	ListBase
		keyDownHandler(event:KeyboardEvent):void 为 keyDown 事件调用的事件处理函数。	UIComponent
		keyUpHandler(event:KeyboardEvent):void 为 keyUp 事件调用的事件处理函数。	UIComponent
		layoutChrome(unscaledWidth:Number, unscaledHeight:Number):void 通过设置此控件边框的位置和大小来响应大小更改。	ScrollControlBase
		layoutEditor(x:int, y:int, w:int, h:int):void 在建议的位置使用建议的尺寸放置项目编辑器实例。	List
		makeListData(data:Object, uid:String, rowNum:int):BaseListData 创建新的 ListData 实例并根据输入数据提供程序项目填充字段。	List
		makeRowsAndColumns(left:Number, top:Number, right:Number, bottom:Number, firstColumn:int, firstRow:int, byCount:Boolean = false, rowsNeeded:uint = 0):Point 创建足够的行和列以填充左侧、顶部、右侧和底部描述的区域。	ListBase
		measure():void 根据 rowCount、columnCount、rowHeight 和 columnWidth 属性计算组件的度量宽度和高度。	ListBase
		mouseClickHandler(event:MouseEvent):void 处理列表中所有鼠标目标（包括渲染器）的 MouseEvent.MOUSE_CLICK 事件。	ListBase
		mouseDoubleClickHandler(event:MouseEvent):void 处理列表中所有鼠标目标（包括渲染器）的 MouseEvent.MOUSE_DOUBLE_CLICK 事件。	ListBase
		mouseDownHandler(event:MouseEvent):void 处理列表中所有鼠标目标（包括渲染器）的 MouseEvent.MOUSE_DOWN 事件。	ListBase
		mouseEventToItemRenderer(event:MouseEvent):IListItemRenderer 确定哪种项目渲染器位于鼠标下方。	ListBase
		mouseMoveHandler(event:MouseEvent):void 处理列表中所有鼠标目标（包括渲染器）的 MouseEvent.MOUSE_MOVE 事件。	ListBase
		mouseOutHandler(event:MouseEvent):void 处理列表中所有鼠标目标（包括渲染器）的 MouseEvent.MOUSE_OUT 事件。	ListBase
		mouseOverHandler(event:MouseEvent):void 处理列表中所有鼠标目标（包括渲染器）的 MouseEvent.MOUSE_OVER 事件。	ListBase
		mouseUpHandler(event:MouseEvent):void 处理列表中所有鼠标目标（包括渲染器）的 MouseEvent.MOUSE_DOWN 事件。	ListBase
		mouseWheelHandler(event:MouseEvent):void 通过更改滚动位置处理 mouseWheel 事件。	ListBase
		moveIndicatorsHorizontally(uid:String, moveBlockDistance:Number):void 水平移动所选项目并加亮指示符.	ListBase
		moveIndicatorsVertically(uid:String, moveBlockDistance:Number):void 垂直移动所选项目并加亮指示符.	ListBase
		moveRowVertically(i:int, numCols:int, moveBlockDistance:Number):void 垂直移动行，并更新 rowInfo 记录.	ListBase
		moveSelectionHorizontally(code:uint, shiftKey:Boolean, ctrlKey:Boolean):void 沿水平方向移动所选项目，以响应用户使用向左键或向右键以及功能键（如 Shift 和 Ctrl 键）选择项目的操作。	ListBase
		moveSelectionVertically(code:uint, shiftKey:Boolean, ctrlKey:Boolean):void 沿垂直方向移动所选项目，以响应用户使用向上键或向下键以及功能键（如 Shift 和 Ctrl 键）选择项目的操作。	ListBase
		prepareDataEffect(ce:CollectionEvent):void 准备集合事件的数据效果。	ListBase
		purgeItemRenderers():void 当渲染器发生更改时，updateDisplayList() 方法将调用此方法，用以删除现有的项目渲染器并清理各种缓存结构。	ListBase
		reKeyVisibleData():void 更新 visibleData 哈希表中的键.	ListBase
		removeFromRowArrays(i:int):void 从用于存储对行的引用的数组中删除一行.	ListBase
		removeIndicators(uid:String):void 清理数据提供程序中给定项目的选项亮显及其它关联图形。	ListBase
		resourcesChanged():void 构建 UIComponent 时将调用此方法，并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时，都会再次调用此方法。	UIComponent
		restoreRowArrays(modDeltaPos:int):void 从用于存储对行的引用的数组开头删除请求的行数.	ListBase
		roomForScrollBar(bar:ScrollBar, unscaledWidth:Number, unscaledHeight:Number):Boolean 确定此组件中的空间是否足以显示给定的滚动条。	ScrollControlBase
		scrollHandler(event:Event):void 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
		seekPendingFailureHandler(data:Object, info:ListBaseSeekPending):void 当由于页面错误而导致寻找失败时的默认故障处理函数。	ListBase
		seekPendingResultHandler(data:Object, info:ListBaseSeekPending):void 当由于页面错误而导致寻找失败时的默认结果处理函数。	ListBase
		seekPositionSafely(index:int):Boolean 搜寻位置，并在必要时处理 ItemPendingError。	ListBase
		selectItem(item:IListItemRenderer, shiftKey:Boolean, ctrlKey:Boolean, transition:Boolean = true):Boolean 如果使用鼠标单击提供的项目渲染器，并且键盘功能键处于给定状态，则更新所选项目组。	ListBase
		setRowCount(v:int):void 设置 rowCount 属性不会导致 invalidation，也不会设置将永久锁定行数的 explicitRowCount 属性。	ListBase
		setRowHeight(v:Number):void 设置 rowHeight 属性不会导致 invalidation，也不会设置将永久锁定行高的 explicitRowHeight。	ListBase
		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
		truncateRowArrays(numRows:int):void 从用于存储对行的引用的数组末端删除所有剩余行.	ListBase
		UIDToItemRenderer(uid:String):IListItemRenderer Find an item renderer based on its UID if it is visible.	ListBase
		updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void 当可显示的项目数发生更改时添加或移除项目渲染器。	ListBase
		updateList():void 刷新所有行。	ListBase

事件

隐藏继承的事件

显示继承的事件

	摘要	定义方
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
add	使用 addChild() 或 addChildAt() 方法将组件作为内容子项添加到容器时调度。	UIComponent
added	将显示对象添加到显示列表中时调度。	DisplayObject
addedToStage	在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。	DisplayObject
change	当用户操作导致 selectedIndex 或 selectedItem 属性更改时调度此事件。	ListBase
clear	当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。	InteractiveObject
click	用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。	InteractiveObject
contextMenu	当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。	InteractiveObject
copy	当用户激活特定于平台的复制操作的快捷键组合或从文本上下文菜单中选择“复制”时调度。	InteractiveObject
creationComplete	当组件完成其构建、属性处理、测量、布置和绘制时调度。	UIComponent
currentStateChange	视图状态更改后调度。	UIComponent
currentStateChanging	在 currentState 属性更改后但视图状态更改前调度。	UIComponent
cut	当用户激活特定于平台的剪切操作的快捷键组合或从文本上下文菜单中选择“剪切”时调度。	InteractiveObject
dataChange	当 data 属性更改时进行调度。	ListBase
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
doubleClick	如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true，当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。	InteractiveObject
dragComplete	在拖动操作完成时（将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时）由拖动启动器（作为要拖动的数据源的组件）调度。	UIComponent
dragDrop	用户在放置目标上释放鼠标时由放置目标调度。	UIComponent
dragEnter	当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时，由该组件调度。	UIComponent
dragExit	用户在组件外拖动但没有将数据放置到目标时，由组件调度。	UIComponent
dragOver	在拖动操作期间，当用户在鼠标位于组件上方的情况下移动鼠标时，由组件调度。	UIComponent
dragStart	启动拖动操作时，由拖动启动器调度。	UIComponent
effectEnd	在一个效果结束后调度。	UIComponent
effectStart	在即将开始播放效果前调度。	UIComponent
enterFrame	[播放事件] 播放头进入新帧时调度。	DisplayObject
enterState	组件返回到根视图状态之后调度。	UIComponent
exitFrame	[广播事件] 播放头退出当前帧时调度。	DisplayObject
exitState	组件退出根视图状态之前调度。	UIComponent
focusIn	显示对象获得焦点后调度。	InteractiveObject
focusOut	显示对象失去焦点后调度。	InteractiveObject
frameConstructed	[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。	DisplayObject
hide	当对象的状态从可见变为不可见时调度。	UIComponent
initialize	当组件完成构建并设置了所有初始化属性后调度。	UIComponent
invalid	当组件由 Validator 监控且未通过验证时调度。	UIComponent
itemClick	当用户单击控件中的某个项目时调度此事件。	ListBase
itemDoubleClick	当用户双击控件中的某个项目时调度此事件。	ListBase
itemEditBegin	当设置了 editedItemPosition 属性且项目可编辑时调度。	List
itemEditBeginning	当用户在某个项目上释放鼠标按键时、切换到 List 或 List 内部时，或通过任何其它方式尝试编辑项目时调度。	List
itemEditEnd	当项目编辑会话由于任何原因结束时调度。	List
itemFocusIn	当项目渲染器获得焦点时调度。在下列情况下项目渲染器可能获得焦点：当用户单击 List 控件中的某个项目或者使用键盘导航到该项目时。	List
itemFocusOut	当项目渲染器失去焦点时调度。在下列情况下项目渲染器可能会失去焦点：用户单击 List 控件中的其它项目或在列表外部单击时，或使用键盘导航到 List 控件中的其它项目或导航到 List 控件外部时。	List
itemRollOut	当用户将鼠标指针移出控件中的某个项目时调度此事件。	ListBase
itemRollOver	当用户将鼠标指针滚至控件中的某个项目时调度此方法。	ListBase
keyDown	用户按下某个键时调度。	InteractiveObject
keyFocusChange	用户尝试使用键盘导航更改焦点时调度。	InteractiveObject
keyUp	用户释放某个键时调度。	InteractiveObject
middleClick	当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。	InteractiveObject
middleMouseDown	当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。	InteractiveObject
middleMouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
mouseDown	当用户在 InteractiveObject 实例上按下指针设备按钮时调度。	InteractiveObject
mouseDownOutside	当用户在使用 PopUpManager 打开的某个组件外部单击时，从该组件调度。	UIComponent
mouseFocusChange	用户尝试使用指针设备更改焦点时调度。	InteractiveObject
mouseMove	用户移动 InteractiveObject 上的指针设备时调度。	InteractiveObject
mouseOut	用户将指针设备从 InteractiveObject 实例上移开时调度。	InteractiveObject
mouseOver	用户将指针设备移动到 InteractiveObject 实例上时调度。	InteractiveObject
mouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
mouseWheel	当鼠标滚轮滚动到 InteractiveObject 实例上时调度。	InteractiveObject
mouseWheelOutside	当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时，从该组件调度。	UIComponent
move	移动对象后调度。	UIComponent
nativeDragComplete	当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。	InteractiveObject
nativeDragDrop	在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。	InteractiveObject
nativeDragEnter	当拖动动作进入其边界时由 InteractiveObject 调度。	InteractiveObject
nativeDragExit	当拖动动作离开其边界时由 InteractiveObject 调度。	InteractiveObject
nativeDragOver	当拖动动作保持在其边界内时，由 InteractiveObject 持续调度。	InteractiveObject
nativeDragStart	在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。	InteractiveObject
nativeDragUpdate	在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。	InteractiveObject
paste	当用户激活特定于平台的粘贴操作的快捷键组合或从文本上下文菜单中选择“粘贴”时调度。	InteractiveObject
preinitialize	在组件初始化序列开始时调度。	UIComponent
remove	使用 removeChild() 或 removeChildAt() 方法将组件作为内容子项从容器中删除时调度。	UIComponent
removed	将要从显示列表中删除显示对象时调度。	DisplayObject
removedFromStage	在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。	DisplayObject
render	[广播事件] 将要更新和呈现显示列表时调度。	DisplayObject
resize	在调整组件大小时调度。	UIComponent
rightClick	当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。	InteractiveObject
rightMouseDown	当用户在 InteractiveObject 实例上按下指针设备按钮时调度。	InteractiveObject
rightMouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
rollOut	用户将指针设备从 InteractiveObject 实例上移开时调度。	InteractiveObject
rollOver	用户将指针设备移动到 InteractiveObject 实例上时调度。	InteractiveObject
scroll	当滚动内容时调度。	ScrollControlBase
selectAll	当用户激活特定于平台的全选操作的快捷键组合或从文本上下文菜单中选择“全选”时调度。	InteractiveObject
show	当对象的状态从不可见变为可见时调度。	UIComponent
tabChildrenChange	对象的 tabChildren 标志值发生更改时调度。	InteractiveObject
tabEnabledChange	对象的 tabEnabled 标志发生更改时调度。	InteractiveObject
tabIndexChange	对象的 tabIndex 属性值发生更改时调度。	InteractiveObject
toolTipCreate	要创建 ToolTip 时由组件调度。	UIComponent
toolTipEnd	已隐藏组件的 ToolTip 并要将其放弃时由组件调度。	UIComponent
toolTipHide	要隐藏组件的 ToolTip 时由组件调度。	UIComponent
toolTipShow	要显示组件的 ToolTip 时由组件调度。	UIComponent
toolTipShown	显示组件的 ToolTip 时由组件调度。	UIComponent
toolTipStart	用户将鼠标移动到设置了 toolTip 属性的组件上方后，由该组件调度。	UIComponent
updateComplete	当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度（如果需要）。	UIComponent
valid	当组件由 Validator 监控并且成功通过验证时调度。	UIComponent
valueCommit	当以编程方式或通过用户交互更改值时调度。	UIComponent

样式

隐藏继承的样式

显示继承的样式

	说明	定义方
alternatingItemColors	类型: Array 格式: Color CSS 继承: yes 列表中项目使用的背景色。此值是由两种或更多种颜色组成的数组。列表项目的背景色将从数组中的各种颜色之间选取。对于 DataGrid 控件，行中的所有项目都使用相同的背景色，而每行的背景色都由颜色数组确定。对于只使用一个列表填充二维显示的 TileList 控件，此样式可根据指定的列数、行数和颜色数生成棋盘外观、条纹或其它图案。TileList 循环使用各种颜色，根据布局方向设置各个项目的背景色。如果您的 TileList 为水平布局，并且颜色数和列数均为偶数，则显示条纹图案。如果列数为奇数，则显示棋盘图案。仅当未指定 `backgroundColor` 时才会生效。 .	ListBase
backgroundAlpha	类型: Number CSS 继承: no `backgroundColor` 属性定义的颜色和 `backgroundImage` 样式定义的图像或 SWF 文件的 Alpha 级别。有效值范围为从 0.	ScrollControlBase
backgroundColor	类型: uint 格式: Color CSS 继承: no 组件的背景颜色。您可以同时设置 `backgroundColor` 和 `backgroundImage`。一些组件没有背景。DataGrid 控件会忽略此样式。默认值为 `undefined`，即不进行设置。如果此样式和 `backgroundImage` 样式都为 `undefined`，则控件将采用透明背景。对于 Application 容器，此样式指定应用程序加载时的背景色以及运行该应用程序时的背景渐变。Flex 计算比指定颜色略深的颜色和比指定颜色略浅的颜色之间的渐变。大多数 Flex 控件的默认外观为半透明。因此，容器的背景颜色将在某种程度上“渗入”该容器中的控件。通过将控件的 `fillAlphas` 属性的 alpha 值设置为 1 可以避免此情况，如以下示例所示： <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ...	ScrollControlBase
backgroundDisabledColor	类型: uint 格式: Color CSS 继承: yes 禁用组件时的组件的背景颜色。全局默认值为 `undefined`。List 控件的默认值为 `0xDDDDDD`（浅灰）。如果禁用了容器，背景将变暗，而暗淡程度由 `disabledOverlayAlpha` 样式控制。.	ScrollControlBase
backgroundImage	类型: Object 格式: File CSS 继承: no 组件的背景图像。此样式可以是绝对或相对 URL 或类。您可以同时设置 `backgroundColor` 和 `backgroundImage`。背景图像显示在背景色上面。默认值为 `undefined`，表示“未设置”。如果此样式和 `backgroundColor` 样式都未定义，则控件将采用透明背景。大多数 Flex 控件的默认外观为半透明。因此，容器的背景图像将在某种程度上“渗入”该容器中的控件。通过将控件的 `fillAlphas` 属性的 alpha 值设置为 1 可以避免此情况，如以下示例所示： <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ...	ScrollControlBase
backgroundSize	类型: String CSS 继承: no 将 `backgroundImage` 指定的图像缩放到不同的百分比大小。`"100%"` 值将拉抻该图像以适应整个组件。要指定百分比值，您必须输入百分号 (%)。Application 容器的默认值为 `100%`。所有其它容器的默认值为 `auto`，此值将保持图像的原始大小。.	ScrollControlBase
baseline	类型: String CSS 继承: no 从内容区域的上边缘到控件的基线位置的垂直距离（以像素为单位）。如果设置此样式，则组件的基线锚定在其内容区域的上边缘；调整组件容器大小后，这两个边缘将保持它们的间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。 .	UIComponent
borderColor	类型: uint 格式: Color CSS 继承: no 边框颜色。默认值取决于组件类；如果没有覆盖该类的默认值，则默认值为 `0xB7BABC`。.	ScrollControlBase
borderSides	类型: String CSS 继承: no 边框边。指定要显示的边框边的以空格分隔的 String。此 String 可以任意顺序包含 `"left"`、`"top"`、`"right"` 和 `"bottom"`。默认值为 `"left top right bottom"`，此值会显示所有四条边。仅当 borderStyle 为 `"solid"` 时才使用此样式。.	ScrollControlBase
borderSkin	类型: Class CSS 继承: no 组件的边框外观类。mx.	ScrollControlBase
borderStyle	类型: String CSS 继承: no 边框样式。可能值为 `"none"`、`"solid"`、`"inset"` 和 `"outset"`。默认值取决于组件类；如果没有覆盖该类的默认值，则默认值为 `"inset"`。大多数容器的默认值为 `"none"`。.	ScrollControlBase
borderThickness	类型: Number 格式: Length CSS 继承: no 边框厚度。仅在将 `borderStyle` 设置为 `"solid"` 时使用。.	ScrollControlBase
bottom	类型: String CSS 继承: no 从组件的下边缘到其内容区域的下边缘的垂直距离（以像素为单位）。如果设置此样式，则组件的下边缘锚定在其内容区域的下边缘；调整组件容器大小后，这两个边缘将保持它们的间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。 .	UIComponent
color	类型: uint 格式: Color CSS 继承: yes 组件中文本（包括组件标签）的颜色。.	ScrollControlBase
cornerRadius	类型: Number 格式: Length CSS 继承: no 组件角的半径。默认值取决于组件类；如果未覆盖类的默认值，则默认值为 0。对于 ApplicationControlBar，默认值为 5。.	ScrollControlBase
disabledColor	类型: uint 格式: Color CSS 继承: yes 禁用时组件中文本的颜色。.	ScrollControlBase
dropIndicatorSkin	类型: Class CSS 继承: no 用于指示所拖动项目的放置位置的外观。如果拖放操作的目标位置可能是 ListBase-derived 组件，则调用 `showDropFeedback()` 方法将产生此类的实例，并将该实例定位在所放置项目之后项目的 itemRenderer 上方一个像素处（如果进行放置）。.	ListBase
dropShadowColor	类型: uint 格式: Color CSS 继承: yes 投影颜色。.	ScrollControlBase
dropShadowEnabled	类型: Boolean CSS 继承: no 指定组件是否具有可见投影的布尔值属性。此样式与 `borderStyle="solid"` 一起使用。默认值为 `false`。注意：对于显示在容器上的投影，需设置 `backgroundColor` 或 `backgroundImage` 属性。否则，由于容器的背景默认为透明，阴影将显示在容器后。 .	ScrollControlBase
errorColor	类型: uint 格式: Color CSS 继承: yes 验证失败时，组件加亮部分的颜色。验证失败时，Flex 还会将组件的 `borderColor` 样式设置为 `errorColor`。.	UIComponent
focusAlpha	类型: Number CSS 继承: no 指定焦点外观的 alpha 透明度值。.	ListBase
focusBlendMode	类型: String CSS 继承: no 焦点矩形使用的混合模式。有关详细信息，请参阅 flash.	UIComponent
focusRoundedCorners	类型: String CSS 继承: no 指定焦点矩形的哪些角应该是圆角。此值是使用空格分隔的 String，该 String 可以是 `"tl"`、`"tr"`、`"bl"` 和 `"br"` 的任意组合。例如，要指定右侧的角为圆角，左侧的角为直角，应使用 `"tr br"`。`cornerRadius` 样式属性指定圆角的半径。默认值取决于组件类；如果未覆盖该类的默认值，则默认值为 `"tl tr bl br"`。.	ListBase
focusSkin	类型: Class CSS 继承: no 用于绘制焦点矩形的外观。.	UIComponent
focusThickness	类型: Number 格式: Length CSS 继承: no 焦点矩形轮廓的粗细，以像素为单位。.	UIComponent
fontAntiAliasType	类型: String CSS 继承: yes 设置内部 TextField 的 `antiAliasType` 属性。可能值为 `"normal"` (`flash.`	ScrollControlBase
fontFamily	类型: String CSS 继承: yes 使用的字体的名称。与在完全 CSS 实现中不同，这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称，它将转换为相应的设备字体。.	ScrollControlBase
fontGridFitType	类型: String CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 `gridFitType` 属性。可能值为 `"none"` (`flash.`	ScrollControlBase
fontSharpness	类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 `sharpness` 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。仅当使用嵌入字体并将 `fontAntiAliasType` 属性设置为 `"advanced"` 时，才应用此属性。此样式对系统字体不起作用。此样式适用于 TextField 子控件中的所有文本；但不适用于部分字符。 .	ScrollControlBase
fontSize	类型: Number 格式: Length CSS 继承: yes 文本的高度，以像素为单位。除 ColorPicker 控件之外，所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。.	ScrollControlBase
fontStyle	类型: String CSS 继承: yes 确定文本是否使用斜体。可识别的值为 `"normal"` 和 `"italic"`。.	ScrollControlBase
fontThickness	类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 `thickness` 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。仅当使用嵌入字体并将 `fontAntiAliasType` 属性设置为 `"advanced"` 时，才应用此属性。此样式对系统字体不起作用。此样式适用于 TextField 子控件中的所有文本；但不适用于部分字符。 .	ScrollControlBase
fontWeight	类型: String CSS 继承: yes 确定文本是否使用粗体。可识别的值为 `normal` 和 `bold`。Button 控件的默认值为 `bold`。所有其它控件的默认值为 `normal`。.	ScrollControlBase
horizontalCenter	类型: String CSS 继承: no 从组件内容区域的中心到组件中心的水平距离（以像素为单位）。如果设置此样式，则组件的中心锚定在其内容区域的中心；调整组件容器大小后，这两个中心将保持它们的水平间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。 .	UIComponent
horizontalScrollBarStyleName	类型: String CSS 继承: no 水平 scrollbar 的样式名称。通过它，可以更精细地控制滚动条的外观。.	ScrollControlBase
kerning	类型: Boolean CSS 继承: yes 一个布尔值，指示是启用 (`true`) 还是禁用 (`false`) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性，并应只在必要时（例如使用大字体标题时）使用。仅嵌入字体支持字距调整。某些字体（如宋体）和等宽字体（如 Courier New）不支持字距调整。.	ScrollControlBase
leading	类型: Number 格式: Length CSS 继承: yes 文本行之间附加的垂直空间。默认值为 2。 ComboBox 控件的默认值为 0。 .	ScrollControlBase
left	类型: String CSS 继承: no 从组件内容区域的左边缘到组件左边缘的水平距离（以像素为单位）。如果设置此样式，则组件的左边缘锚定在其内容区域的左边缘；调整组件容器大小后，这两个边缘将保持它们的间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。 .	UIComponent
letterSpacing	类型: Number CSS 继承: yes 各字符之间显示的附加像素数。如果为正值，则会在正常间距的基础上增加字符间距；如果为负值，则减小此间距。.	ScrollControlBase
paddingBottom	类型: Number 格式: Length CSS 继承: no 行的底部与该行中渲染器底部之间的像素数目。.	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 行的顶部与该行中渲染器顶部之间的像素数目。.	ListBase
right	类型: String CSS 继承: no 从组件的右边缘到其内容区域的右边缘的水平距离（以像素为单位）。如果设置此样式，则组件的右边缘锚定在其内容区域的右边缘；调整组件容器大小后，这两个边缘将保持它们的间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。 .	UIComponent
rollOverColor	类型: uint 格式: Color CSS 继承: yes 用户滚过鼠标时渲染器的背景色。.	ListBase
selectionColor	类型: uint 格式: Color CSS 继承: yes 用户选中此组件时渲染器的背景色。.	ListBase
selectionDisabledColor	类型: uint 格式: Color CSS 继承: yes 禁用此组件时渲染器的背景色。.	ListBase
selectionDuration	类型: Number 格式: Time CSS 继承: no 选择效果的持续时间。如果选中了某个项目，则在背景着色时会播放相应的效果。设置为 0 可禁用此效果。.	ListBase
selectionEasingFunction	类型: Function CSS 继承: no 针对选项效果的 easingFunction。如果选中了某个项目，则在背景着色时会播放相应的效果。默认效果为颜色的线性淡入淡出。easingFunction 可用于控制选择效果。.	ListBase
shadowDirection	类型: String CSS 继承: no 投影方向。可能值包括 `"left"`、`"center"` 和 `"right"`。.	ScrollControlBase
shadowDistance	类型: Number 格式: Length CSS 继承: no 投影距离。如果将此属性设置为负值，此阴影将出现在组件的上方。.	ScrollControlBase
textAlign	类型: String CSS 继承: yes 容器内文本的对齐情况。可能值有：`"left"`、`"right"` 或 `"center"`。大多数组件的默认值为 `"left"`。对于 FormItem 组件，默认值为 `"right"`。对于 Button、LinkButton 和 AccordionHeader 组件，默认值为 `"center"`，且仅当将 `labelPlacement` 属性设置为 `"left"` 或 `"right"` 时，才能识别此属性。如果将 `labelPlacement` 设置为 `"top"` 或 `"bottom"`，将居中文本及所有图标。 .	ScrollControlBase
textDecoration	类型: String CSS 继承: yes 确定文本是否加下划线。可能值有：`"none"` 和 `"underline"`。.	ScrollControlBase
textIndent	类型: Number 格式: Length CSS 继承: yes 文本第一行偏离容器左侧的距离（以像素为单位）。.	ScrollControlBase
textRollOverColor	类型: uint 格式: Color CSS 继承: yes 用户滚过鼠标时渲染器文本的颜色。.	ListBase
textSelectedColor	类型: uint 格式: Color CSS 继承: yes 用户选中渲染器时其文本的颜色。.	ListBase
themeColor	类型: uint 格式: Color CSS 继承: yes 组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示，但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值，但首选值为 `haloGreen`、`haloBlue`、`haloOrange` 和 `haloSilver`。 `rollOverColor` 和 `selectionColor` 样式的默认值基于 `themeColor` 值。 .	UIComponent
top	类型: String CSS 继承: no 从控件内容区域的上边缘到组件上边缘的垂直距离（以像素为单位）。如果设置此样式，则组件的上边缘锚定在其内容区域的上边缘；调整其容器大小后，这两个边缘将保持其间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。 .	UIComponent
useRollOver	类型: Boolean CSS 继承: no 一个标志，控制当鼠标滚过项目时是否加亮显示该项目。如果为 `true`，则当鼠标滚过行时加亮显示这些行。如果为 `false`，则只在选中行时才进行加亮显示。.	ListBase
verticalAlign	类型: String CSS 继承: no 垂直对齐行中的渲染器。可能值包括 `"top"`、`"middle"` 和 `"bottom"`。DataGrid 根据此样式以及 `paddingTop` 和 `paddingBottom` 样式在行中定位渲染器。如果某一行上各列中项目的高度不等，则其它列表类不使用 `verticalAlign`，但项目渲染器可以检查此样式属性，并根据检查结果调整其布局。.	ListBase
verticalCenter	类型: String CSS 继承: no 从组件内容区域的中心到组件中心的垂直距离（以像素为单位）。如果设置此样式，则组件的中心锚定在其内容区域的中心；调整其容器大小后，这两个中心将保持其垂直间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。 .	UIComponent
verticalScrollBarStyleName	类型: String CSS 继承: no 垂直 scrollbar 的样式名称。通过它，可以更精细地控制滚动条的外观。.	ScrollControlBase

说明	定义方
addedEffect	触发事件: added 将组件作为子项添加到 Container 时播放。	UIComponent
creationCompleteEffect	触发事件: creationComplete 创建组件时播放。	UIComponent
focusInEffect	触发事件: focusIn 组件获得键盘焦点时播放。	UIComponent
focusOutEffect	触发事件: focusOut 组件失去键盘焦点时播放。	UIComponent
hideEffect	触发事件: hide 组件变为不可见时播放。	UIComponent
itemsChangeEffect	触发事件: itemsChange 当控件的数据提供程序发生更改时播放的数据效果。默认情况下，List 控件不使用数据效果。对于 List 控件，将使用 DefaultListEffect 类的实例配置数据效果。	List
mouseDownEffect	触发事件: mouseDown 用户在组件上方按下鼠标按键时播放。	UIComponent
mouseUpEffect	触发事件: mouseUp 用户在组件上方释放鼠标按键时播放。	UIComponent
moveEffect	触发事件: move 移动组件时播放。	UIComponent
removedEffect	触发事件: removed 从 Container 中删除组件时播放。	UIComponent
resizeEffect	触发事件: resize 调整组件大小时播放。	UIComponent
rollOutEffect	触发事件: rollOut 用户将鼠标指针滚离组件上方时播放。	UIComponent
rollOverEffect	触发事件: rollOver 用户将鼠标指针滚动到组件上方时播放。	UIComponent
showEffect	触发事件: show 组件变为可见时播放。	UIComponent

	常量	定义方
		DEFAULT_MAX_HEIGHT : Number = 10000 [静态] maxHeight 属性的默认值。	UIComponent
		DEFAULT_MAX_WIDTH : Number = 10000 [静态] maxWidth 属性的默认值。	UIComponent
		DEFAULT_MEASURED_HEIGHT : Number = 22 [静态] measuredHeight 属性的默认值。	UIComponent
		DEFAULT_MEASURED_MIN_HEIGHT : Number = 22 [静态] measuredMinHeight 属性的默认值。	UIComponent
		DEFAULT_MEASURED_MIN_WIDTH : Number = 40 [静态] measuredMinWidth 属性的默认值。	UIComponent
		DEFAULT_MEASURED_WIDTH : Number = 160 [静态] measuredWidth 属性的默认值。	UIComponent

属性详细信息

editable

属性

public var editable:Boolean = false

一个标志，指示用户能否编辑数据提供程序中的项目。如果为 true，则控件中的项目渲染器可编辑。用户单击项目渲染器将可以打开一个编辑器。

默认值为 false.

editedItemPosition

属性

editedItemPosition:Object [读写]

正在编辑的数据提供程序项目的项目渲染器的列索引和行索引（如果有）。

此 Object 包含 columnIndex 和 rowIndex 这两个字段，分别是项目的从零开始的列索引和项目索引。对于 List 控件，columnIndex 属性始终为 0；例如：{columnIndex:0, rowIndex:3}。

设置此属性会将项目滚动到视图中，并会调度 itemEditBegin 事件以打开指定项目上的项目编辑器。

此属性可用作数据绑定的源。修改此属性后，将调度 itemFocusIn 事件。

实现
public function get editedItemPosition():Object
public function set editedItemPosition(value:Object):void

editedItemRenderer

属性

editedItemRenderer:IListItemRenderer [只读 (read-only)]

对当前正在编辑的项目所属的 DataGrid 控件中项目渲染器的引用。

在 itemEditBegin 和 itemEditEnd 事件的事件侦听器中，您可以使用 editedItemRenderer.data 属性访问所编辑的项目的当前值。

实现
public function get editedItemRenderer():IListItemRenderer

editorDataField

属性

public var editorDataField:String = "text"

项目编辑器的属性名称，其中包含列表项目的新数据。例如，默认的 itemEditor 为 TextInput，因此 editorDataField 属性的默认值为 "text"，它指定了 TextInput 控件的 text 属性。

editorHeightOffset

属性

public var editorHeightOffset:Number = 0

项目编辑器相对于项目渲染器大小的高度（以像素为单位）。使用此属性可以使编辑器与项目渲染器产生几个像素的重叠，以补偿编辑器周围的边框。

在显示编辑器的同时更改这些值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项目渲染器。

默认值为 0.

editorUsesEnterKey

属性

public var editorUsesEnterKey:Boolean = false

指示项目编辑器是否使用 Enter 键的标志。如果将此属性设置为 true，则项目编辑器将使用 Enter 键，并且 List 不会查找 Enter 键并移动编辑器进行响应。

在显示编辑器的同时更改此值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项目渲染器。

默认值为 false.

editorWidthOffset

属性

public var editorWidthOffset:Number = 0

项目编辑器相对于项目渲染器大小的宽度（以像素为单位）。使用此属性可以使编辑器与项目渲染器产生几个像素的重叠，以补偿编辑器周围的边框。

在显示编辑器的同时更改这些值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项目渲染器。

默认值为 0.

editorXOffset

属性

public var editorXOffset:Number = 0

项目编辑器左上角相对于项目左上角的 x 位置（以像素为单位）。使用此属性可以使编辑器与项目渲染器产生几个像素的重叠，以补偿编辑器周围的边框。

在显示编辑器的同时更改这些值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项目渲染器。

默认值为 0.

editorYOffset

属性

public var editorYOffset:Number = 0

项目编辑器左上角相对于项目左上角的 y 位置（以像素为单位）。使用此属性可以使编辑器与项目渲染器产生几个像素的重叠，以补偿编辑器周围的边框。

在显示编辑器的同时更改这些值对当前编辑器没有任何影响，但会影响下一个打开编辑器的项目渲染器。

默认值为 0.

imeMode

属性

imeMode:String [读写]

指定 IME（输入法编辑器）模式。IME 使用户能够用中文、日文和韩文输入文本。Flex 在该控件获得焦点时设置指定的 IME 模式，并在该控件丢失焦点时将其设置回先前的值。

flash.system.IMEConversionMode 类定义此属性的有效值的常量。您还可以指定 null 不指定任何 IME 模式。

默认值为 null.

实现
public function get imeMode():String
public function set imeMode(value:String):void

另请参见

flash.system.IME
flash.system.IMEConversionMode

itemEditor

属性

public var itemEditor:IFactory

如果将 editable 属性设置为 true，则为用于控件的项目编辑器的类工厂。

默认值为 new ClassFactory(mx.controls.TextInput).

另请参见

Setting the itemRenderer or itemEditor property in ActionScript

itemEditorInstance

属性

public var itemEditorInstance:IListItemRenderer

对项目编辑器的当前活动实例（如果有）的引用。

若要在编辑项目时访问项目编辑器实例和新项目值，则应使用 itemEditorInstance 属性。只有在执行 itemEditBegin 事件的事件侦听器之后，itemEditorInstance 属性才有效。因此，您通常只从 itemEditEnd 事件的事件侦听器中访问 itemEditorInstance 属性。

itemEditor 属性定义项目编辑器的类，从而定义项目编辑器实例的数据类型。

不要以 MXML 方式设置此属性。

measuringObjects

属性

protected var measuringObjects:Dictionary

工厂设置的度量对象的缓存

rendererIsEditor

属性

public var rendererIsEditor:Boolean = false

指定项目渲染器是否同时也是项目编辑器。如果此属性为 true，Flex 将忽略 itemEditor 属性。

默认值为 false.

构造函数详细信息

List

()

构造函数

public function List()

构造函数。

方法详细信息

createItemEditor

()

方法

public function createItemEditor(colIndex:int, rowIndex:int):void

使用由 itemEditor 属性指定的编辑器在 editedItemPosition 为项目渲染器创建项目编辑器。

此方法将编辑器实例设置为 itemEditorInstance 属性。

您只能从 itemEditBegin 事件的事件侦听器中调用此方法。若要在其它时间创建编辑器，请设置 editedItemPosition 属性以生成 itemEditBegin 事件。

参数

	`colIndex:int` — 列索引。对于 List 控件，Flex 将此属性的值设置为 0。

	`rowIndex:int` — 要编辑的项目的数据提供程序中的索引。

createItemRenderer

()

方法

override public function createItemRenderer(data:Object):IListItemRenderer

获取适当的渲染器，如果未指定渲染器，则使用默认渲染器。

参数

data:Object — 从中创建项目渲染器的对象。

IListItemRenderer — 渲染器。

destroyItemEditor

()

方法

public function destroyItemEditor():void

关闭当前在某个项目上打开的项目编辑器。通常，只能从 itemEditEnd 事件的事件侦听器中调用此方法，但在这之前需要调用 preventDefault() 方法阻止执行默认的事件侦听器。

drawRowBackground

()

方法

protected function drawRowBackground(s:Sprite, rowIndex:int, y:Number, height:Number, color:uint, dataIndex:int):void

在指定的位置以指定高度绘制行背景。这样，将创建一个 Shape 作为输入 Sprite 的子项，并使用相应的颜色对其进行填充。此方法还使用 backgroundAlpha 样式属性设置来确定背景颜色的透明度。

参数

	`s:Sprite` — 一个 Sprite，其中的显示对象包含该行的图形。

	`rowIndex:int` — 行在所显示的一组行中的索引。最顶端可见行（不包括标题）的行索引为 0。此索引用于跟踪绘制背景所使用的对象，以便某一特定行能够重新使用同一显示对象，即使该行呈现的项目的索引发生了更改时也是如此。

	`y:Number` — 建议的背景 y 位置。

	`height:Number` — 建议的指示符高度。

	`color:uint` — 建议的指示符颜色。

	`dataIndex:int` — 数据提供程序中该行的项目的索引。例如，这可用于为第 10 个项目设置不同的颜色。

endEdit

()

方法

protected function endEdit(reason:String):Boolean

停止编辑数据提供程序中的项目。当用户完成项目编辑后，控件将调用此方法。它将调度 itemEditEnd 事件以启动以下过程：将编辑的数据从 itemEditorInstance 复制到数据提供程序，并隐藏 itemEditorInstance。

参数

reason:String — 定义事件原因的常数（例如“CANCELLED”、“NEW_ROW”或“OTHER”）。该值必须是 ListEventReason 类的成员。

Boolean — 如果没有调用 preventDefault()，则返回 true。否则为 false。

另请参见

mx.events.ListEventReason

isItemEditable

()

方法

public function isItemEditable(data:Object):Boolean

确定数据提供程序项目的项目渲染器是否可编辑。

参数

data:Object — 数据提供程序项目

Boolean — 如果项目可编辑，则为 true。

layoutEditor

()

方法

protected function layoutEditor(x:int, y:int, w:int, h:int):void

在建议的位置使用建议的尺寸放置项目编辑器实例。Tree 控件将覆盖此方法并调整位置以补偿渲染器的缩进。

参数

	`x:int` — 建议的指示符 x 位置。

	`y:int` — 建议的指示符 y 位置。

	`w:int` — 建议的指示符宽度。

	`h:int` — 建议的指示符高度。

makeListData

()

方法

protected function makeListData(data:Object, uid:String, rowNum:int):BaseListData

创建新的 ListData 实例并根据输入数据提供程序项目填充字段。

参数

	`data:Object` — 用于填充 ListData 的数据提供程序项目。

	`uid:String` — 该项目的 UID。

	`rowNum:int` — 数据提供程序中项目的索引。

BaseListData — 新构建的 ListData 对象。

事件详细信息

itemEditBegin

事件

事件对象类型: mx.events.ListEvent
属性 ListEvent.type = mx.events.ListEvent.ITEM_EDIT_BEGIN

当设置了 editedItemPosition 属性且项目可编辑时调度。

ListEvent.ITEM_EDIT_BEGIN 常数可为 itemEditBegin 事件定义事件对象的 type 属性的值，指示准备编辑的项目。

此事件的默认侦听器执行下列操作：

通过调用 createItemEditor() 方法来创建项目编辑器对象。
将 data 属性从项目复制到编辑器。默认情况下，项目编辑器对象是 TextInput 控件的实例。您可以使用 list 控件的 itemEditor 属性指定自定义项目编辑器类。
设置 list 控件的 itemEditorInstance 属性，以引用项目编辑器实例。

您可以为此事件编写事件侦听器以修改传递到项目编辑器的数据。例如，您可以修改项目编辑器使用的数据、数据格式或其它信息。

您还可以创建事件侦听器以指定用于编辑项目的项目编辑器。例如，您可能有两个不同的项目编辑器。在事件侦听器中，您可以通过执行下列操作检查要编辑的数据或其它信息，并打开相应的项目编辑器：

调用 preventDefault() 以阻止 Flex 在默认事件侦听器中调用 createItemEditor() 方法。
将 itemEditor 属性设置为相应编辑器。
调用 createItemEditor() 方法。

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

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	所编辑的项目的项目渲染器。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_EDIT_BEGIN

itemEditBeginning

事件

事件对象类型: mx.events.ListEvent
属性 ListEvent.type = mx.events.ListEvent.ITEM_EDIT_BEGINNING

当用户在某个项目上释放鼠标按键时、切换到 List 或 List 内部时，或通过任何其它方式尝试编辑项目时调度。

ListEvent.ITEM_EDIT_BEGINNING 常数可为 itemEditBeginning 事件定义 ListEvent 对象的 type 属性的值，指示用已户准备编辑某个项目，例如，通过在该项目上释放鼠标按键。

此事件的默认侦听器将 List.editedItemPosition 属性设置为具有焦点的项目，这可启动项目编辑会话。

您通常可以为此事件编写自己的事件侦听器，以禁止编辑特定项目。在为此事件自己编写的事件侦听器内调用 preventDefault() 方法可以阻止默认侦听器执行。

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

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	要编辑的项目的项目渲染器。如果此事件由键盘生成，则此属性为 null，因为要编辑的项目可能未在屏幕范围内显示。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_EDIT_BEGIN

itemEditEnd

事件

事件对象类型: mx.events.ListEvent
属性 ListEvent.type = mx.events.ListEvent.ITEM_EDIT_END

当项目编辑会话由于任何原因结束时调度。

ListEvent.ITEM_EDIT_END 常数可为 itemEditEnd 事件定义 ListEvent 对象的 type 属性值，指示编辑会话结束。

列表组件具有针对此事件的默认处理函数，此程序将数据从项目编辑器复制到 list 控件的数据提供程序。默认事件侦听器执行下列操作：

使用 list 控件的 editorDataField 属性来确定包含新数据的项目编辑器的属性，并使用这些新数据更新数据提供程序项目。因为默认项目编辑器是 TextInput 控件，所以 editorDataField 属性的默认值为 "text"，以指定 TextInput 的 text 属性包含新项目数据。
调用 destroyItemEditor() 方法以关闭项目编辑器。

通常，您可以为此事件编写事件侦听器，以执行下列操作：

在事件侦听器中，您可以修改编辑器为列表组件返回的数据。例如，您可以在将数据返回到 list 控件之前重新设置其格式。默认情况下，项目编辑器只可以返回一个值。如果希望返回多个值，必须为 itemEditEnd 事件编写事件侦听器。
在事件侦听器中，您可以检查项目编辑器中输入的数据。如果数据不正确，可以调用 preventDefault() 方法阻止 Flex 将新数据传递回 list 控件和关闭编辑器。

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

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	已编辑的项目的项目渲染器。
`reason`	定义事件原因的常量。该值必须是 `ListEventReson` 类的成员。
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_EDIT_END

itemFocusIn

事件

事件对象类型: mx.events.ListEvent
属性 ListEvent.type = mx.events.ListEvent.ITEM_FOCUS_IN

当项目渲染器获得焦点时调度。在下列情况下项目渲染器可能获得焦点：当用户单击 List 控件中的某个项目或者使用键盘导航到该项目时。仅当列表项目可编辑时调度。

ListEvent.ITEM_FOCUS_IN 常数可为 itemFocusIn 事件定义 ListEvent 对象的 type 属性的值，指示项目已获得焦点。

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

属性	值
`bubbles`	false
`cancelable`	true
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	所编辑的项目的项目编辑器实例。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_FOCUS_IN

itemFocusOut

事件

事件对象类型: mx.events.ListEvent
属性 ListEvent.type = mx.events.ListEvent.ITEM_FOCUS_OUT

当项目渲染器失去焦点时调度。在下列情况下项目渲染器可能会失去焦点：用户单击 List 控件中的其它项目或在列表外部单击时，或使用键盘导航到 List 控件中的其它项目或导航到 List 控件外部时。仅当列表项目可编辑时调度。

ListEvent.ITEM_FOCUS_OUT 常数可为 itemFocusOut 事件定义 ListEvent 对象的 type 属性的值，指示项目已失去焦点。

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

属性	值
`bubbles`	false
`cancelable`	false
`columnIndex`	与事件相关联的列的从零开始的索引。
`currentTarget`	用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`itemRenderer`	正在编辑的项目的项目编辑器实例。
`reason`	null
`rowIndex`	与事件相关联的项目的从零开始的索引。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`类型`	ListEvent.ITEM_FOCUS_OUT

示例如何使用示例

SimpleList.mxml

<?xml version="1.0"?>
<!-- Simple example to demonstrate the List Control -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        <![CDATA[
            [Bindable]
            public var selectedItem:Object;
       ]]>
    </mx:Script>


    <mx:Model id="mystates">
      <states>
        <state label="Alabama" data="AL"/>
        <state label="Alaska" data="AK"/>
        <state label="Arizona" data="AZ"/>
        <state label="Arkansas" data="AR"/>
        <state label="California" data="CA"/>
        <state label="Colorado" data="CO"/>
        <state label="Connecticut" data="CT"/>
      </states>
    </mx:Model>

    <mx:Panel title="List Control Example" height="75%" width="75%" 
        paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">

        <mx:Label text="Select a state to see its abbreviation."/>

        <mx:List id="source" width="100%" color="blue"
            dataProvider="{mystates.state}"
            change="this.selectedItem=List(event.target).selectedItem"/>

        <mx:VBox width="100%">
            <mx:Label text="Selected State: {selectedItem.label}"/>
            <mx:Label text="State abbreviation: {selectedItem.data}"/>
        </mx:VBox>

    </mx:Panel>
</mx:Application>

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
List	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例

包	mx.controls
类	public class List
继承	List ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
实现	IIMESupport
子类	FileSystemList, Menu, Tree