GroupingCollection2  - AS3 Flex

Spécifie l’instance Grouping appliquée aux données source. Le fait de définir la propriété grouping n’actualise pas automatiquement la vue. Par conséquent, vous devez appeler la méthode refresh() après avoir défini cette propriété.

Eléments de l’API associés

Collection source contenant les données à plat à regrouper. Si la source n’est pas une collection, elle sera automatiquement enveloppée dans une collection.

Tableau d’instances SummaryRow définissant un résumé de données au niveau racine. Spécifiez une ou plusieurs instances SummaryRow pour définir les résumés de données, comme l’illustre l’exemple suivant :

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

Eléments de l’API associés

Minuteur associé à une opération d’actualisation asynchrone. Vous pouvez l’utiliser pour modifier l’intervalle de temporisation, suspendre l’actualisation ou réaliser différentes actions. La valeur par défaut de la propriété delay de l’instance Timer est 1, ce qui correspond à 1 milliseconde.

Constructeur.

Si l’actualisation est réalisée de manière asynchrone, l’opération d’actualisation est annulée et la construction des groupes est arrêtée. Cette méthode annule l’actualisation uniquement si elle est initiée par un appel de la méthode refresh() utilisant un argument asynch de true, ce qui correspond à une actualisation asynchrone.

Renvoie le parent d’un nœud. Le parent d’un nœud de niveau supérieur est null.

Paramètres

Renvoie super.source si la propriété grouping est définie. SI cette propriété n’est pas définie, renvoie une instance ICollectionView faisant référence à super.source.

Applique le regroupement à la collection. La collection ne détecte pas automatiquement les modifications apportées à un groupe. Par conséquent, vous devez appeler la méthode refresh() pour actualiser la collection après avoir défini les propriétés grouping , source ou summaries Vous pouvez également appeler la méthode refresh() lorsque vous modifiez un GroupingField de la collection, en modifiant les propriétés caseInsensitive, compareFunction ou groupingFunction.

La méthode refresh() peut être appliquée en mode synchrone ou asynchrone.

Lorsque la méthode refresh() est appelée en mode synchrone, tous les groupes et les résumés sont mis à jour ensemble avant le renvoi de la méthode. Cela signifie que votre application ne peut pas effectuer d’autres opérations de traitement pour la durée de l’appel. Un client doit attendre qu’un événement CollectionEvent dont la propriété kind est définie sur CollectionEventKind.REFRESH soit généré pour faire en sorte que la méthode refresh() aboutisse.

Dans une opération d’actualisation asynchrone, tous les groupes et les résumés sont mis à jour individuellement. La méthode refresh() est renvoyée avant la mise à jour des groupes et des résumés de façon à ce que l’exécution de votre application puisse continuer. Par ailleurs, le contrôle est mis à jour lors de l’actualisation afin que l’utilisateur puisse continuer à interagir avec ce dernier.

Le temps système de mise à jour individuelle des groupes et des résumés, plutôt que toutes en même temps, allonge le délai de l’actualisation asynchrone par rapport à une actualisation synchrone. Cependant, pour les grands ensembles de données, votre application continue de fonctionner lors de l’actualisation.

Paramètres