AddItems  - AS3 Flex

The creation policy for the items. This property determines when the itemsFactory will create the instance of the items. Flex uses this property only if you specify an itemsFactory property. The following values are valid:

The default value is "auto".

The object relative to which the child is added. This property is used in conjunction with the position property. This property is optional; if you omit it, Flex uses the immediate parent of the State object, that is, the component that has the states property, or <mx:states>tag that specifies the State object.

The destruction policy for the items. This property determines when the itemsFactory will destroy the deferred instances it manages. By default once instantiated, all instances are cached (destruction policy of 'never'). Flex uses this property only if you specify an itemsFactory property. The following values are valid:

The default value is "never".

Denotes whether or not the collection represented by the target property is to be treated as a single array instance instead of a collection of items (the default).

The default value is false.

Denotes whether or not the collection represented by the target property is a style.

The default value is false.

The items to be added. If you set this property, the items are created at app startup. Setting this property is equivalent to setting a itemsFactory property with a creationPolicy of "all".

Do not set this property if you set the itemsFactory property.

The factory that creates the items.

If you set this property, the items are instantiated at the time determined by the creationPolicy property.

Do not set this property if you set the items property. This propety is the AddItems class default property. Setting this property with a creationPolicy of "all" is equivalent to setting a items property.

The position of the child in the display list, relative to the object specified by the relativeTo property.

The default value is AddItems.LAST.

The name of the Array property that is being modified. If the destination property is a Group or Container, this property is optional. If not defined, the items will be added as children of the Group/Container.

The object relative to which the child is added. This property is only used when the position property is AddItems.BEFORE or AddItems.AFTER.

When the collection represented by the target property is a Vector, vectorClass is the type of the target. It is used to initialize the target property.

Constructor.

Applies the override. Flex retains the original value, so that it can restore the value later in the remove() method.

This method is called automatically when the state is entered. It should not be called directly.

Parameters

Creates the items instance from the factory. You must use this method only if you specify a targetItems property and a creationPolicy value of "none". Flex automatically calls this method if the creationPolicy property value is "auto" or "all". If you call this method multiple times, the items instance is created only on the first call.

IOverride interface method; this class implements it as an empty method.

Removes the override. The value remembered in the apply() method is restored.

This method is called automatically when the state is entered. It should not be called directly.

Parameters

Documentation is not currently available.

Documentation is not currently available.

Documentation is not currently available.

Documentation is not currently available.