Package | mx.collections |
Classe | public class GroupingField |
Héritage | GroupingField Object |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour que des données groupées viennent remplir le contrôle AdvancedDataGrid, créez une instance de la classe GroupingCollection à partir des données à plat, puis transmettez cette instance GroupingCollection au fournisseur de données du contrôle AdvancedDataGrid. Pour spécifier les champs de regroupement des données à plat, transmettez une instance Grouping à la propriété GroupingCollection.grouping
. L’instance Grouping contient un tableau d’instances GroupingField (une par champ de regroupement).
L’exemple suivant utilise la classe Grouping pour définir deux champs de regroupement : Region et Territory.
<mx:AdvancedDataGrid id="myADG" <mx:dataProvider> <mx:GroupingCollection id="gc" source="{dpFlat}"> <mx:grouping> <mx:Grouping> <mx:GroupingField name="Region"/> <mx:GroupingField name="Territory"/> </mx:Grouping> </mx:grouping> </mx:GroupingCollection> </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>Syntaxe MXMLMasquer la syntaxe MXML
<mx.GroupingField>
inherits all the tag attributes of its superclass,
and defines the following tag attributes:
<mx:GroupingField Properties caseInsensitive="false|true" compareFunction="No default" descending="false|true" groupingFunction="No default" groupingObjectFunction="No default" name="null" numeric="false|true" summaries="No default" />
Propriété MXML par défautsummaries
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
caseInsensitive : Boolean
Définissez cette valeur sur true si le tri de ce champ ne doit pas être sensible à la casse. | GroupingField | ||
compareFunction : Function
Fonction comparant deux éléments lors d’un tri d’éléments pour la collection associée. | GroupingField | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
descending : Boolean
Définissez cette valeur sur true si le tri de ce champ doit être réalisé dans l’ordre décroissant. | GroupingField | ||
groupingFunction : Function
Fonction déterminant le libellé de ce groupe. | GroupingField | ||
groupingObjectFunction : Function
Fonction de rappel à exécuter sur chaque nœud du groupe pour déterminer l’objet de regroupement. | GroupingField | ||
name : String
Nom du champ à trier. | GroupingField | ||
numeric : Boolean
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. | GroupingField | ||
summaries : Array
Tableau d’instances SummaryRow définissant les résumés au niveau du groupe. | GroupingField |
Méthode | Défini par | ||
---|---|---|---|
GroupingField(name:String = null, caseInsensitive:Boolean = false, descending:Boolean = false, numeric:Boolean = false)
Constructeur. | GroupingField | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
caseInsensitive | propriété |
caseInsensitive:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Implémentation
public function get caseInsensitive():Boolean
public function set caseInsensitive(value:Boolean):void
compareFunction | propriété |
compareFunction:Function
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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 avantb
dans la séquence triée. - 0 si
a
=b
. - 1 si
a
apparaît aprèsb
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.
Implémentation
public function get compareFunction():Function
public function set compareFunction(value:Function):void
descending | propriété |
descending:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Implémentation
public function get descending():Boolean
public function set descending(value:Boolean):void
groupingFunction | propriété |
public var groupingFunction:Function
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
groupingFunction
renvoyant le premier caractère comme nom de groupe peut être écrite comme suit :
private function groupFunc(item:Object, field:GroupingField):String { return item[field.name].toString().substr(0, 1); }
groupingObjectFunction | propriété |
public var groupingObjectFunction:Function
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.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.
groupingObjectFunction
renvoyant un objet contenant une propriété "name" dont la valeur est "Bob" peut être écrite comme suit :
private function groupObjFunction(label:String):Object { var obj:Object = {}; obj.name = "Bob"; return obj; }
name | propriété |
numeric | propriété |
numeric:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Implémentation
public function get numeric():Boolean
public function set numeric(value:Boolean):void
summaries | propriété |
public var summaries:Array
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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
GroupingField | () | Constructeur |
public function GroupingField(name:String = null, caseInsensitive:Boolean = false, descending:Boolean = false, numeric:Boolean = false)
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
Paramètresname:String (default = null ) — Nom de la propriété utilisée par ce champ dans le cadre de la comparaison. Si l’objet est de type simple, transmettez la valeur null .
| |
caseInsensitive:Boolean (default = false ) — Lors du tri de chaînes, indique au comparateur s’il faut ignorer la casse des valeurs.
| |
descending:Boolean (default = false ) — Indique au comparateur si les éléments doivent être classés dans l’ordre décroissant.
| |
numeric:Boolean (default = false ) — Indique au comparateur si les éléments de tri doivent être comparés en tant que nombres et non selon l’ordre alphabétique.
|
Tue Jun 12 2018, 09:30 AM Z