| Paket | mx.states |
| Klasse | public class AddChild |
| Vererbung | AddChild  OverrideBase OnDemandEventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
overrides-Eigenschaft der State-Klasse. Mit der creationPolicy-Eigenschaft geben Sie an, dass das untergeordnete Element beim Start der Anwendung oder Wechsel zu einem Ansichtsstatus erstellt wird.
Das untergeordnete Element löst das creationComplete-Ereignis erst aus, wenn es einem Container hinzugefügt wird. Beispielsweise fügen Sie durch folgenden Code ein Button-Steuerelement als Teil einer Ansichtsstatusänderung hinzu:
<mx:AddChild relativeTo="{v1}">
<mx:Button id="b0" label="New Button"/>
</mx:AddChild>
In dem vorhergehenden Beispiel löst das Button-Steuerelement das creationComplete-Ereignis erst aus, wenn Sie den Status ändern und das Button-Steuerelement einem Container hinzugefügt wird. Wenn die AddChild-Klasse sowohl den Button als auch einen Container wie einen Arbeitsflächencontainer definiert, löst das Button-Steuerelement das creationComplete-Ereignis bei der Erstellung aus. Wenn beispielsweise die creationPolicy-Eigenschaft auf all gesetzt ist, löst das Button-Steuerelement ein Ereignis beim Start der Anwendung aus. Wenn die creationPolicy-Eigenschaft auf auto gesetzt ist, löst das Button-Steuerelement das Ereignis aus, wenn Sie in den Ansichtsstatus wechseln.
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:AddChild> tag
has the following attributes:
<mx:AddChild Properties target="null" targetFactory="null" creationPolicy="auto" position="lastChild" relativeTo="parent of the State object" />
Standard-MXML-EigenschafttargetFactory
Verwandte API-Elemente
| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| creationPolicy : String
Die Erstellungsrichtlinie für dieses untergeordnete Element. | AddChild | ||
| position : String
Die Position des untergeordneten Elements in der Anzeigeliste relativ zu dem Objekt, das durch die relativeTo-Eigenschaft angegeben wird. | AddChild | ||
| relativeTo : Object
Das Objekt, in Bezug auf das das untergeordnete Element hinzugefügt wird. | AddChild | ||
| target : DisplayObject
Das hinzuzufügende untergeordnete Element. | AddChild | ||
| targetFactory : IDeferredInstance
Die Factory, die das untergeordnete Element erstellt. | AddChild | ||
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | AddChild | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | OnDemandEventDispatcher | |
[override]
Wendet die Überschreibung an. | AddChild | ||
Erstellt die untergeordnete Instanz aus der Factory. | AddChild | ||
|
Sendet ein Ereignis in den Ereignisablauf. | OnDemandEventDispatcher | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | OnDemandEventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
[override]
IOverride-Schnittstellenmethode; diese Klasse implementiert sie als leere Methode. | AddChild | ||
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
[override]
Entfernt die Überschreibung. | AddChild | ||
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | OnDemandEventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | OnDemandEventDispatcher | |
creationPolicy | Eigenschaft |
creationPolicy:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Erstellungsrichtlinie für dieses untergeordnete Element. Diese Eigenschaft bestimmt, wann die targetFactory die Instanz des untergeordneten Elements erstellt. Flex verwendet diese Eigenschaft nur, wenn Sie eine targetFactory-Eigenschaft angeben. Folgende Werte sind gültig:
| Wert | Bedeutung |
|---|---|
auto | (Standard) Erstellt die Instanz, wenn sie das erste Mal benötigt wird. |
all | Erstellt die Instanz beim Start der Anwendung. |
none | Erstellt die Instanz nicht automatisch. Sie müssen die createInstance()-Methode zum Erstellen der Instanz aufrufen. |
Der Standardwert ist "auto".
Implementierung
public function get creationPolicy():String public function set creationPolicy(value:String):voidposition | Eigenschaft |
public var position:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Position des untergeordneten Elements in der Anzeigeliste, relativ zu dem durch die relativeTo-Eigenschaft angegebenen Objekt. Gültige Werte sind "before", "after", "firstChild" und "lastChild".
Der Standardwert ist "lastChild".
relativeTo | Eigenschaft |
public var relativeTo:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Objekt, in Bezug auf das das untergeordnete Element hinzugefügt wird. Diese Eigenschaft wird mit der position-Eigenschaft verwendet. Diese Eigenschaft ist optional. Wenn Sie sie auslassen, verwendet Flex das unmittelbar übergeordnete Element des State-Objekts, d. h. die Komponente mit der states-Eigenschaft oder dem <mx:states>-Tag, das das State-Objekt angibt.
target | Eigenschaft |
target:DisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das hinzuzufügende untergeordnete Element. Wenn Sie diese Eigenschaft einstellen, wird die untergeordnete Instanz beim Start der Anwendung erstellt. Das Einstellen dieser Eigenschaft entspricht dem Einstellen der targetFactory-Eigenschaft mit dem creationPolicy-Wert "all".
Sie stellen diese Eigenschaft nicht ein, wenn Sie die targetFactory-Eigenschaft festlegen.
Implementierung
public function get target():DisplayObject public function set target(value:DisplayObject):voidtargetFactory | Eigenschaft |
targetFactory:IDeferredInstance| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Factory, die das untergeordnete Element erstellt. Sie können eins der folgenden Elemente angeben:
- Eine Factory-Klasse, die die IDeferredInstance-Schnittstelle implementiert und die untergeordnete(n) Instanz(en) erstellt.
- Eine Flex-Komponente (d. h. jede Unterklasse der UIComponent-Klasse), wie das Button-Steuerelement. Wenn Sie eine Flex-Komponente verwenden, schließt der Flex-Compiler die Komponente automatisch in eine Factory-Klasse ein.
Wenn Sie diese Eigenschaft eingestellt haben, wird das untergeordnete Element zu dem durch die creationPolicy-Eigenschaft bestimmten Zeitpunkt instanziiert.
Sie stellen diese Eigenschaft nicht ein, wenn Sie die target-Eigenschaft festlegen. Diese Eigenschaft ist die Standardeigenschaft der AddChild-Klasse. Das Einstellen dieser Eigenschaft mit dem creationPolicy-Wert „all“ entspricht dem Einstellen einer target-Eigenschaft.
Implementierung
public function get targetFactory():IDeferredInstance public function set targetFactory(value:IDeferredInstance):voidAddChild | () | Konstruktor |
public function AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild")| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
ParameterrelativeTo:UIComponent (default = null) | |
target:DisplayObject (default = null) | |
position:String (default = "lastChild")target-Komponente in der Anzeigeliste relativ zur relativeTo-Komponente. Muss einem der folgenden Werte entsprechen: „firstChild“, „lastChild“, „before“ oder „after“.
|
apply | () | Methode |
override public function apply(parent:UIComponent):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wendet die Überschreibung an. Flex speichert den ursprünglichen Wert, sodass dieser später in der remove()-Methode wiederhergestellt werden kann.
Diese Methode wird automatisch aufgerufen, wenn der Status eingegeben wird. Sie sollten diese Methode nicht direkt aufrufen.
Parameter
parent:UIComponent — Das übergeordnete Element des Statusobjekts mit dieser Überschreibung. Die Überschreibung sollte dies als Ziel verwenden, wenn kein explizites Ziel angegeben wurde.
|
createInstance | () | Methode |
public function createInstance():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Erstellt die untergeordnete Instanz aus der Factory. Verwenden Sie diese Methode nur, wenn Sie eine targetFactory-Eigenschaft angeben und den creationPolicy-Wert auf "none" setzen. Flex ruft diese Methode automatisch auf, wenn der Wert der creationPolicy-Eigenschaft auf "auto" oder "all" gesetzt ist. Wenn Sie diese Methode mehrmals aufrufen, wird die untergeordnete Instanz nur beim ersten Aufruf erstellt.
initialize | () | Methode |
override public function initialize():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
IOverride-Schnittstellenmethode; diese Klasse implementiert sie als leere Methode.
remove | () | Methode |
override public function remove(parent:UIComponent):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Entfernt die Überschreibung. Der in der apply()-Methode gespeicherte Wert wird wiederhergestellt.
Diese Methode wird automatisch aufgerufen, wenn der Status eingegeben wird. Sie sollten diese Methode nicht direkt aufrufen.
Parameter
parent:UIComponent — Das übergeordnete Element des Statusobjekts mit dieser Überschreibung. Die Überschreibung sollte dies als Ziel verwenden, wenn kein explizites Ziel angegeben wurde.
|
Tue Jun 12 2018, 10:04 AM Z