TileLayout

包	spark.layouts
类	public class TileLayout
继承	TileLayout LayoutBase OnDemandEventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

TileLayout 类在单元格大小相等的列和行中排列布局元素。TileLayout 类使用许多属性来控制列和行的方向、计数、大小、间隙和两端对齐以及单元格内的元素对齐。

按元素支持的约束有 percentWidth 和 percentHeight。始终考虑元素的最小大小和最大大小，并在可能的情况下，将元素的大小限制为小于或等于单元格大小。

未显式设置时，会将 columnWidth 属性计算为所有元素的最大首选界限宽度，并将 columnHeight 属性计算为所有元素的最大首选界限高度。

未显式设置时，会从布局目标的任何显式宽度和高度设置以及 columnWidth 和 columnHeight 计算 columnCount 和 rowCount 属性。如果未指定任何内容，则会拾取 columnCount 和 rowCount 值，这样结果像素区域会尽可能成为方形。

测量大小根据 columnCount、rowCount、columnWidth、rowHeight 属性和间隙大小进行计算。

未显式设置任何属性时，默认测量大小会尽可能成为方形区域并足够大以容纳所有元素。

其他情形下，测量大小可能不够大而无法容纳所有元素。例如，将 columnCount 和 rowCount 显式设置为 columnCount 和 rowCount 小于元素计数的值。

最小测量大小是按与测量大小相同的方式计算的，但它保证沿着短轴包含足够的行和列以容纳所有元素。

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() 构造函数。	TileLayout
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	OnDemandEventDispatcher
		calculateDropLocation(dragEvent:DragEvent):DropLocation 为指定的 dragEvent 在放置目标的数据提供程序中计算拖放位置。	LayoutBase
		clearVirtualLayoutCache():void 如果 useVirtualLayout 为 true，则当布局目标改变时，布局目标可以使用此方法来清除已缓存布局信息。	LayoutBase
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	OnDemandEventDispatcher
		elementAdded(index:int):void 在已添加布局元素之后且在验证目标的大小和显示列表之前，由目标调用。	LayoutBase
		elementRemoved(index:int):void 必须在已删除布局元素之后且在验证目标的大小和显示列表之前，由目标调用此方法。	LayoutBase
		getElementBounds(index:int):Rectangle 如果索引无效、相应的元素为 null、includeInLayout=false，或者如果此布局的 target 属性为 null，则将指定元素的布局界限返回为 Rectangle 或 null。	LayoutBase
		getHorizontalScrollPositionDelta(navigationUnit:uint):Number 返回对水平滚动位置的更改以处理不同的滚动选项。	LayoutBase
		getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int 确定根据 NavigationUnit、基于当前处于焦点的项目和用户输入要导航到哪个项目的委派方法。	LayoutBase
		getScrollPositionDeltaToElement(index:int):Point 计算所需的 verticalScrollPosition 和 horizontalScrollPosition delta，以将处于指定索引处的元素滚动到视图中。	LayoutBase
		getVerticalScrollPositionDelta(navigationUnit:uint):Number 返回对垂直滚动位置的更改以处理不同的滚动选项。	LayoutBase
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		hideDropIndicator():void 隐藏由 showDropIndicator() 方法创建的先前显示的拖放指示符，将其从显示列表中删除，还将停止拖放滚动。	LayoutBase
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		measure():void 基于目标的内容测量其默认大小，并（可选）测量目标的默认最小大小。	LayoutBase
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		showDropIndicator(dropLocation:DropLocation):void 根据指定的拖放位置调整拖放指示符的大小、确定其位置并设置其父代。	LayoutBase
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		updateDisplayList(width:Number, height:Number):void 调整目标的元素的大小并定位这些元素。	LayoutBase
		updateScrollRect(w:Number, h:Number):void 在其 updateDisplayList 的结尾由目标调用，以使布局更新其 scrollRect。	LayoutBase
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	OnDemandEventDispatcher

受保护的方法

隐藏继承的受保护方法

