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

HierarchicalCollectionView  - AS3 Flex

Paketmx.collections
Klassepublic class HierarchicalCollectionView
VererbungHierarchicalCollectionView Inheritance EventDispatcher Inheritance Object
Implementiert IHierarchicalCollectionView, IXMLNotifiable

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

Die HierarchicalCollectionView-Klasse stellt eine hierarchische Ansicht einer Standardsammlung bereit.

MXML-SyntaxexpandedMXML-Syntax ausblenden
The <mx.HierarchicalCollectionView> inherits all the tag attributes of its superclass, and defines the following tag attributes:

  <mx:HierarchicalCollectionView
  Properties 
    showRoot="true|false"
    source="No default"
  />
  


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  hasRoot : Boolean
[schreibgeschützt] Ein Flag, das beim Wert „true“ anzeigt, dass der derzeitige Datenprovider einen Stammknoten hat. Beispiel: Ein einzelner Knoten auf oberster Ebene in einer hierarchischen Struktur.
HierarchicalCollectionView
  length : int
[schreibgeschützt] Die Länge der derzeit analysierten Sammlung.
HierarchicalCollectionView
  openNodes : Object
Ein Objektarray, das das Datenproviderelement für alle offenen Verzweigungsknoten der Daten enthält.
HierarchicalCollectionView
  showRoot : Boolean
Ein Boolesches Flag, das festlegt, ob der Stammknoten des Datenproviders angezeigt wird.
HierarchicalCollectionView
  source : IHierarchicalData
Die Quelldaten von IHierarchicalCollectionView.
HierarchicalCollectionView
Öffentliche Methoden
 MethodeDefiniert von
  
HierarchicalCollectionView(hierarchicalData:IHierarchicalData = null, argOpenNodes:Object = null)
Konstruktor.
HierarchicalCollectionView
  
addChild(parent:Object, newChild:Object):Boolean
Fügt einem Datenknoten einen untergeordneten Knoten hinzu.
HierarchicalCollectionView
  
addChildAt(parent:Object, newChild:Object, index:int):Boolean
Fügt einem Knoten an der angegebenen Indexposition einen untergeordneten Knoten hinzu.
HierarchicalCollectionView
 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.
EventDispatcher
  
Schließt einen Knoten, um seine untergeordneten Elemente auszublenden.
HierarchicalCollectionView
  
Prüft die Sammlung mithilfe eines Standardgleichheitstests auf das Datenelement.
HierarchicalCollectionView
  
Gibt eine neue Instanz eines Ansichtsiterators über die Elemente in dieser Ansicht zurück.
HierarchicalCollectionView
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
Gibt eine Sammlung von untergeordneten Elementen zurück, sofern vorhanden.
HierarchicalCollectionView
  
Gibt die Tiefe des Knotens in der Sammlung zurück.
HierarchicalCollectionView
  
Gibt das übergeordnete Element eines Knotens zurück.
HierarchicalCollectionView
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
Öffnet einen Knoten, um seine untergeordneten Elemente anzuzeigen.
HierarchicalCollectionView
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Wendet die Sortierung und den Filter auf die Ansicht an.
HierarchicalCollectionView
  
Entfernt den untergeordneten Knoten aus dem übergeordneten Knoten.
HierarchicalCollectionView
  
Entfernt den untergeordneten Knoten an der angegebenen Indexposition.
HierarchicalCollectionView
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 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.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Eigenschaftendetails

hasRoot

Eigenschaft
hasRoot:Boolean  [schreibgeschützt]

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

Ein Flag, das beim Wert true anzeigt, dass der derzeitige Datenprovider einen Stammknoten hat. Beispiel: Ein einzelner Knoten auf oberster Ebene in einer hierarchischen Struktur. „XML“ und „Object“ sind Beispiele für Datentypen, die einen Stammknoten haben, während die List- und Arraydatentypen keinen Stammknoten haben.



Implementierung
    public function get hasRoot():Boolean

length

Eigenschaft 
length:int  [schreibgeschützt]

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

Die Länge der derzeit analysierten Sammlung.



Implementierung
    public function get length():int

openNodes

Eigenschaft 
openNodes:Object

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

Ein Objektarray, das das Datenproviderelement für alle offenen Verzweigungsknoten der Daten enthält.



Implementierung
    public function get openNodes():Object
    public function set openNodes(value:Object):void

showRoot

Eigenschaft 
showRoot:Boolean

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

Ein boolesches Flag, das angibt, ob der Stammknoten des Datenproviders angezeigt werden soll. Wenn die Quelldaten einen Stammknoten haben und diese Eigenschaft auf false gesetzt ist, bezieht die Sammlung das Stammelement nicht ein. Nur die untergeordneten Elemente des Stammelements werden in die Sammlung einbezogen.

Diese Eigenschaft hat keine Auswirkungen auf eine Quelle ohne Stammknoten, wie z. B. List- und Arrayobjekte.

Der Standardwert ist true.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get showRoot():Boolean
    public function set showRoot(value:Boolean):void

source

Eigenschaft 
source:IHierarchicalData

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

Die Quelldaten von IHierarchicalCollectionView.



Implementierung
    public function get source():IHierarchicalData
    public function set source(value:IHierarchicalData):void
Konstruktordetails

HierarchicalCollectionView

()Konstruktor
public function HierarchicalCollectionView(hierarchicalData:IHierarchicalData = null, argOpenNodes:Object = null)

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

Konstruktor.

Parameter
hierarchicalData:IHierarchicalData (default = null) — Die Datenstruktur mit den hierarchischen Daten.
 
argOpenNodes:Object (default = null) — Das Objekt, das einen Knoten definiert, der als geöffnet angezeigt werden soll.
Methodendetails

