包 | mx.controls |
类 | public class TileList |
继承 | TileList TileBase ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
从 Flex 4.0 开始,Adobe 建议您使用 spark.components.List 类来替代此类。
Flex 3 中的布局特定 List 组件已替换为采用通用布局的一个更通用的 List 组件。要从新的 List 组件实现相似的行为,请将 |
TileList 控件将显示大量项目,它们以平铺形式布置。根据
direction
属性,在其中一个轴上显示滚动条以访问列表中的所有项目。您可以使用 rowHeight
和 columnWidth
属性设置平铺内容的大小。此外,Flex 会测量 dataProvider 中第一个项目的项呈示器,并对所有平铺内容应用此大小。
TileList 控件具有以下默认大小特征:
特征 | 说明 |
---|---|
默认大小 | 四列和四行。使用默认项呈示器,总大小为 66×126 像素。 |
最小大小 | 0 个像素。 |
最大大小 | 5000 × 5000。 |
The <mx:TileList>
tag inherits
all of the tag attributes of its superclass, but ignores the
variableRowHeight
and wordWrap
tag attributes.
It adds no additional tag attributes.
<mx:TileList/>
默认 MXML 属性dataProvider
受保护的属性
公共方法
方法 | 由以下参数定义 | ||
---|---|---|---|
TileList()
构造函数。 | TileList | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
如果正在运行数据更改效果,则添加项呈示器。 | ListBase | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
将非可视样式客户端添加到该组件实例。 | UIComponent | ||
表示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | ||
返回将放置项目添加到放置目标中的位置的索引。 | ListBase | ||
排队稍后调用的函数。 | UIComponent | ||
删除此组件实例的样式属性。 | UIComponent | ||
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | ||
将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | ||
将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
[覆盖]
获取适当的呈示器,如果未指定呈示器,则使用默认呈示器。 | TileBase | ||
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | ||
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | ||
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | ||
[覆盖]
将事件调度到事件流中。 | UIComponent | ||
在此组件周围显示或隐藏焦点指示符。 | UIComponent | ||
drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | ||
停止在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
开始在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
结束组件上当前播放的所有效果。 | UIComponent | ||
执行 UIComponent 对象是目标的所有绑定。 | UIComponent | ||
根据 String 查找列表中的项目,并将所选内容移至该项目。 | ListBase | ||
打印完成后调用。 | UIComponent | ||
在指定的索引位置提供自动化对象。 | UIComponent | ||
提供自动化对象列表。 | UIComponent | ||
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | ||
按指定的元素大小,返回元素边界的 x 坐标。 | UIComponent | ||
按指定的元素大小,返回元素边界的 y 坐标。 | UIComponent | ||
返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | ||
返回具有指定名称的子显示对象。 | DisplayObjectContainer | ||
返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | ||
查找此 UIComponent 实例的类型选择器。 | UIComponent | ||
返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | ||
确定是使用显式高度还是测量高度的一种简便方法
| UIComponent | ||
确定是使用显式宽度还是测量宽度的一种简便方法
| UIComponent | ||
获取当前具有焦点的对象。 | UIComponent | ||
返回相应的工厂;如果尚未指定,则使用默认工厂。 | ListBase | ||
返回元素的布局高度。 | UIComponent | ||
返回元素的布局宽度。 | UIComponent | ||
返回元素在屏幕上进行绘制时所用的 x 坐标。 | UIComponent | ||
返回元素在屏幕上进行绘制时所用的 y 坐标。 | UIComponent | ||
返回用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | ||
返回此元素的布局转换 Matrix3D。 | UIComponent | ||
返回元素的最大高度。 | UIComponent | ||
返回元素的最大宽度。 | UIComponent | ||
返回元素的最小高度。 | UIComponent | ||
返回元素的最小宽度。 | UIComponent | ||
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | ||
返回元素的首选高度。 | UIComponent | ||
返回元素的首选宽度。 | UIComponent | ||
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | ||
返回 true 或 false 以指示是否应在目标上播放效果。 | ListBase | ||
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | ||
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | ||
将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | ||
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | ||
将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。 | DisplayObject | ||
如果 currentCSSState 不为 null,则返回 true。 | UIComponent | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
表示对象是否已经定义了指定的属性。 | Object | ||
确定是否已在此 UIComponent 上定义指定的状态。 | UIComponent | ||
在鼠标指针下方隐藏指示允许执行拖放操作的拖放指示符。 | ListBase | ||
计算显示对象的边框,以确定它是否与 obj 显示对象的边框重叠或相交。 | DisplayObject | ||
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | ||
返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | ||
针对数据提供程序中某个项目的索引获取项呈示器(如果存在)。 | ListBase | ||
计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。 | ListBase | ||
初始化此组件的内部结构。 | UIComponent | ||
初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | ||
由某个组件的项目进行调用,以指示其 depth 属性已更改。 | UIComponent | ||
当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时,该元素必须调用该方法。 | UIComponent | ||
在下次更新时刷新所有行。 | ListBase | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | ||
确定是否加亮显示数据提供者项目的项呈示器(当鼠标滑过它,或者通过键盘导航使它位于尖号下方时)。 | ListBase | ||
确定数据提供程序项目的项呈示器是否可选。 | ListBase | ||
确定是否已选中数据提供程序项目的项呈示器。 | ListBase | ||
确定数据提供程序项的项呈示器是否为键盘导航后位于尖号下方的项。 | ListBase | ||
确定呈示器是否显示某个项目。 | ListBase | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
确定呈示器是否包含(或拥有)显示对象。 | ListBase | ||
返回通过此项呈示器呈示的该项目在数据提供程序中的项目索引。 | ListBase | ||
返回呈示器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。 | ListBase | ||
根据 iconField 和 iconFunction 属性返回表示数据项目图标的类(如果存在)。 | ListBase | ||
返回数据提供程序中给定项目的项呈示器(如果存在)。 | ListBase | ||
返回呈示器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。 | ListBase | ||
将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | ||
将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | ||
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | ||
如果 cssState 与 currentCSSState 匹配,则返回 true。 | UIComponent | ||
确定此实例与给定类型相同,还是属于给定类型的子类。 | UIComponent | ||
使用当前项呈示器测量数据提供程序中的一组项目,并返回这些项目的高度之和。 | ListBase | ||
测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标签),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | ||
测量指定的文本,假定该文本使用由此 UIComponent 的样式确定的 UITextFormat 显示在单行 UITextField(或 UIFTETextField)中。 | UIComponent | ||
使用当前项呈示器测量数据提供程序中的一组项目,并返回找到的最大宽度。 | ListBase | ||
将组件移动到其父项内的指定位置。 | UIComponent | ||
将样式更改传播到子项。 | UIComponent | ||
如果 owner 属性链从 child 指向此 UIComponent,则返回 true。 | UIComponent | ||
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | ||
准备 IFlexDisplayObject 用于打印。 | UIComponent | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
为此组件及其所有后代生成或重新生成 CSS 样式缓存,前提条件是递归参数为 true。 | UIComponent | ||
针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | ||
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | ||
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | ||
从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。 | DisplayObjectContainer | ||
如果正在运行数据更改效果,则移除项呈示器。 | ListBase | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
从该组件实例删除非可视样式客户端。 | UIComponent | ||
重放指定的事件。 | UIComponent | ||
显示虚拟键盘。 | InteractiveObject | ||
使用提供的 ID 解析子项。 | UIComponent | ||
[静态]
在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | ||
确保给定索引处的数据提供程序项目可见。 | ListBase | ||
调整对象大小。 | UIComponent | ||
更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | ||
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | ||
设置当前状态。 | UIComponent | ||
设置此组件的焦点。 | UIComponent | ||
设置元素在屏幕上进行绘制时所用的坐标。 | UIComponent | ||
设置元素的布局大小。 | UIComponent | ||
设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。 | UIComponent | ||
设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。 | UIComponent | ||
设置循环操作动态属性的可用性。 | Object | ||
对此组件实例设置样式属性。 | UIComponent | ||
当 visible 属性发生更改时调用。 | UIComponent | ||
在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。 | ListBase | ||
允许用户拖动指定的 Sprite。 | Sprite | ||
使用户可以在启用触摸的设备上拖动指定的 Sprite。 | Sprite | ||
对源起于此对象的所有 MovieClip 递归停止时间轴执行。 | DisplayObjectContainer | ||
结束 startDrag() 方法。 | Sprite | ||
结束 startTouchDrag() 方法,用于启用触摸的设备。 | Sprite | ||
检测对样式属性的更改。 | UIComponent | ||
首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | ||
[静态]
阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | ||
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。 | DisplayObjectContainer | ||
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。 | DisplayObjectContainer | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
[覆盖]
返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | ||
transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
用于更新转换的旋转、缩放和平移的一种实用程序方法,同时保留某个特定点,该点是在组件自己的坐标空间中指定的,且在父项的坐标空间中是固定的。 | UIComponent | ||
一种实用程序方法,用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。 | UIComponent | ||
如果对应于特定数据项目的项呈示器需要移动到控件中项呈示器的正常位置之外,则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。 | ListBase | ||
验证子项的位置和大小,并绘制其他可视内容。 | UIComponent | ||
验证并更新此对象的属性和布局,如果需要的话重绘对象。 | UIComponent | ||
由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | ||
如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。 | UIComponent | ||
处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | ||
返回指定对象的原始值。 | Object | ||
返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | ||
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher |
受保护的方法
效果
效果 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
触发事件: added 将组件作为子项添加到 Container 时播放。 | UIComponent | |||
触发事件: creationComplete 创建组件时播放。 | UIComponent | |||
触发事件: focusIn 组件获得键盘焦点时播放。 | UIComponent | |||
触发事件: focusOut 组件失去键盘焦点时播放。 | UIComponent | |||
触发事件: hide 组件变为不可见时播放。 | UIComponent | |||
itemsChangeEffect | 触发事件: itemsChange 当控件的数据提供程序发生更改时播放的数据效果。 默认情况下,TileList 控件不使用数据效果。对于 TileList 控件,使用 DefaultTileListEffect 类的实例。 | TileList | ||
触发事件: mouseDown 用户在组件上方按下鼠标按键时播放。 | UIComponent | |||
触发事件: mouseUp 用户在组件上方释放鼠标按键时播放。 | UIComponent | |||
触发事件: move 移动组件时播放。 | UIComponent | |||
触发事件: removed 从 Container 中删除组件时播放。 | UIComponent | |||
触发事件: resize 调整组件大小时播放。 | UIComponent | |||
触发事件: rollOut 用户将鼠标指针滚离组件上方时播放。 | UIComponent | |||
触发事件: rollOver 用户将鼠标指针滚动到组件上方时播放。 | UIComponent | |||
触发事件: show 组件变为可见时播放。 | UIComponent |
构造函数详细信息
TileList | () | 构造函数 |
public function TileList()
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
示例 如何使用本示例
TileListExample.mxml
<?xml version="1.0" encoding="utf-8"?> <!-- Simple example to demonstrate the Halo TileList Control. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx"> <fx:Script> <![CDATA[ [Embed(source="assets/Nokia_6630.png")] public const phone1:Class; [Embed(source="assets/Nokia_6680.png")] public const phone2:Class; [Embed(source="assets/Nokia_7610.png")] public const phone3:Class; [Embed(source="assets/Nokia_lg_v_keypad.png")] public const phone4:Class; [Embed(source="assets/Nokia_sm_v_keypad.png")] public const phone5:Class; ]]> </fx:Script> <s:Panel title="Halo TileList Control Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:VGroup left="10" right="10" top="10" bottom="10"> <s:Label width="100%" color="blue" text="A TileList control displays items in rows and columns."/> <mx:TileList id="CameraSelection" height="250" width="300" maxColumns="2" rowHeight="225" columnWidth="125"> <mx:dataProvider> <fx:Array> <fx:Object label="Nokia 6630" icon="{phone1}"/> <fx:Object label="Nokia 6680" icon="{phone2}"/> <fx:Object label="Nokia 7610" icon="{phone3}"/> <fx:Object label="Nokia LGV" icon="{phone4}"/> <fx:Object label="Nokia LMV" icon="{phone5}"/> </fx:Array> </mx:dataProvider> </mx:TileList> </s:VGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:04 AM Z