AddItems

包	mx.states
类	public class AddItems
继承	AddItems OverrideBase OnDemandEventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

文档当前不可用。

默认 MXML 属性itemsFactory

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		creationPolicy : String 项目的创建策略。	AddItems
		destination : Object 相对于其添加子项的对象。	AddItems
		destructionPolicy : String 项目的破坏策略。	AddItems
		isArray : Boolean = false 指示由目标属性表示的集合是否将视为单个数组实例，而不是项目的集合（默认值）。	AddItems
		isStyle : Boolean = false 指示由目标属性表示的集合是否为样式。	AddItems
		items : * 要添加的项目。	AddItems
		itemsFactory : mx.core:ITransientDeferredInstance 创建项目的 factory。	AddItems
		position : String = "last" 显示列表中子项的位置，随 relativeTo 属性指定的对象而变化。	AddItems
		propertyName : String 正在修改的 Array 属性的名称。	AddItems
		relativeTo : Object 相对于其添加子项的对象。	AddItems
		vectorClass : Class 由目标属性表示的集合为矢量时，vectorClass 是目标的类型。	AddItems

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		AddItems() 构造函数。	AddItems
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	OnDemandEventDispatcher
		apply(parent:UIComponent):void [覆盖] 应用覆盖。	AddItems
		createInstance():void 从 factory 创建项目实例。	AddItems
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	OnDemandEventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		initialize():void [覆盖] IOverride 接口方法；该类将其作为空方法实现。	AddItems
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		remove(parent:UIComponent):void [覆盖] 删除覆盖。	AddItems
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	OnDemandEventDispatcher

公共常量

	常量		由以下参数定义
		AFTER : String = "after" [静态] 文档当前不可用。	AddItems
		BEFORE : String = "before" [静态] 文档当前不可用。	AddItems
		FIRST : String = "first" [静态] 文档当前不可用。	AddItems
		LAST : String = "last" [静态] 文档当前不可用。	AddItems

属性详细信息

creationPolicy

属性

creationPolicy:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

项目的创建策略。此属性确定 itemsFactory 将何时创建项目的实例。Flex 仅在指定 itemsFactory 属性时使用此属性。以下是有效值：

值	意义
`auto`	（默认值）在第一次需要实例时创建实例。
`all`	在应用程序启动时创建实例。
`none`	不自动创建实例。必须调用 `createInstance()` 方法来创建该实例。

默认值为 "auto"。

实现
public function get creationPolicy():String
public function set creationPolicy(value:String):void

destination

属性

public var destination:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

相对于其添加子项的对象。该属性与 position 属性结合使用。此属性是可选的，如果省略此属性，Flex 将使用 State 对象的直接父级，即具有 states 属性的组件，或指定 State 对象的 <mx:states> 标签。

destructionPolicy

属性

destructionPolicy:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

项目的破坏策略。此属性确定 itemsFactory 将何时破坏它所管理的延迟实例。默认情况下，一旦将此属性实例化，所有实例都将缓存（破坏策略为“never”）。Flex 仅在指定 itemsFactory 属性时使用此属性。以下是有效值：

值	意义
`never`	（默认值）创建后即永远不会破坏实例。
`auto`	当覆盖不再适用时破坏实例。

默认值为 "never"。

实现
public function get destructionPolicy():String
public function set destructionPolicy(value:String):void

isArray

属性

public var isArray:Boolean = false

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

指示由目标属性表示的集合是否将视为单个数组实例，而不是项目的集合（默认值）。

默认值为 false。

isStyle

属性

public var isStyle:Boolean = false

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

指示由目标属性表示的集合是否为样式。

默认值为 false。

items

属性

items:*

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

要添加的项目。如果设置了此属性，将在应用程序启动时创建项目。设置此属性等同于设置 creationPolicy 为“all”的 itemsFactory 属性。

如果设置了 itemsFactory 属性，则不要设置此属性。

实现
public function get items():*
public function set items(value:any):void

itemsFactory

属性

itemsFactory:mx.core:ITransientDeferredInstance

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

创建项目的 factory。

如果设置了此属性，项目将在由 creationPolicy 属性确定的时间实例化。

如果设置了 items 属性，则不要设置此属性。此属性是 AddItems 类默认属性。设置 creationPolicy 为“all”的此属性等同于设置 items 属性。

实现
public function get itemsFactory():mx.core:ITransientDeferredInstance
public function set itemsFactory(value:mx.core:ITransientDeferredInstance):void

position

属性

public var position:String = "last"

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

显示列表中子项的位置，与 relativeTo 属性指定的对象相关。

默认值为 AddItems.LAST。

propertyName

属性

public var propertyName:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

正在修改的 Array 属性的名称。如果 destination 属性为 Group 或 Container，则此属性是可选属性。如果未定义，则项目将作为 Group/Container 的子项添加。

relativeTo

属性

public var relativeTo:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

相对于其添加子项的对象。此属性仅在 position 属性为 AddItems.BEFORE 或 AddItems.AFTER 时才可使用。

vectorClass

属性

public var vectorClass:Class

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

由目标属性表示的集合为矢量时，vectorClass 是目标的类型。它用于初始化目标属性。

构造函数详细信息

()

构造函数

public function AddItems()

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

方法详细信息

apply

()

方法

override public function apply(parent:UIComponent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

应用覆盖。Flex 将保留原始值，以便以后可以在 remove() 方法中恢复该值。

当进入状态时自动调用此方法。不应直接对其进行调用。

参数

parent:UIComponent — 包含此覆盖的状态对象的父级。如果未指定明确目标，覆盖应使用它作为其目标。

createInstance

()

方法

public function createInstance():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

从 factory 创建项目实例。必须在仅当指定 targetItems 属性并且 creationPolicy 的值为“none”时才使用此方法。如果 creationPolicy 属性值为 "auto" 或 "all"，Flex 将自动调用此方法。如果多次调用此方法，仅会在第一次调用时创建项目实例。

initialize

()

方法

override public function initialize():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

IOverride 接口方法；该类将其作为空方法实现。

remove

()

方法

override public function remove(parent:UIComponent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

删除覆盖。在 apply() 方法中记住的值将被恢复。

当进入状态时自动调用此方法。不应直接对其进行调用。

参数

parent:UIComponent — 包含此覆盖的状态对象的父级。如果未指定明确目标，覆盖应使用它作为其目标。

常量详细信息

AFTER

常量

public static const AFTER:String = "after"

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

文档当前不可用。

BEFORE

常量

public static const BEFORE:String = "before"

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

文档当前不可用。

FIRST

常量

public static const FIRST:String = "first"

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

文档当前不可用。

LAST

常量

public static const LAST:String = "last"

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

文档当前不可用。

法律声明 | 在线隐私策略

AddItems - AS3 Flex

包x

语言元素

附录

包 mx.states

creationPolicy

destination

destructionPolicy

isArray

isStyle

items

itemsFactory

position

propertyName

relativeTo

vectorClass

AddItems

apply

createInstance

initialize

remove

AFTER

BEFORE

FIRST

LAST