addChild

()Methode
public function addChild(parent:Object, newChild:Object):Boolean

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

Fügt einem Datenknoten einen untergeordneten Knoten hinzu.

Parameter

parent:Object — Das Objekt, das den übergeordneten Knoten definiert.
 
newChild:Object — Das Objekt, das den neuen Knoten definiert.

Rückgabewerte
Booleantrue, wenn der Knoten erfolgreich hinzugefügt wurde.

addChildAt

()Methode 
public function addChildAt(parent:Object, newChild:Object, index:int):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 index-Position in der Sammlung eingefügt, die durch den source-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 source-Parameter nicht erforderlich.
  • Wenn der parent-Parameter kein Feld oder keine Eigenschaft children hat, fügt die Methode den children-Parameter dem parent-Element hinzu. Danach fügt die Methode den child-Parameter dem übergeordneten Element an der index-Position hinzu. In diesem Fall ist der source-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 Objekt, das den übergeordneten Knoten definiert.
 
newChild:Object — Das Objekt, das den untergeordneten Knoten definiert.
 
index:int — Der auf null basierende Index für die Einfügung des untergeordneten Knotens.

Rückgabewerte
Booleantrue, wenn der untergeordnete Knoten erfolgreich hinzugefügt wurde.

closeNode

()Methode 
public function closeNode(node:Object):void

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

Schließt einen Knoten, um seine untergeordneten Elemente auszublenden.

Parameter

node:Object — Das Objekt, das den Knoten definiert.

contains

()Methode 
public function contains(item:Object):Boolean

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

Prüft die Sammlung mithilfe eines Standardgleichheitstests auf das Datenelement.

Parameter

item:Object — Das Objekt, das den zu suchenden Knoten definiert.

Rückgabewerte
Booleantrue, wenn das Datenelement in der Sammlung enthalten ist, andernfalls false.

createCursor

()Methode 
public function createCursor():IViewCursor

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

Gibt eine neue Instanz eines Ansichtsiterators über die Elemente in dieser Ansicht zurück.

Rückgabewerte
IViewCursor — IViewCursor-Instanz.

Verwandte API-Elemente

mx.utils.IViewCursor

getChildren

()Methode 
public function getChildren(node:Object):ICollectionView

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

Gibt eine Sammlung von untergeordneten Elementen zurück, sofern vorhanden.

Parameter

node:Object — Das Objekt, das den Knoten definiert. Falls null, wird eine Sammlung von Knoten der obersten Ebene zurückgegeben.

Rückgabewerte
ICollectionView — ICollectionView-Instanz, die die untergeordneten Knoten enthält.

getNodeDepth

()Methode 
public function getNodeDepth(node:Object):int

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

Gibt die Tiefe des Knotens in der Sammlung zurück.

Parameter

node:Object — Das Objekt, das den Knoten definiert.

Rückgabewerte
int — Die Tiefe des Knotens.

getParentItem

()Methode 
public function getParentItem(node:Object):*

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

Gibt das übergeordnete Element eines Knotens zurück. Der übergeordnete Knoten eines Knotens der obersten Ebene ist null.

Parameter

node:Object — Das Objekt, das den Knoten definiert.

Rückgabewerte
* — Der übergeordnete Knoten, der den untergeordneten Knoten enthält, null bei einem Knoten der obersten Ebene und undefined, wenn der übergeordnete Knoten nicht ermittelt werden kann.

openNode

()Methode 
public function openNode(node:Object):void

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

Öffnet einen Knoten, um seine untergeordneten Elemente anzuzeigen.

Parameter

node:Object — Das Objekt, das den Knoten definiert.

refresh

()Methode 
public function refresh():Boolean

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

Wendet die Sortierung und den Filter auf die Ansicht an. Die ICollectionView erkennt Änderungen einer Gruppe nicht automatisch. Daher müssen Sie die refresh()-Methode aufrufen, um die Ansicht nach dem Einrichten der Eigenschaften sort oder filterFunction zu aktualisieren. Wenn Ihre ICollectionView-Implementierung auch die IMXMLObject-Schnittstelle implementiert, sollten Sie die refresh()-Methode von der initialized()-Methode aus aufrufen.

Gibt true zurück, wenn die Aktualisierung erfolgreich war und false, wenn die Sortierung noch nicht abgeschlossen wurde (d. h. es stehen noch Elemente aus). Ein Client der Ansicht sollte auf ein CollectionEvent-Ereignis mit der Eigenschaft CollectionEventKind.REFRESH kind warten, um sicherzustellen, dass der refresh()-Vorgang abgeschlossen wurde.

Rückgabewerte
Booleantrue, wenn refresh() abgeschlossen wurde, false, wenn refresh() nicht abgeschlossen wurde.

removeChild

()Methode 
public function removeChild(parent:Object, child:Object):Boolean

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

Entfernt den untergeordneten Knoten aus dem übergeordneten Knoten.

Parameter

parent:Object — Das Objekt, das den übergeordneten Knoten definiert, und null für Knoten der obersten Ebene.
 
child:Object — Das Objekt, das den untergeordneten Knoten definiert, der entfernt werden soll.

Rückgabewerte
Booleantrue, wenn der Knoten erfolgreich entfernt wurde.

removeChildAt

()Methode 
public function removeChildAt(parent:Object, index:int):Boolean

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

Entfernt den untergeordneten Knoten an der angegebenen Indexposition.

Parameter

parent:Object — Das Objekt, das den übergeordneten Knoten definiert.
 
index:int — Der auf null basierende Index des zu entfernenden, untergeordneten Knotens im Verhältnis zum übergeordneten Knoten.

Rückgabewerte
Booleantrue, wenn der untergeordnete Knoten erfolgreich entfernt 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.