ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.states 

AddChild  - AS3 Flex

Paketmx.states
Klassepublic class AddChild
VererbungAddChild Inheritance OverrideBase Inheritance OnDemandEventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die AddChild-Klasse fügt dem Container als Teil eines Ansichtsstatus ein untergeordnetes Anzeigeobjekt, z. B. eine Komponente, hinzu. Sie verwenden diese Klasse in der 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-SyntaxexpandedMXML-Syntax ausblenden

The <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



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : 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
Öffentliche Methoden
 MethodeDefiniert von
  
AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild")
Konstruktor.
AddChild
 Inherited
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
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
OnDemandEventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
OnDemandEventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
[override] IOverride-Schnittstellenmethode; diese Klasse implementiert sie als leere Methode.
AddChild
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
[override] Entfernt die Überschreibung.
AddChild
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
OnDemandEventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
OnDemandEventDispatcher
Eigenschaftendetails

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:

WertBedeutung
auto(Standard) Erstellt die Instanz, wenn sie das erste Mal benötigt wird.
allErstellt die Instanz beim Start der Anwendung.
noneErstellt 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):void

position

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):void

targetFactory

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):void
Konstruktordetails

AddChild

()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.

Parameter
relativeTo:UIComponent (default = null) — Die Komponente, in Bezug auf die ein untergeordnetes Element hinzugefügt wird.
 
target:DisplayObject (default = null) — Das untergeordnete Objekt. Alle Flex-Komponenten sind Unterklassen der DisplayObject-Klasse.
 
position:String (default = "lastChild") — Die Position der target-Komponente in der Anzeigeliste relativ zur relativeTo-Komponente. Muss einem der folgenden Werte entsprechen: „firstChild“, „lastChild“, „before“ oder „after“.
Methodendetails

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.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.