| 包 | spark.layouts |
| 类 | public class TileLayout |
| 继承 | TileLayout  LayoutBase OnDemandEventDispatcher Object |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
按元素支持的约束有 percentWidth 和 percentHeight。始终考虑元素的最小大小和最大大小，并在可能的情况下，将元素的大小限制为小于或等于单元格大小。
未显式设置时，会将 columnWidth 属性计算为所有元素的最大首选界限宽度，并将 columnHeight 属性计算为所有元素的最大首选界限高度。
未显式设置时，会从布局目标的任何显式宽度和高度设置以及 columnWidth 和 columnHeight 计算 columnCount 和 rowCount 属性。如果未指定任何内容，则会拾取 columnCount 和 rowCount 值，这样结果像素区域会尽可能成为方形。
测量大小根据 columnCount、rowCount、columnWidth、rowHeight 属性和间隙大小进行计算。
未显式设置任何属性时，默认测量大小会尽可能成为方形区域并足够大以容纳所有元素。
其他情形下，测量大小可能不够大而无法容纳所有元素。例如，将 columnCount 和 rowCount 显式设置为 columnCount 和 rowCount 小于元素计数的值。
最小测量大小是按与测量大小相同的方式计算的，但它保证沿着短轴包含足够的行和列以容纳所有元素。
MXML 语法
显示 MXML 语法
隐藏 MXML 语法The <s:TileLayout> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:TileLayout
Properties
columnAlign="left"
columnWidth="NaN"
horizontalAlign="justify"
horizontalGap="6"
orientation="rows"
requestedColumnCount="-1"
requestedRowCount="-1"
rowAlign="top"
rowCount="-1"
rowHeight="NaN"
verticalAlign="justify"
verticalGap="6"
/>
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | clipAndEnableScrolling : Boolean
如果为 true，指定将子代剪切到视区的边界。 | LayoutBase | |
| columnAlign : String
指定如何将完全可见列与容器宽度对齐。 | TileLayout | ||
| columnCount : int [只读]
包含实际列计数。 | TileLayout | ||
| columnWidth : Number
包含实际列宽（以像素为单位）。 | TileLayout | ||
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| dropIndicator : DisplayObject
该布局在拖放操作过程中用于拖放指示符的 DisplayObject。 | LayoutBase | |
| horizontalAlign : String
指定如何在水平方向上对齐单元格内的元素。 | TileLayout | ||
| horizontalGap : Number
列之间的水平空间（以像素为单位）。 | TileLayout | ||
| horizontalScrollPosition : Number
组件的坐标系中视域原点（默认值为 (0,0)，与组件的左上角相对应）的 x 坐标。 | LayoutBase | |
| orientation : String
指定是逐行还是逐列排列元素。 | TileLayout | ||
| paddingBottom : Number
容器的底边缘与最后一个布局元素的底边缘之间的像素数。 | TileLayout | ||
| paddingLeft : Number
容器的左边缘与布局元素的左边缘之间的最少像素数。 | TileLayout | ||
| paddingRight : Number
容器的右边缘与布局元素的右边缘之间的最少像素数。 | TileLayout | ||
| paddingTop : Number
容器的顶边缘与第一个布局元素的顶边缘之间的像素数。 | TileLayout | ||
| requestedColumnCount : int
要显示的列数。 | TileLayout | ||
| requestedRowCount : int
要显示的行数。 | TileLayout | ||
| rowAlign : String
指定如何将完全可见行与容器高度对齐。 | TileLayout | ||
| rowCount : int [只读]
行计数。 | TileLayout | ||
| rowHeight : Number
行高（以像素为单位）。 | TileLayout | ||
| target : GroupBase
此布局将测量其元素、调整其元素的大小并定位其元素的 GroupBase 容器。 | LayoutBase | |
| typicalLayoutElement : ILayoutElement
当请求固定的行/列大小而未指定某个特定大小时，由布局所使用。 | LayoutBase | |
| useVirtualLayout : Boolean
一个容器可包含任意数量的子项。 | LayoutBase | |
| verticalAlign : String
指定如何在垂直方向上对齐单元格内的元素。 | TileLayout | ||
| verticalGap : Number
行之间的垂直空间（以像素为单位）。 | TileLayout | ||
| verticalScrollPosition : Number
组件的坐标系中视区的原点（默认值为 (0,0)，与组件的左上角相对应）的 y 坐标。 | LayoutBase | |
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造函数。 | TileLayout | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | OnDemandEventDispatcher | |
|
为指定的 dragEvent 在放置目标的数据提供程序中计算拖放位置。 | LayoutBase | |
|
如果 useVirtualLayout 为 true，则当布局目标改变时，布局目标可以使用此方法来清除已缓存布局信息。 | LayoutBase | |
|
将事件调度到事件流中。 | OnDemandEventDispatcher | |
|
在已添加布局元素之后且在验证目标的大小和显示列表之前，由目标调用。 | LayoutBase | |
|
必须在已删除布局元素之后且在验证目标的大小和显示列表之前，由目标调用此方法。 | LayoutBase | |
|
如果索引无效、相应的元素为 null、includeInLayout=false，或者如果此布局的 target 属性为 null，则将指定元素的布局界限返回为 Rectangle 或 null。 | LayoutBase | |
|
返回对水平滚动位置的更改以处理不同的滚动选项。 | LayoutBase | |
| getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
确定根据 NavigationUnit、基于当前处于焦点的项目和用户输入要导航到哪个项目的委派方法。 | LayoutBase | |
|
计算所需的 verticalScrollPosition 和 horizontalScrollPosition delta，以将处于指定索引处的元素滚动到视图中。 | LayoutBase | |
|
返回对垂直滚动位置的更改以处理不同的滚动选项。 | LayoutBase | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | OnDemandEventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
隐藏由 showDropIndicator() 方法创建的先前显示的拖放指示符，将其从显示列表中删除，还将停止拖放滚动。 | LayoutBase | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
基于目标的内容测量其默认大小，并（可选）测量目标的默认最小大小。 | LayoutBase | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
从 EventDispatcher 对象中删除侦听器。 | OnDemandEventDispatcher | |
|
设置循环操作动态属性的可用性。 | Object | |
|
根据指定的拖放位置调整拖放指示符的大小、确定其位置并设置其父代。 | LayoutBase | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
调整目标的元素的大小并定位这些元素。 | LayoutBase | |
|
在其 updateDisplayList 的结尾由目标调用，以使布局更新其 scrollRect。 | LayoutBase | |
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | OnDemandEventDispatcher | |
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
|
计算在拖放动作中为指定 dropLocation 滚动的数量。 | LayoutBase | |
[覆盖]
返回在完成某个拖放动作的同时用户在指定的坐标处释放鼠标的情况下应该插入新项目的位置的索引。 | TileLayout | ||
[覆盖]
计算拖放指示符的边界，该指示符为用户提供关于在拖放动作结尾处将项插入的位置的可视反馈。 | TileLayout | ||
|
返回跨越 scrollRect 的顶边或在其顶边之上的第一个布局元素的界限。 | LayoutBase | |
|
返回跨越 scrollRect 的底边或在其底边之下的第一个布局元素的界限。 | LayoutBase | |
|
返回跨越 scrollRect 的左边或在其左边左侧的第一个布局元素的界限。 | LayoutBase | |
|
返回跨越 scrollRect 的右边或在其右边右侧的第一个布局元素的界限。 | LayoutBase | |
|
返回布局坐标中目标的滚动矩形的界限。 | LayoutBase | |
|
verticalScrollPosition 或 horizontalScrollPosition 属性更改时调用。 | LayoutBase | |
columnAlign | 属性 |
columnAlign:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指定如何将完全可见列与容器宽度对齐。ActionScript 值可以为 ColumnAlign.LEFT、ColumnAlign.JUSTIFY_USING_GAP 和 ColumnAlign.JUSTIFY_USING_WIDTH。MXML 值可以为 "left"、"justifyUsingGap" 和 "justifyUsingWidth"。
设置为 ColumnAlign.LEFT 时，它会关闭列两端对齐。在容器的最后一列和右边缘之间可能存在部分可见的列或空白。这是默认值。
设置为 ColumnAlign.JUSTIFY_USING_GAP 时，horizontalGap 的实际值将增大，这样最后一个完全可见列右边缘会与容器的右边缘对齐。仅存在一个完全可见列时，horizontalGap 的实际值将增大，这样它会将任何部分可见列推到容器的右边缘之外。请注意显式设置 horizontalGap 属性不会关闭两端对齐。它仅确定初始间隙值。两端对齐可能会增大它。
设置为 ColumnAlign.JUSTIFY_USING_WIDTH 时，columnWidth 的实际值将增大，这样最后一个完全可见列右边缘会与容器的右边缘对齐。请注意显式设置 columnWidth 属性不会关闭两端对齐。它仅确定初始列宽度值。两端对齐可能会增大它。
默认值为 ColumnAlign.LEFT。
实现
public function get columnAlign():String public function set columnAlign(value:String):void相关 API 元素
columnCount | 属性 |
columnWidth | 属性 |
columnWidth:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
包含实际列宽（以像素为单位）。
若未显式设置，则从根据最宽的元素的宽度确定列宽度。
如果将 columnAlign 属性设置为 "justifyUsingWidth"，则列宽度会增大到容器宽度以对齐完全可见列。
默认值为 NaN。
此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。
实现
public function get columnWidth():Number public function set columnWidth(value:Number):void相关 API 元素
horizontalAlign | 属性 |
horizontalAlign:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指定如何在水平方向上对齐单元格内的元素。支持的值有 HorizontalAlign.LEFT、HorizontalAlign.CENTER、HorizontalAlign.RIGHT、HorizontalAlign.JUSTIFY。
设置为 HorizontalAlign.JUSTIFY 时，会将每个元素的宽度设置为 columnWidth。
默认值为 HorizontalAlign.JUSTIFY。
实现
public function get horizontalAlign():String public function set horizontalAlign(value:String):voidhorizontalGap | 属性 |
orientation | 属性 |
orientation:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指定是逐行还是逐列排列元素。ActionScript 值可以是 TileOrientation.ROWS 和 TileOrientation.COLUMNS。MXML 值可以是 "rows" 和 "columns"。
默认值为 TileOrientation.ROWS。
实现
public function get orientation():String public function set orientation(value:String):voidpaddingBottom | 属性 |
paddingLeft | 属性 |
paddingRight | 属性 |
paddingTop | 属性 |
requestedColumnCount | 属性 |
requestedColumnCount:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
要显示的列数。
设置为 -1 会允许 TileLayout 自动确定列计数。
如果将 orientation 属性设置为 TileOrientation.ROWS，则设置此属性不会产生任何效果。这种情况下，会显式设置 rowCount，并显式设置容器宽度。
默认值为 -1。
实现
public function get requestedColumnCount():int public function set requestedColumnCount(value:int):void相关 API 元素
requestedRowCount | 属性 |
requestedRowCount:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
要显示的行数。
设置为 -1 会删除显式覆盖并允许 TileLayout 自动确定行计数。
如果将 orientation 属性设置为 TileOrientation.COLUMNS，则设置此属性不会产生任何效果。这种情况下，会显式设置 columnCount，并显式设置容器高度。
默认值为 -1。
实现
public function get requestedRowCount():int public function set requestedRowCount(value:int):void相关 API 元素
rowAlign | 属性 |
rowAlign:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指定如何将完全可见行与容器高度对齐。ActionScript 值可以为 RowAlign.TOP、RowAlign.JUSTIFY_USING_GAP 和 RowAlign.JUSTIFY_USING_HEIGHT。MXML 值可以为 "top"、"justifyUsingGap" 和 "justifyUsingHeight"。
设置为 RowAlign.TOP 时，它会关闭列两端对齐。在容器的最后一行和底边缘之间可能存在部分可见的行或空白。这是默认值。
设置为 RowAlign.JUSTIFY_USING_GAP 时，verticalGap 的实际值会增大，这样最后一个完全可见行底边缘会与容器的底边缘对齐。仅存在一个完全可见行时，verticalGap 的值会增大，这样它会将任何部分可见行推到容器的底边缘之外。请注意，显式设置 verticalGap 不会关闭两端对齐，而只是确定初始间隙值。两端对齐接着可以增大它。
设置为 RowAlign.JUSTIFY_USING_HEIGHT 时，rowHeight 的实际值会增大，这样最后一个完全可见行底边缘会与容器的底边缘对齐。请注意，显式设置 rowHeight 不会关闭两端对齐，而只是确定初始行高度值。两端对齐接着可以增大它。
默认值为 RowAlign.TOP。
实现
public function get rowAlign():String public function set rowAlign(value:String):void相关 API 元素
rowCount | 属性 |
rowHeight | 属性 |
rowHeight:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
行高（以像素为单位）。
如果未显式设置，则从元素的高度的最大值确定行高度。
如果将rowAlign 设置为 "justifyUsingHeight"，实际行高度会增大，以将完全可见行两端对齐为容器高度。
默认值为 NaN。
此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。
实现
public function get rowHeight():Number public function set rowHeight(value:Number):void相关 API 元素
verticalAlign | 属性 |
verticalAlign:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指定如何在垂直方向上对齐单元格内的元素。支持的值有 VerticalAlign.TOP、VerticalAlign.MIDDLE、VerticalAlign.BOTTOM、VerticalAlign.JUSTIFY。
设置为 VerticalAlign.JUSTIFY 时，会将每个元素的高度设置为 rowHeight。
默认值为 VerticalAlign.JUSTIFY。
实现
public function get verticalAlign():String public function set verticalAlign(value:String):voidverticalGap | 属性 |
TileLayout | () | 构造函数 |
public function TileLayout()| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
构造函数。
calculateDropIndex | () | 方法 |
override protected function calculateDropIndex(x:Number, y:Number):int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回在完成某个拖放动作的同时用户在指定的坐标处释放鼠标的情况下应该插入新项目的位置的索引。由 calculatedDropLocation() 方法调用。
参数
x:Number — 在本地坐标中拖放动作的 x 坐标。
| |
y:Number — 在放置目标的本地坐标中，拖放动作的 y 坐标。
|
int — 拖放索引 或 -1（如果在指定坐标处拖放操作不可用）。
|
calculateDropIndicatorBounds | () | 方法 |
override protected function calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
计算拖放指示符的边界，该指示符为用户提供关于在拖放动作结尾处将项插入的位置的可视反馈。由 showDropIndicator() 方法调用。
参数
dropLocation:DropLocation — 由 calculateDropLocation() 方法先前返回的有效 DropLocation 对象。
|
Rectangle — 拖放指示符的界限或 null。
|
Tue Jun 12 2018, 11:04 AM Z