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 

IGroupingCollection2  - AS3 Flex

Paketmx.collections
Schnittstellepublic interface IGroupingCollection2 extends IHierarchicalData , IEventDispatcher
Umsetzer GroupingCollection2

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die IGroupingCollection2-Schnittstelle definiert die Schnittstelle, die erforderlich ist, um aus flachen Daten gruppierte Daten zu erstellen.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  grouping : Grouping
Das auf die Quelldaten angewendete Grouping-Objekt.
IGroupingCollection2
Öffentliche Methoden
 MethodeDefiniert von
 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.
IEventDispatcher
  
Wenn eine asynchrone Aktualisierung durchgeführt wird, wird der Aktualisierungsvorgang abgebrochen und die Erstellung der Gruppen gestoppt.
IGroupingCollection2
 Inherited
Gibt „true“ zurück, wenn der Knoten untergeordnete Knoten enthalten kann.
IHierarchicalData
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
IEventDispatcher
 Inherited
Gibt ein Objekt zurück, das die untergeordneten Knoten des Knotens darstellt.
IHierarchicalData
 Inherited
Gibt Daten aus einem Knoten zurück.
IHierarchicalData
 Inherited
Gibt das Stammdatenelement zurück.
IHierarchicalData
 Inherited
Gibt „true“ zurück, wenn der Knoten untergeordnete Knoten enthält.
IHierarchicalData
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
IEventDispatcher
  
refresh(async:Boolean = false, dispatchCollectionEvents:Boolean = false):Boolean
Wendet die Gruppierung auf die Sammlung an.
IGroupingCollection2
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
IEventDispatcher
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
IEventDispatcher
Eigenschaftendetails

grouping

Eigenschaft
grouping:Grouping

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Das auf die Quelldaten angewendete Grouping-Objekt. Durch das Einrichten dieser Eigenschaft wird die Ansicht nicht automatisch aktualisiert. Sie müssen daher nach dem Einrichten dieser Eigenschaft die refresh()-Methode aufrufen.

Hinweis: Die Flex-Implementierungen der IGroupingCollection2 rufen alle Elemente von einer Remote-Position ab, bevor die Gruppierung durchgeführt wird.



Implementierung
    public function get grouping():Grouping
    public function set grouping(value:Grouping):void
Methodendetails

cancelRefresh

()Methode
public function cancelRefresh():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 10, AIR 1.5

Wenn eine asynchrone Aktualisierung durchgeführt wird, wird der Aktualisierungsvorgang abgebrochen und die Erstellung der Gruppen gestoppt. Diese Methode bricht die Aktualisierung nur ab, wenn sie durch einen Aufruf der refresh()-Methode mit dem Argument asynch = true gestartet wurde, was einer asynchronen Aktualisierung entspricht.

refresh

()Methode 
public function refresh(async:Boolean = false, dispatchCollectionEvents:Boolean = false):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 10, AIR 1.5

Wendet die Gruppierung auf die Sammlung an. Die Sammlung erkennt Änderungen einer Gruppe nicht automatisch. Daher müssen Sie die refresh()-Methode aufrufen, um die Sammlung nach dem Einrichten der grouping-, source- oder summaries-Eigenschaft zu aktualisieren. Sie rufen die refresh()-Methode auch auf, wenn Sie ein GroupingField der Sammlung modifizieren, z. B. indem Sie die caseInsensitive-, compareFunction- oder groupingFunction-Eigenschaften ändern.

Die refresh()-Methode kann synchron oder asynchron angewendet werden.

Wenn refresh() synchron aufgerufen wird, werden alle Gruppen und Übersichten gemeinsam aktualisiert, bevor die Methode die Steuerung an die Anwendung zurückgibt. Dies bedeutet, dass Ihre Anwendung während der Dauer des Aufrufs keine Verarbeitungsvorgänge ausführen kann. Ein Client sollte auf ein CollectionEvent-Ereignis warten, dessen kind-Eigenschaft den Wert CollectionEventKind.REFRESH hat, um sicherzustellen, dass die refresh()-Methode abgeschlossen wurde.

Bei asynchroner Aktualisierung werden alle Gruppen und Übersichten einzeln aktualisiert. Die refresh()-Methode wird wieder verfügbar, bevor die Gruppen und Übersichten aktualisiert werden, sodass Ihre Anwendung mit der Ausführung fortfahren kann. Außerdem wird während dieser Aktualisierung das Steuerelement aktualisiert, sodass weiterhin Benutzerinteraktionen mit ihm möglich sind.

Der Aufwand für die jeweils individuelle Aktualisierung von Gruppen und Übersichten führt dazu, dass die asynchrone Aktualisierung länger dauert als die synchrone. Bei großen Datensätzen ist die Anwendung während der Aktualisierung jedoch weiterhin funktionsfähig.

Parameter

async:Boolean (default = false) — Wenn true, wird die Aktualisierung als asynchron definiert. Standardmäßig ist dies der Parameter false zur Angabe einer synchronen Aktualisierung.
 
dispatchCollectionEvents:Boolean (default = false) — Wenn true, werden Ereignisse ausgelöst, wenn Gruppen gebildet werden. Um die Leistung zu verbessern, setzen Sie die Einstellung auf false. Bei true werden Ereignisse in Gruppen ausgelöst und Übersichten werden synchron berechnet, um das Steuerelement zu aktualisieren. Hinweis: Wenn async den Wert true hat, wird dispatchCollectionEvents immer auf true gesetzt. Standardmäßig ist dies der Parameter false, durch den angegeben wird, dass keine Ereignisse ausgelöst werden.

Rückgabewerte
Booleantrue, wenn die refresh()-Methode abgeschlossen wurde, und false, wenn der Aktualisierungsvorgang noch nicht abgeschlossen wurde, d. h. dass die Bearbeitung von Elementen möglicherweise noch aussteht.




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