Manages display objects that need to be created dynamically, such as sub-components of a complex UI component.

Available since

1.0.0

.

See also:

Static methods

staticwithClass<T, B>(displayObjectType:Class<T>, ?destroy:T ‑> Void):DisplayObjectFactory<T, B>

Creates a DisplayObjectFactory that instantiates a display object by instantiating the specified class. The class must have a constructor with zero required arguments.

To instantiate an object with one or more required constructor arguments, use DisplayObjectFactory.withFunction() instead.

staticwithDisplayObject<T, B>(displayObject:T, ?destroy:T ‑> Void):DisplayObjectFactory<T, B>

Creates a DisplayObjectFactory that instantiates a display object by instantiating the specified class. The class must have a constructor with zero required arguments.

To instantiate an object with one or more required constructor arguments, use DisplayObjectFactory.withFunction() instead.

staticwithFunction<T, B>(create:() ‑> T, ?destroy:T ‑> Void):DisplayObjectFactory<T, B>

Creates a DisplayObjectFactory that instantiates a display object by calling the specified function.

Methods

dynamiccreate():T

Creates a new display object.

Available since

1.0.0

.

dynamicdestroy(target:T):Void

Destroys/disposes a display object when it will no longer be used.

Warning: This method is not guaranteed to be called by the parent component when that component is removed from stage (or later when it is garbage collected). If this method must be called to clean up something that would cause a memory leak, you should manually update the appropriate property on the parent component that will cause all instances to be removed, and then validate the parent component. For example, on a ListView, you would set the dataProvider property to null before calling validateNow().

listView.dataProvider = null;
listView.validateNow();
Available since

1.0.0

.