GroupingCollection2  - AS3 Flex

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.

Verwandte API-Elemente

Die Quellsammlung, die die zu gruppierenden flachen Daten enthält. Wenn die Quelle keine Sammlung ist, wird sie automatisch in eine Sammlung eingeschlossen.

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

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.

Konstruktor.

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.

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

Parameter

Gibt super.source zurück, wenn die grouping-Eigenschaft angegeben wurde, und andernfalls eine ICollectionView-Instanz, die auf super.source verweist.

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