Sort  - AS3 Flex

Méthode utilisée pour comparer des éléments lors du tri. Si vous spécifiez cette propriété, Flex ignore les propriétés compareFunction que vous spécifiez dans les objets ISortField utilisés dans cette classe.

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

     
         function [name](a:Object, b:Object, fields:Array = null):int
     
      

Cette fonction doit renvoyer les valeurs suivantes : value:

• -1, si Object a doit apparaître avant Object b dans l’ordre de tri.
• 0, si Object a est égal à Object b.
• 1, si Object a doit apparaître après Object b dans l’ordre de tri.

Pour renvoyer à la fonction de comparaison interne, définissez cette valeur sur null.

Le tableau fields spécifie les champs d’objet à comparer. En général, l’algorithme compare les propriétés jusqu’à ce que la fin de la liste des champs soit atteinte ou jusqu’à ce qu’une valeur autre que zéro puisse être renvoyée. Par exemple :

        function myCompare(a:Object, b:Object, fields:Array = null):int
        {
            var result:int = 0;
            var i:int = 0;
            var propList:Array = fields ? fields : internalPropList;
            var len:int = propList.length;
            var propName:String;
            while (result == 0 && (i < len))
            {
                propName = propList[i];
                result = compareValues(a[propName], b[propName]);
                i++;
            }
            return result;
        }
     
        function compareValues(a:Object, b:Object):int
        {
            if (a == null && b == null)
                return 0;
     
            if (a == null)
              return 1;
     
            if (b == null)
               return -1;
     
            if (a < b)
                return -1;
     
            if (a > b)
                return 1;
     
            return 0;
        }
      

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

Vous pouvez également spécifier des fonctions de comparaison séparées pour chaque champ de tri, en utilisant la propriété compareFunction de la classe ISortField. Il est ainsi possible d’utiliser la comparaison par défaut pour certains champs et une comparaison personnalisée pour d’autres.

Composant Array d’objets ISortField spécifiant les champs à comparer. L’ordre des objets ISortField dans le tableau détermine l’ordre de priorité des champs lors du tri. Le comparateur de tri par défaut vérifie les champs de tri dans l’ordre du tableau, jusqu’à ce qu’il détermine un ordre de tri pour les deux champs comparés.

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement fieldsChanged .

Eléments de l’API associés

Indique si le tri doit être unique. Les tris uniques échouent si une valeur ou une combinaison de valeurs spécifiée par les champs de la propriété fields engendre un ordre de tri indéterminé ou non unique, par exemple lorsque deux éléments ou plus ont les mêmes valeurs de tri. Une erreur est renvoyée si le tri n’est pas unique. La logique de tri utilise cette valeur de propriété unique seulement si les champs de tri sont spécifiés de façon explicite. En l’absence de champs de tri spécifiés de façon explicite, aucune erreur n’est renvoyée, même lorsqu’il existe des éléments de valeur identique.

La valeur par défaut est false.

Constructeur.

Crée un nouvel objet Sort dont aucun champ n’est défini et qui ne contient aucun comparateur personnalisé.

Retrouve l’objet spécifié dans le tableau spécifié (ou le point d’insertion s’il est demandé) et renvoie l’index si cet objet est retrouvé, ou -1 dans le cas contraire. Les méthodes findxxx() de la classe ListCollectionView utilisent cette méthode pour retrouver l’élément demandé. Bien souvent, il est plus simple d’utiliser ces fonctions plutôt que la méthode findItem() pour retrouver des données dans les objets ListCollectionView. Appelez directement la méthode findItem() lorsque vous écrivez une classe prenant en charge le tri, par exemple une nouvelle implémentation ICollectionView. Le tableau d’éléments en entrée doit être trié avant l’appel de cette fonction. Dans le cas contraire, cette fonction ne peut pas trouver la valeur spécifiée correctement.

Paramètres

Renvoie une valeur indiquant si la propriété spécifiée est utilisée dans le contrôle du tri. La fonction ne peut pas fournir une réponse définitive si le tri fait appel à un comparateur personnalisé. Dans ce cas, elle renvoie toujours la valeur true.

Paramètres

Parcourt le tableau fields et appelle la méthode reverse() sur chacun des objets ISortField dans le tableau. Si le champ était trié dans l’ordre décroissant, il est maintenant classé dans l’ordre croissant et inversement.

Remarque : une interface ICollectionView n’est pas automatiquement mise à jour lorsque les objets du tableau fields sont modifiés. Appelez sa méthode refresh() pour actualiser la vue.

Applique le tri actuel au tableau spécifié et non à une copie. Pour empêcher la modification du tableau, créez une copie et utilisez-la dans le paramètre items.

Les implémentations Flex de l’interface ICollectionView appellent automatiquement la méthode sort et font en sorte que le tri soit réalisé sur une copie des données sous-jacentes.

Paramètres

Lors de l’exécution d’une recherche, renvoie l’index d’un élément correspondant.

Lors de l’exécution d’une recherche, renvoie l’index du premier élément correspondant.

Lors de l’exécution d’une recherche, renvoie l’index du dernier élément correspondant.