| 包 | mx.controls |
| 类 | public class HorizontalList |
| 继承 | HorizontalList  TileBase ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
HorizontalList 控件具有下列默认大小特征：
| 特征 | 说明 |
|---|---|
| 默认大小 | 四列，其大小取决于单元格尺寸。 |
| 最小大小 | 0 个像素。 |
| 最大大小 | 5000 × 5000。 |
隐藏 MXML 语法The <mx:HorizontalList> tag inherits all of the
tag attributes of its superclass and it adds no new tag attributes.
<mx:HorizontalList/>
默认 MXML 属性dataProvider
另请参见
| 方法 | 定义方 | ||
|---|---|---|---|
构造函数。 | HorizontalList | ||
 | 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
| 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
| 如果正在运行数据更改效果，则添加项目渲染器。 | ListBase | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
| 指示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
| 返回将放置项目添加到放置目标中的位置的索引。 | ListBase | |
| 排队稍后调用的函数。 | UIComponent | |
| 删除此组件实例中的样式属性。 | UIComponent | |
| 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
| 将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | |
| 将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | |
| 返回标识此容器中的子项的一组属性。 | UIComponent | |
| 获取适当的渲染器，如果未指定渲染器，则使用默认渲染器。 | TileBase | |
| 在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | |
| 在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | |
| 返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | |
| 将事件调度到事件流中。 | UIComponent | |
| 在此组件周围显示或隐藏焦点指示符。 | UIComponent | |
| drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void 通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | |
| 停止在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
| 开始在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
| 结束组件上当前播放的所有效果。 | UIComponent | |
| 将数据绑定到此 UIComponent 对象。 | UIComponent | |
| 根据 String 查找列表中的项目，并将所选内容移至该项目。 | ListBase | |
| 打印完成后调用。 | UIComponent | |
| 在指定的索引位置提供自动化对象。 | UIComponent | |
| 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
| 返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | |
| 返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
| 返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | |
| 查找此 UIComponent 实例的类型选择器。 | UIComponent | |
| 返回一个约束布局值，这与获取此组件的约束样式的方式类似。 | UIComponent | |
| 确定是使用显式高度还是测量高度的一种简便方法 | UIComponent | |
| 确定是使用显式宽度还是测量宽度的一种简便方法 | UIComponent | |
| 获取当前具有焦点的对象。 | UIComponent | |
| 返回相应的工厂；如果尚未指定，则使用默认工厂。 | ListBase | |
| 返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。 | DisplayObjectContainer | |
| 返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。 | DisplayObject | |
| 返回 true 或 false 以指示是否应在目标上播放效果。 | ListBase | |
| 返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目；如果此 Repeater 未重复，则返回 null。 | UIComponent | |
| 获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
| 将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | |
| 将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。 | DisplayObject | |
| 将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。 | DisplayObject | |
| 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
指示对象是否已经定义了指定的属性。 | Object | |
| 在鼠标指针下方隐藏指示允许执行拖放操作的放置指示符。 | ListBase | |
| 计算显示对象，以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | |
| 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
| 返回一个框 Matrix，在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | |
| 针对数据提供程序中某个项目的索引获取项目渲染器（如果存在）。 | ListBase | |
| 计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。 | ListBase | |
| 初始化此组件的内部结构。 | UIComponent | |
| 初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | |
| 标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
| 在下次更新时刷新所有行。 | ListBase | |
| 标记组件，以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
| 标记组件，以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
| 确定是否加亮显示数据提供者项目的项目渲染器（当鼠标滑过它，或者通过键盘导航使它位于尖号下方时）。 | ListBase | |
| 确定数据提供程序项目的项目渲染器是否可选。 | ListBase | |
| 确定是否已选中数据提供程序项目的项目渲染器。 | ListBase | |
| 确定渲染器是否显示某个项目。 | ListBase | |
|
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
| 确定渲染器是否包含（或拥有）显示对象。 | ListBase | |
| 返回通过此项目渲染器呈现的该项目在数据提供程序中的项目索引。 | ListBase | |
| 返回渲染器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。 | ListBase | |
| 根据 iconField 和 iconFunction 属性返回表示数据项目图标的类（如果存在）。 | ListBase | |
| 返回数据提供程序中给定项目的项目渲染器（如果存在）。 | ListBase | |
| 返回渲染器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。 | ListBase | |
| 将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。 | DisplayObject | |
| 将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | |
| 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。 | DisplayObject | |
| 使用当前项目渲染器测量数据提供程序中的一组项目，并返回这些项目的高度之和。 | ListBase | |
| 测量指定的 HTML 文本（该文本中可能包含 <font> 和 <b> 等 HTML 标记），假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。 | UIComponent | |
| 测量指定的文本，假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。 | UIComponent | |
| 使用当前项目渲染器测量数据提供程序中的一组项目，并返回找到的最大宽度。 | ListBase | |
| 将组件移动到其父项内的指定位置。 | UIComponent | |
| 将样式更改传播到子项。 | UIComponent | |
| 如果 owner 属性链从 child 指向此 UIComponent，则返回 true。 | UIComponent | |
| 当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | |
| 准备 IFlexDisplayObject 用于打印。 | UIComponent | |
|
指示指定的属性是否存在、是否可枚举。 | Object | |
| 为此组件构建或重新构建 CSS 样式缓存；如果 recursive 参数为 true，还会为此组件的所有后代执行同样的操作。 | UIComponent | |
| 针对每个效果事件，将 EffectManager 注册为一个事件侦听器。 | UIComponent | |
| 从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | |
| 从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | |
| 如果正在运行数据更改效果，则移除项目渲染器。 | ListBase | |
| 从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
| 重放指定的事件。 | UIComponent | |
| 使用提供的 ID 解析子项。 | UIComponent | |
| [静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
| 确保给定索引处的数据提供程序项目可见。 | ListBase | |
| 调整对象大小。 | UIComponent | |
| 更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | |
| 设置一个布局约束值的方式，与设置此组件的约束样式的方式相同。 | UIComponent | |
| 设置当前状态。 | UIComponent | |
| 设置此组件的焦点。 | UIComponent | |
|
设置循环操作动态属性的可用性。 | Object | |
| 对此组件实例设置样式属性。 | UIComponent | |
| 当 visible 属性发生更改时调用。 | UIComponent | |
| 在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。 | ListBase | |
| 允许用户拖动指定的 Sprite。 | Sprite | |
| 结束 startDrag() 方法。 | Sprite | |
| 检测对样式属性的更改。 | UIComponent | |
| 首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。 | UIComponent | |
| [静态] 阻止对使用 callLater() 排队的方法进行背景处理，直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
| 交换两个指定子对象的 Z 轴顺序（从前到后顺序）。 | DisplayObjectContainer | |
| 在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。 | DisplayObjectContainer | |
| 返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | |
| 如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外，则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。 | ListBase | |
| 验证子项的位置和大小，并绘制其它可视内容。 | UIComponent | |
| 验证并更新此对象的属性和布局，如果需要的话重绘对象。 | UIComponent | |
| 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | |
| 如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法，随后在测量时调用了 validateSize() 方法，则验证组件的度量大小。 | UIComponent | |
| 处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | |
|
返回指定对象的原始值。 | Object | |
| 返回一个框 Matrix，在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | |
| 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher | |
显示 MXML 语法