GroupingField  - AS3 Flex

Définissez cette valeur sur true si le tri de ce champ ne doit pas être sensible à la casse.

La valeur par défaut est false.

Fonction comparant deux éléments lors d’un tri d’éléments pour la collection associée. Si vous spécifiez une propriété compareFunction dans un objet Grouping, Flex ignore les propriétés compareFunction des objets GroupingField.

La fonction de comparaison doit présenter la signature suivante :

function myCompare(a:Object, b:Object):int

Cette fonction doit renvoyer les valeurs suivantes :

• -1 si a apparaît avant b dans la séquence triée.
• 0 si a = b.
• 1 si a apparaît après b dans la séquence triée.

La valeur par défaut est une fonction de comparaison interne qui réalise une comparaison de chaîne, de nombre ou de date dans l’ordre croissant ou décroissant, en prenant ou non en compte la casse des chaînes. Spécifiez votre propre fonction uniquement si vous souhaitez disposer d’un algorithme de comparaison personnalisé. Normalement, cela est nécessaire uniquement lorsqu’un champ calculé est utilisé dans un affichage.

Définissez cette valeur sur true si le tri de ce champ doit être réalisé dans l’ordre décroissant.

La valeur par défaut est false.

Fonction déterminant le libellé de ce groupe. Par défaut, le groupe affiche le texte du champ correspondant au champ spécifié par la propriété nom dans les données. Cependant, il est parfois utile de regrouper les éléments en fonction de plusieurs champs présents dans les données ou en fonction d’un critère qui ne correspond pas à un champ de chaîne simple. Dans ce cas, spécifiez une fonction de rappel à l’aide de la propriété groupingFunction.

Une fonction de rappel peut convertir un nombre correspondant au mois en chaîne pour le mois, ou regrouper plusieurs éléments dans un groupe en fonction de certains critères autres que la valeur actuelle du champ.

Pour l’objet GroupField, la signature de la méthode se présente comme suit :

groupingFunction(item:Object, field:GroupField):String

Où item contient l’objet d’élément de données et field contient l’objet GroupField.

      private function groupFunc(item:Object, field:GroupingField):String
      {
          return item[field.name].toString().substr(0, 1);
      }
      

Fonction de rappel à exécuter sur chaque nœud du groupe pour déterminer l’objet de regroupement. Par défaut, un nouvel objet sera créé pour les nœuds du groupe.

Vous pouvez spécifier une fonction groupingObjectFunction fournissant l’objet adapté aux nœuds du groupe.

La signature de la méthode se présente comme suit :

      myGroupObjectFunction(label:String):Object

Où label contient la valeur qui sera affichée pour ce nœud du groupe. La fonction renvoie un objet qui sera utilisé pour les nœuds de groupe.

      private function groupObjFunction(label:String):Object
      {
          var obj:Object = {};
          obj.name = "Bob";
     
          return obj;
      }
      

Nom du champ à trier.

La valeur par défaut est null.

Force le comparateur à utiliser une comparaison numérique si le champ trié contient des valeurs numériques (number/int/uint) ou des représentations de chaîne de valeurs numériques. Si la valeur de cette propriété est false, les champs contenant des représentations de chaîne de nombres sont triés en comparant les chaînes. Ainsi, 100 précède 99, car "1" est une valeur de chaîne inférieure à "9".

La valeur par défaut est false.

Tableau d’instances SummaryRow définissant les résumés au niveau du groupe. 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:GroupingCollection id="gc" source="{dpFlat}">
                 <mx:Grouping>
                     <mx:GroupingField name="Region">
                       <mx:summaries>
                           <mx:SummaryRow summaryPlacement="group">
                             <mx:fields>
                                 <mx:SummaryField dataField="Actual" 
                                     label="Min Actual" operation="MIN"/>
                                 <mx:SummaryField dataField="Actual" 
                                     label="Max Actual" operation="MAX"/>
                             </mx:fields>
                           </mx:SummaryRow>
                         </mx:summaries>
                     </mx:GroupingField>
                 </mx:Grouping>
             </mx:GroupingCollection>
         </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

Constructeur.