| Paket | mx.collections |
| Klasse | public class GroupingCollection2 |
| Vererbung | GroupingCollection2  HierarchicalData EventDispatcher Object |
| Implementiert | IGroupingCollection2 |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Hinweis: In der vorherigen Flex-Version wurde die GroupingCollection-Klasse mit dem AdvancedDataGrid-Steuerelement verwendet. Die GroupingCollection2-Klasse ist in Flex 4 neu. Sie ist leistungsfähiger als die GroupingCollection.
Um das AdvancedDataGrid-Steuerelement mit gruppierten Daten auszufüllen, erstellen Sie aus den flachen Daten eine Instanz der GroupingCollection2-Klasse und übergeben dann diese GroupingCollection2-Instanz an den Datenprovider des AdvancedDataGrid-Steuerelements. Um die Gruppierungsfelder der flachen Daten anzugeben, übergeben Sie eine Grouping-Instanz an die GroupingCollection2.grouping-Eigenschaft. Die Grouping-Instanz enthält ein Array von GroupingField-Instanzen, eine pro Gruppierungsfeld.
Das folgende Beispiel verwendet die GroupingCollection2-Klasse zur Definition von zwei Gruppierungsfeldern: „Region“ und „Territory“.
<mx:AdvancedDataGrid id="myADG"
<mx:dataProvider>
<mx:GroupingCollection2 id="gc" source="{dpFlat}">
<mx:grouping>
<mx:Grouping>
<mx:GroupingField name="Region"/>
<mx:GroupingField name="Territory"/>
</mx:Grouping>
</mx:grouping>
</mx:GroupingCollection2>
</mx:dataProvider>
<mx:columns>
<mx:AdvancedDataGridColumn dataField="Region"/>
<mx:AdvancedDataGridColumn dataField="Territory"/>
<mx:AdvancedDataGridColumn dataField="Territory_Rep"/>
<mx:AdvancedDataGridColumn dataField="Actual"/>
<mx:AdvancedDataGridColumn dataField="Estimate"/>
</mx:columns>
</mx:AdvancedDataGrid>
MXML-Syntax
MXML-Syntax anzeigen
MXML-Syntax ausblenden<mx.GroupingCollection2> inherits all the tag attributes of its superclass,
and defines the following tag attributes:
<mx:GroupingCollection2
Properties
grouping="No default"
source="No default"
summaries="No default"
/>
Standard-MXML-Eigenschaftgrouping
Verwandte API-Elemente
| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | childrenField : String
Gibt den Feldnamen an, der zur Erkennung von untergeordneten Objekten in einem Datenelement verwendet werden soll. | HierarchicalData | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| grouping : Grouping
Gibt die auf die Quelldaten angewendete Grouping-Instanz an. | GroupingCollection2 | ||
| source : Object [override]
Die Quellsammlung, die die zu gruppierenden flachen Daten enthält. | GroupingCollection2 | ||
| summaries : Array
Array von SummaryRow-Instanzen, die alle Datenübersichten auf Stammebene definieren. | GroupingCollection2 | ||
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| timer : flash.utils:Timer
Der Timer, der einem asynchronen Aktualisierungsvorgang zugeordnet ist. | GroupingCollection2 | ||
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | GroupingCollection2 | ||
| 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 | |
Wenn eine asynchrone Aktualisierung durchgeführt wird, wird der Aktualisierungsvorgang abgebrochen und die Erstellung der Gruppen gestoppt. | GroupingCollection2 | ||
|
Gibt „true“ zurück, wenn der Knoten untergeordnete Knoten enthalten kann. | HierarchicalData | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Gibt ein Objekt zurück, das die untergeordneten Knoten des Knotens darstellt. | HierarchicalData | |
|
Gibt Daten aus einem Knoten zurück. | HierarchicalData | |
[override]
Gibt „super.source“ zurück, wenn die Grouping-Eigenschaft eingerichtet ist, und andernfalls eine ICollectionView-Instanz, die auf „super.source“ verweist. | GroupingCollection2 | ||
|
Gibt „true“ zurück, wenn der Knoten untergeordnete Knoten enthält. | HierarchicalData | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
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 | |
Wendet die Gruppierung auf die Sammlung an. | GroupingCollection2 | ||
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
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. | EventDispatcher | |
| Methode | Definiert von | ||
|---|---|---|---|
Gibt das übergeordnete Element eines Knotens zurück. | GroupingCollection2 | ||
grouping | Eigenschaft |
grouping:Grouping| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die auf die Quelldaten angewendete Grouping-Instanz an. Durch das Einrichten der grouping-Eigenschaft wird nicht automatisch die Ansicht aktualisiert. Sie müssen die refresh()-Methode nach dem Einrichten der Eigenschaft aufrufen.
Implementierung
public function get grouping():Grouping public function set grouping(value:Grouping):voidVerwandte API-Elemente
source | Eigenschaft |
source:Object[override] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Quellsammlung, die die zu gruppierenden flachen Daten enthält. Wenn die Quelle keine Sammlung ist, wird sie automatisch in eine Sammlung eingeschlossen.
Implementierung
override public function get source():Object override public function set source(value:Object):voidsummaries | Eigenschaft |
public var summaries:Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Array von SummaryRow-Instanzen, die alle Datenübersichten auf Stammebene definieren. Gibt einen oder mehrere SummaryRow-Instanzen an, um die Datenübersichten zu definieren, wie im folgenden Beispiel:
<mx:AdvancedDataGrid id="myADG"
width="100%" height="100%"
initialize="gc.refresh();">
<mx:dataProvider>
<mx:GroupingCollection2 id="gc" source="{dpFlat}">
<mx:summaries>
<mx:SummaryRow summaryPlacement="last">
<mx:fields>
<mx:SummaryField2 dataField="Actual"
label="Min Actual" summaryOperation="MIN"/>
<mx:SummaryField2 dataField="Actual"
label="Max Actual" summaryOperation="MAX"/>
</mx:fields>
</mx:SummaryRow>
</mx:summaries>
<mx:Grouping>
<mx:GroupingField name="Region"/>
<mx:GroupingField name="Territory"/>
</mx:Grouping>
</mx:GroupingCollection2>
</mx:dataProvider>
<mx:columns>
<mx:AdvancedDataGridColumn dataField="Region"/>
<mx:AdvancedDataGridColumn dataField="Territory_Rep"
headerText="Territory Rep"/>
<mx:AdvancedDataGridColumn dataField="Actual"/>
<mx:AdvancedDataGridColumn dataField="Estimate"/>
<mx:AdvancedDataGridColumn dataField="Min Actual"/>
<mx:AdvancedDataGridColumn dataField="Max Actual"/>
</mx:columns>
</mx:AdvancedDataGrid>
Verwandte API-Elemente
timer | Eigenschaft |
protected var timer:flash.utils:Timer| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Timer, der einem asynchronen Aktualisierungsvorgang zugeordnet ist. Sie können mit ihm das Zeitintervall ändern, die Aktualisierung unterbrechen oder andere Aktionen durchführen. Der Standardwert für die delay-Eigenschaft der Timer-Instanz ist 1. Dies entspricht 1 Millisekunde.
GroupingCollection2 | () | Konstruktor |
public function GroupingCollection2()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
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.
getParent | () | Methode |
protected function getParent(node:Object):*| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.
|
* — 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.
|
getRoot | () | Methode |
override public function getRoot():Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt super.source zurück, wenn die grouping-Eigenschaft angegeben wurde, und andernfalls eine ICollectionView-Instanz, die auf super.source verweist.
Object — Das zurückzugebende Objekt.
|
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)true, wird die Aktualisierung als asynchron definiert. Standardmäßig ist dies der Parameter false zur Angabe einer synchronen Aktualisierung.
| |
dispatchCollectionEvents:Boolean (default = false)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.
|
Boolean — true, 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.
|
Tue Jun 12 2018, 10:04 AM Z