包 | mx.managers |
类 | public class LayoutManager |
继承 | LayoutManager EventDispatcher Object |
实现 | ILayoutManager |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
这三个阶段互不相同,并且,只有在处理完当前阶段的所有 UIComponent 之后才会进入下一阶段。在某个阶段中处理 UIComponent 期间,可能出现另一阶段请求重新处理 UIComponent 的情况。这些请求将进行排队,并且只在下次运行此阶段时才得到处理。
提交阶段从调用 validateProperties()
开始,该方法将遍历一个对象列表(该列表按嵌套级别反向排序),并调用每个对象的
validateProperties()
方法。
列表中的对象是按与嵌套级别正相反的顺序接受处理的,所以最先访问的是嵌套深度最浅的对象。这也可以称为自上而下或从外到内的顺序。
在此阶段中,允许内容依据属性设置而定的组件在进入度量和布局阶段之前进行自我配置。为了获得更好的性能,组件的属性 setter 方法有时不执行更新到新属性值所需的全部操作。但是,属性 setter 会调用 invalidateProperties()
方法,并在运行此阶段之前延迟此操作。这样,可以在多次设置属性时避免执行不必要的操作。
度量阶段从调用 validateSize()
开始,该方法将遍历一个对象列表(该列表按嵌套级别排序),并调用每个对象的
validateSize()
方法,以确定对象大小是否已更改。
如果之前调用过对象的
invalidateSize()
方法,则调用 validateSize()
方法。如果对象的大小或位置因调用 validateSize()
而发生了更改,则会调用对象的
invalidateDisplayList()
方法,这就会将该对象添加到处理队列中,等待下次运行布局阶段时进行处理。此外,已分别调用
invalidateSize()
和
invalidateDisplayList()
为度量和布局这两个阶段标记了对象的父项。
列表中的对象是按嵌套级别的顺序进行处理的,所以最先访问的是嵌套深度最深的对象。这也可以称为自下而上或从内到外的顺序。
布局阶段从调用 validateDisplayList()
方法开始,该方法将遍历一个对象列表(该列表按嵌套级别反向排序),并调用每个对象的
validateDisplayList()
方法,以请求对象确定它所包含的所有组件(即其子对象)的大小和位置。
如果之前调用过对象的
invalidateDisplayList()
方法,则调用 validateDisplayList()
方法。
列表中的对象是按与嵌套级别正相反的顺序接受处理的,所以最先访问的是嵌套深度最浅的对象。这也可以称为自上而下或从外到内的顺序。
通常情况下,组件不会覆盖 validateProperties()
、validateSize()
或 validateDisplayList()
方法。对于 UIComponent 而言,大部分组件都会覆盖分别由 validateProperties()
、validateSize()
或 validateDisplayList()
方法调用的 commitProperties()
、measure()
或 updateDisplayList()
方法。
当应用程序启动时,将创建一个 LayoutManager 实例并将其存储在 UIComponent.layoutManager
属性中。所有组件都应使用此实例。如果您无权访问 UIComponent 对象,也可以使用静态 LayoutManager.getInstance()
方法访问 LayoutManager。
属性 | 由以下参数定义 | ||
---|---|---|---|
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
usePhasedInstantiation : Boolean
一个标志,用于指示 LayoutManager 是否允许在各个阶段之间更新屏幕。 | LayoutManager |
方法 | 由以下参数定义 | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
LayoutManager | |||
将事件调度到事件流中。 | EventDispatcher | ||
[静态]
返回此 singleton 类的唯一实例;如果不存在这样的实例,则创建一个。 | LayoutManager | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
表示对象是否已经定义了指定的属性。 | Object | ||
当组件发生的更改导致其布局和/或视觉效果需要更改时调用。 | LayoutManager | ||
向希望调用其 validateProperties() 方法的组件的列表中添加一个对象。 | LayoutManager | ||
向希望调用其 validateSize() 方法的组件的列表中添加一个对象。 | LayoutManager | ||
如果存在需要验证的组件,则返回 true;如果已经验证所有组件,则返回 false。 | LayoutManager | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
设置循环操作动态属性的可用性。 | Object | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
当属性发生更改后,组件通常不会立即应用这些更改, | LayoutManager | ||
当属性发生更改后,组件通常不会立即应用这些更改, | LayoutManager | ||
返回指定对象的原始值。 | Object | ||
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher |
usePhasedInstantiation | 属性 |
usePhasedInstantiation:Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
一个标志,用于指示 LayoutManager 是否允许在各个阶段之间更新屏幕。如果为 true
,则在各阶段都会进行度量和布局,每个阶段结束后都会更新一次屏幕。所有组件都将调用其 validateProperties()
和 commitProperties()
方法,直到验证完各自的所有属性。屏幕将随之更新。
然后,所有组件都将调用其 validateSize()
和 measure()
方法,直到测量完所有组件,屏幕也将再次更新。
最后,所有组件都将调用其 validateDisplayList()
和 updateDisplayList()
方法,直到验证完所有组件,屏幕也将再次更新。如果正在验证某个阶段,并且前面的阶段失效,则会重新启动 LayoutManager。当创建和初始化大量组件时,此方法更为高效。框架负责设置此属性。
如果为 false
,则会在更新屏幕之前完成所有这三个阶段。
实现
public function get usePhasedInstantiation():Boolean
public function set usePhasedInstantiation(value:Boolean):void
attachListeners | () | 方法 |
getInstance | () | 方法 |
public static function getInstance():LayoutManager
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
返回此 singleton 类的唯一实例;如果不存在这样的实例,则创建一个。
返回LayoutManager — 返回此 singleton 类的唯一实例;如果不存在这样的实例,则创建一个。
|
invalidateDisplayList | () | 方法 |
public function invalidateDisplayList(obj:ILayoutManagerClient):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当组件发生的更改导致其布局和/或视觉效果需要更改时调用。在这种情况下,即使没有更改过组件的大小,也必须运行组件的布局算法。例如,当添加了新的子组件时、样式属性发生更改时或组件的父项为组件赋予了新尺寸时。
参数
obj:ILayoutManagerClient — 更改过的对象。
|
invalidateProperties | () | 方法 |
public function invalidateProperties(obj:ILayoutManagerClient):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
向希望调用其 validateProperties()
方法的组件的列表中添加一个对象。组件应在属性发生更改时调用此方法。通常,属性 setter 方法将新值存储在临时变量中,然后调用 invalidateProperties()
方法,以便稍后在新值实际应用到组件和/或其子项时调用其 validateProperties()
和 commitProperties()
方法。此策略非常适用于以下经常遇到的情况:一次更改多个属性,并且这些属性之间可能会交互;在应用代码时需重复某些代码或需要按一定顺序应用代码。此策略可以为应用新属性值提供最有效的方法。
参数
obj:ILayoutManagerClient — 属性已发生更改的对象。
|
invalidateSize | () | 方法 |
public function invalidateSize(obj:ILayoutManagerClient):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
向希望调用其 validateSize()
方法的组件的列表中添加一个对象。当对象的大小发生更改时调用。
导致对象大小发生更改的原因有两个:
- 对象的内容发生更改。例如,在更改按钮的
label
时更改了此按钮的大小。 - 脚本可显式更改下列属性之一:
minWidth
、minHeight
、explicitWidth
、explicitHeight
、maxWidth
或maxHeight
。
发生第一种情况时,必须重新计算对象的测量值。发生第二种情况时,则不必重新计算测量值,因为对象的新尺寸是已知的。但是,必须重新测量和重新布局对象的父项。
参数
obj:ILayoutManagerClient — 大小已发生更改的对象。
|
isInvalid | () | 方法 |
validateClient | () | 方法 |
public function validateClient(target:ILayoutManagerClient, skipDisplayList:Boolean = false):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当属性发生更改后,组件通常不会立即应用这些更改,而是会调用 LayoutManager 的一个 invalidate 方法,并在稍后应用这些属性。可以立即重新读取实际设置的属性,但如果该属性会影响组件或者其子项或父项中的其他属性,则可能不会立即更新这些受影响的属性。
要保证已更新这些值,可以调用 validateClient()
方法。它会在返回之前更新嵌套级别大于或等于目标组件的所有组件中的所有属性。仅在必要时才调用此方法,因为调用此方法需要进行大量计算。
参数
target:ILayoutManagerClient — 传入的组件用于测试应该验证哪些组件。将调用此组件中包含的所有组件的 validateProperties() 、commitProperties() 、validateSize() 、measure() 、validateDisplayList() 和 updateDisplayList() 方法。
| |
skipDisplayList:Boolean (default = false ) — 如果为 true ,则不调用 validateDisplayList() 和 updateDisplayList() 方法。
|
validateNow | () | 方法 |
public function validateNow():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当属性发生更改后,组件通常不会立即应用这些更改,而是会调用 LayoutManager 的一个 invalidate 方法,并在稍后应用这些属性。可以立即重新读取实际设置的属性,但如果该属性会影响组件或者其子项或父项中的其他属性,则可能不会立即更新这些受影响的属性。要保证已更新这些值,可以调用 validateNow()
方法。它会在返回之前更新所有组件中的所有属性。仅在必要时才调用此方法,因为调用此方法需要进行大量计算。
Tue Jun 12 2018, 11:04 AM Z