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.controls.treeClasses 

DefaultDataDescriptor  - AS3 Flex

Paketmx.controls.treeClasses
Klassepublic class DefaultDataDescriptor
VererbungDefaultDataDescriptor Inheritance Object
Implementiert ITreeDataDescriptor2, IMenuDataDescriptor

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

Die DefaultDataDescriptor-Klasse stellt eine in Tree- oder Menu-Steuerelementen verwendete Standardimplementierung für den Zugriff auf die Daten und ihre Verarbeitung bereit. Diese Implementierung behandelt e4x XML und Objektknoten auf ähnliche, aber doch unterschiedliche Weise. Sehen Sie sich die Beschreibung der einzelnen Methoden an, um Details über die Art des Zugriffs der Methode auf Werte in Knoten unterschiedlicher Art zu erfahren. Diese Klasse ist der Standardwert der dataDescriptor-Eigenschaften der Steuerelemente Tree, Menu, MenuBar und PopUpMenuButton.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
DefaultDataDescriptor
  
addChildAt(parent:Object, newChild:Object, index:int, model:Object = null):Boolean
Fügt einem Knoten an der angegebenen Indexposition einen untergeordneten Knoten hinzu.
DefaultDataDescriptor
  
Stellt den Zugriff auf die untergeordneten Knoten eines Knotens bereit.
DefaultDataDescriptor
  
getData(node:Object, model:Object = null):Object
Gibt die Daten eines Knotens zurück.
DefaultDataDescriptor
  
Gibt den Namen der Optionsfeld-Gruppe zurück, zu der der Knoten gehört, wenn eine solche vorhanden ist.
DefaultDataDescriptor
  
getHierarchicalCollectionAdaptor(hierarchicalData:ICollectionView, uidFunction:Function, openItems:Object, model:Object = null):ICollectionView
Gibt eine ICollectionView-Instanz zurück, die die hierarchischen Daten so anzeigt, als wären sie eine lineare ICollectionView-Instanz.
DefaultDataDescriptor
  
getNodeDepth(node:Object, iterator:IViewCursor, model:Object = null):int
Gibt die Tiefe des Knotens zurück, also die Anzahl seiner Vorgänger.
DefaultDataDescriptor
  
getParent(node:Object, collection:ICollectionView, model:Object = null):Object
Gibt den übergeordneten Knoten des Knotens zurück. Der übergeordnete Knoten eines Knotens der obersten Ebene ist null.
DefaultDataDescriptor
  
Gibt den Typbezeichner eines Knotens zurück.
DefaultDataDescriptor
  
hasChildren(node:Object, model:Object = null):Boolean
Ermittelt, ob der Knoten untergeordnete Knoten enthält.
DefaultDataDescriptor
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
isBranch(node:Object, model:Object = null):Boolean
Prüft, ob ein Knoten ein beendender Knoten ist.
DefaultDataDescriptor
  
Gibt zurück, ob der Knoten aktiviert ist.
DefaultDataDescriptor
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
Gibt zurück, ob der Knoten umgeschaltet ist.
DefaultDataDescriptor
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
removeChildAt(parent:Object, child:Object, index:int, model:Object = null):Boolean
Entfernt den untergeordneten Knoten an der angegebenen Indexposition.
DefaultDataDescriptor
  
Legt den Wert des Felds oder Attributs im Datenprovider fest, der angibt, ob der Knoten aktiviert ist.
DefaultDataDescriptor
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
Legt den Wert des Felds oder Attributs im Datenprovider fest, der angibt, ob der Knoten umgeschaltet ist.
DefaultDataDescriptor
 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
Konstruktordetails

DefaultDataDescriptor

()Konstruktor
public function DefaultDataDescriptor()

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

Konstruktor.

Methodendetails

addChildAt

()Methode
public function addChildAt(parent:Object, newChild:Object, index:int, model:Object = null):Boolean

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

Fügt einem Knoten an der angegebenen Indexposition einen untergeordneten Knoten hinzu. Diese Implementierung übernimmt folgende Aufgaben:

  • Wenn der parent-Parameter „null“ oder „undefined“ ist, wird der child-Parameter an der angegebenen Indexposition in der Sammlung eingefügt, die durch den model-Parameter angegeben wird.
  • Wenn der parent-Parameter ein Feld oder eine Eigenschaft children hat, fügt die Methode den child-Parameter an der Position des index-Parameters hinzu. In diesem Fall ist der model-Parameter nicht erforderlich.
  • Wenn der parent-Parameter kein Feld oder keine Eigenschaft children hat, fügt die Methode die children-Eigenschaft dem parent-Element hinzu. Danach fügt die Methode den child-Parameter dem übergeordneten Element an der index-Parameterposition hinzu. In diesem Fall ist der model-Parameter nicht erforderlich.
  • Wenn der index-Wert größer ist als die Sammlungslänge oder die Anzahl der untergeordneten Element im übergeordneten Element, wird das Objekt als letztes untergeordnetes Element hinzugefügt.