显示继承的受保护方法

	方法		由以下参数定义
		calculateDragScrollDelta(dropLocation:DropLocation, elapsedTime:Number):Point 计算在拖放动作中为指定 dropLocation 滚动的数量。	LayoutBase
		calculateDropIndex(x:Number, y:Number):int [覆盖] 返回在完成某个拖放动作的同时用户在指定的坐标处释放鼠标的情况下应该插入新项目的位置的索引。	TileLayout
		calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle [覆盖] 计算拖放指示符的边界，该指示符为用户提供关于在拖放动作结尾处将项插入的位置的可视反馈。	TileLayout
		getElementBoundsAboveScrollRect(scrollRect:Rectangle):Rectangle 返回跨越 scrollRect 的顶边或在其顶边之上的第一个布局元素的界限。	LayoutBase
		getElementBoundsBelowScrollRect(scrollRect:Rectangle):Rectangle 返回跨越 scrollRect 的底边或在其底边之下的第一个布局元素的界限。	LayoutBase
		getElementBoundsLeftOfScrollRect(scrollRect:Rectangle):Rectangle 返回跨越 scrollRect 的左边或在其左边左侧的第一个布局元素的界限。	LayoutBase
		getElementBoundsRightOfScrollRect(scrollRect:Rectangle):Rectangle 返回跨越 scrollRect 的右边或在其右边右侧的第一个布局元素的界限。	LayoutBase
		getScrollRect():Rectangle 返回布局坐标中目标的滚动矩形的界限。	LayoutBase
		scrollPositionChanged():void 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 元素

horizontalGap
columnWidth
rowAlign

columnCount

属性

columnCount:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

包含实际列计数。

默认值为 -1。

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

实现
public function get columnCount():int

相关 API 元素

rowCount
columnAlign

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 元素

rowHeight
columnAlign

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

horizontalGap

属性

horizontalGap:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

列之间的水平空间（以像素为单位）。

默认值为 6。

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

实现
public function get horizontalGap():Number
public function set horizontalGap(value:Number):void

相关 API 元素

verticalGap
columnAlign

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

paddingBottom

属性

paddingBottom:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

容器的底边缘与最后一个布局元素的底边缘之间的像素数。

默认值为 0。

实现
public function get paddingBottom():Number
public function set paddingBottom(value:Number):void

paddingLeft

属性

paddingLeft:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

容器的左边缘与布局元素的左边缘之间的最少像素数。

默认值为 0。

实现
public function get paddingLeft():Number
public function set paddingLeft(value:Number):void

paddingRight

属性

paddingRight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

容器的右边缘与布局元素的右边缘之间的最少像素数。

默认值为 0。

实现
public function get paddingRight():Number
public function set paddingRight(value:Number):void

paddingTop

属性

paddingTop:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

容器的顶边缘与第一个布局元素的顶边缘之间的像素数。

默认值为 0。

实现
public function get paddingTop():Number
public function set paddingTop(value:Number):void

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 元素

columnCount
columnAlign

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 元素

rowCount
rowAlign

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 元素

verticalGap
rowHeight
columnAlign

rowCount

属性

rowCount:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

行计数。

默认值为 -1。

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

实现
public function get rowCount():int

相关 API 元素

requestedRowCount
columnCount

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 元素

columnWidth
rowAlign

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

verticalGap

属性

verticalGap:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

行之间的垂直空间（以像素为单位）。

默认值为 6。

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

实现
public function get verticalGap():Number
public function set verticalGap(value:Number):void

相关 API 元素

horizontalGap
rowAlign

构造函数详细信息

()

构造函数

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。

法律声明 | 在线隐私策略

TileLayout - AS3 Flex

包x

语言元素

附录

包 spark.layouts

columnAlign

columnCount

columnWidth

horizontalAlign

horizontalGap

orientation

paddingBottom

paddingLeft

paddingRight

paddingTop

requestedColumnCount

requestedRowCount

rowAlign

rowCount

rowHeight

verticalAlign

verticalGap

TileLayout

calculateDropIndex

calculateDropIndicatorBounds