Parameter

parent:Object — Das Knotenobjekt, das dem untergeordneten Knoten übergeordnet ist.
 
newChild:Object — Das Knotenobjekt, dem der Knoten übergeordnet ist.
 
index:int — Auf null basierende Indexposition der Stelle, an der der untergerdnete Knoten relativ zum übergeordneten Knoten eingesetzt werden soll.
 
model:Object (default = null) — Die komplette Sammlung, zu der dieser Knoten gehört.

Rückgabewerte
Booleantrue, wenn erfolgreich.

getChildren

()Methode 
public function getChildren(node:Object, model:Object = null):ICollectionView

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

Stellt den Zugriff auf die untergeordneten Knoten eines Knotens bereit. Gibt eine Sammlung von untergeordneten Knoten zurück, wenn solche existieren. Wenn der Knoten ein Objekt ist, gibt die Methode den Inhalt des children-Felds des Objekts als ArrayCollection zurück. Wenn der Knoten XML ist, gibt die Methode ein XMLListCollection-Objekt zurück, das die untergeordneten Elemente enthält.

Parameter

node:Object — Das aktuell ausgewertete Knotenobjekt.
 
model:Object (default = null) — Die Sammlung, die den Knoten enthält; wird von dieser Klasse ignoriert.

Rückgabewerte
ICollectionView — Ein Objekt, das die untergeordneten Knoten enthält.

getData

()Methode 
public function getData(node:Object, model:Object = null):Object

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

Gibt die Daten eines Knotens zurück. Gibt derzeit den kompletten Knoten zurück.

Parameter

node:Object — Das aktuell ausgewertete Knotenobjekt.
 
model:Object (default = null) — Die Sammlung, die den Knoten enthält; wird von dieser Klasse ignoriert.

Rückgabewerte
Object — Der Knoten.

getGroupName

()Methode 
public function getGroupName(node:Object):String

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

Gibt den Namen der Optionsfeld-Gruppe zurück, zu der der Knoten gehört, wenn eine solche vorhanden ist. Diese Methode wird für Steuerelemente in Menüform verwendet.

Parameter

node:Object — Der Knoten, für den der Gruppenname abgerufen wird.

Rückgabewerte
String — Der Wert des groupName-Attributs bzw. -Felds des Knotens oder ein leerer String, wenn ein solcher Eintrag nicht vorhanden ist.

getHierarchicalCollectionAdaptor

()Methode 
public function getHierarchicalCollectionAdaptor(hierarchicalData:ICollectionView, uidFunction:Function, openItems:Object, model:Object = null):ICollectionView

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

Gibt eine ICollectionView-Instanz zurück, die die hierarchischen Daten so anzeigt, als wären sie eine lineare ICollectionView-Instanz.

Parameter

hierarchicalData:ICollectionView — Die hierarchischen Daten.
 
uidFunction:Function — Eine Funktion, die ein Objekt übernimmt und die UID als String zurückgibt. Dieser Parameter ist in der Regel die Tree.itemToUID()-Methode.
 
openItems:Object — Elemente, die geöffnet oder auf geöffnet gesetzt wurden.
 
model:Object (default = null) — Die Sammlung, zu der dieser Knoten gehört.

Rückgabewerte
ICollectionView — Eine ICollectionView-Instanz.

getNodeDepth

()Methode 
public function getNodeDepth(node:Object, iterator:IViewCursor, model:Object = null):int

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

Gibt die Tiefe des Knotens zurück, also die Anzahl seiner Vorgänger.

Parameter

node:Object — Das Objekt, das den Knoten definiert.
 
iterator:IViewCursor — Eine IViewCursor-Instanz, die für die Berechnung verwendet werden kann.
 
model:Object (default = null) — Die Sammlung, zu der dieser Knoten gehört.

Rückgabewerte
int — Die Tiefe des Knotens, wobei 0 der obersten Ebene entspricht und -1 angibt, dass die Tiefe nicht berechnet werden kann.

getParent

()Methode 
public function getParent(node:Object, collection:ICollectionView, model:Object = null):Object

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

Gibt den übergeordneten Knoten des Knotens zurück. Der übergeordnete Knoten eines Knotens der obersten Ebene ist null.

Parameter

node:Object — Das Objekt, das den Knoten definiert.
 
collection:ICollectionView — Eine ICollectionView-Instanz, die für die Berechnung verwendet werden kann.
 
model:Object (default = null) — Die Sammlung, zu der dieser Knoten gehört.

Rückgabewerte
Object — Der übergeordnete Knoten, dem der untergeordnete Knoten zugehört, null bei einem Knoten der obersten Ebene und undefined, wenn der übergeordnete Knoten nicht ermittelt werden kann.

getType

()Methode 
public function getType(node:Object):String

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

Gibt den Typbezeichner eines Knotens zurück. Diese Methode wird von Steuerelementen in Form von Menüs verwendet, um zu bestimmen, ob der Knoten ein Trennzeichen, ein Optionsfeld, ein Kontrollkästchen oder ein normales Element darstellt.

Parameter

node:Object — Das Knotenobjekt, für das der Typ abgerufen werden soll.

Rückgabewerte
String — Der Wert des type-Attributs oder -Felds bzw. ein leerer String, wenn ein solches Feld nicht vorhanden ist.

hasChildren

()Methode 
public function hasChildren(node:Object, model:Object = null):Boolean

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

Ermittelt, ob der Knoten untergeordnete Knoten enthält.

Parameter

node:Object — Das aktuell ausgewertete Knotenobjekt.
 
model:Object (default = null) — Die Sammlung, die den Knoten enthält; wird von dieser Klasse ignoriert.

Rückgabewerte
Booleantrue, wenn dieser Knoten aktuell untergeordnete Knoten enthält.

isBranch

()Methode 
public function isBranch(node:Object, model:Object = null):Boolean

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

Prüft, ob ein Knoten ein beendender Knoten ist. Verzweigungen sind nicht beendend, müssen aber keine Endknoten haben. Wenn der Knoten XML ist, wird true zurückgegeben, falls der Knoten untergeordnete Knoten oder ein true isBranch-Attribut hat. Wenn der Knoten ein Objekt ist, wird true zurückgegeben, wenn der Knoten ein (möglicherweise leeres) children-Feld hat.

Parameter

node:Object — Das aktuell ausgewertete Knotenobjekt.
 
model:Object (default = null) — Die Sammlung, die den Knoten enthält; wird von dieser Klasse ignoriert.

Rückgabewerte
Booleantrue, wenn dieser Knoten ein nicht beendender Knoten ist.

isEnabled

()Methode 
public function isEnabled(node:Object):Boolean

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

Gibt zurück, ob der Knoten aktiviert ist. Diese Methode wird für Steuerelemente in Menüform verwendet.

Parameter

node:Object — Der Knoten, für den der Status abgerufen werden soll.

Rückgabewerte
Boolean — Der Wert des enabled-Attributs oder -Felds des Knotens, bzw. true, wenn ein solcher Eintrag nicht vorhanden ist oder der Wert nicht false ist.

isToggled

()Methode 
public function isToggled(node:Object):Boolean

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

Gibt zurück, ob der Knoten umgeschaltet ist. Diese Methode wird für Steuerelemente in Menüform verwendet.

Parameter

node:Object — Der Knoten, für den der Status abgerufen werden soll.

Rückgabewerte
Boolean — Der Wert des toggledAttributs bzw. -Felds des Knotens oder false, wenn ein solcher Eintrag nicht vorhanden ist.

removeChildAt

()Methode 
public function removeChildAt(parent:Object, child:Object, index:int, model:Object = null):Boolean

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

Entfernt den untergeodneten Knoten an der angegebenen Indexposition. Wenn der parent-Parameter „null“ oder „undefined“ ist, verwendet die Methode den model-Parameter für den Zugriff auf den untergeordneten Knoten, ansonsten verwendet sie den parent-Parameter und ignoriert den model-Parameter.

Parameter

parent:Object — Das Knotenobjekt, das derzeit übergeordnete Knoten für den untergerdneten Knoten hat.
 
child:Object — Der Knoten, der entfernt wird.
 
index:int — Der auf null basierende Index des zu entfernenden, untergeordneten Knotens im Verhältnis zum übergeordneten Knoten.
 
model:Object (default = null) — Die komplette Sammlung, zu der dieser Knoten gehört.

Rückgabewerte
Booleantrue, wenn erfolgreich.

setEnabled

()Methode 
public function setEnabled(node:Object, value:Boolean):void

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

Legt den Wert des Felds oder Attributs im Datenprovider fest, der angibt, ob der Knoten aktiviert ist. Diese Methode legt den Wert des enabled-Attributs oder -Felds des Knotens fest. Diese Methode wird für Steuerelemente in Menüform verwendet.

Parameter

node:Object — Der Knoten, für den der Status festgelegt werden soll.
 
value:Boolean — Gibt zurück, ob der Knoten aktiviert ist.

setToggled

()Methode 
public function setToggled(node:Object, value:Boolean):void

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

Legt den Wert des Felds oder Attributs im Datenprovider fest, der angibt, ob der Knoten umgeschaltet ist. Diese Methode legt den Wert des toggled-Attributs oder -Felds des Knotens fest. Diese Methode wird für Steuerelemente in Menüform verwendet.

Parameter

node:Object — Der Knoten, für den der Status festgelegt werden soll.
 
value:Boolean — Gibt zurück, ob der Knoten umgeschaltet ist.





[ 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.