| Package | mx.collections |
| Interface | public interface ISortField |
| Implémenteurs | SortField, SortField |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
ISortField définit l’interface des classes utilisées avec les classes ISort, afin de fournir les informations de tri requises pour trier les champs spécifiques ou les propriétés d’une vue de collection.
| Propriété | Défini par | ||
|---|---|---|---|
| arraySortOnOptions : int [lecture seule]
Cette propriété d’assistance est utilisée en interne par les méthodes findItem() et sort(). | ISortField | ||
| compareFunction : Function
Fonction comparant deux éléments lors d’un tri d’éléments pour la collection associée. | ISortField | ||
| descending : Boolean
Détermine si ce champ doit être trié dans l’ordre décroissant. | ISortField | ||
| name : String
Nom du champ à trier. | ISortField | ||
| numeric : Object
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. | ISortField | ||
| usingCustomCompareFunction : Boolean [lecture seule]
La valeur est true si cet objet ISortField utilise une fonction de comparaison personnalisée. | ISortField | ||
| Méthode | Défini par | ||
|---|---|---|---|
Fonction d’assistance appelée par la classe de tri pour définir la fonction de comparaison par défaut et réaliser une comparaison en fonction de l’un de ces trois éléments : si une fonction de comparaison personnalisée a été définie ou non, le type de données du champ spécifié ou la valeur de la propriété numeric. | ISortField | ||
Inverse les critères de ce champ de tri. | ISortField | ||
arraySortOnOptions | propriété |
arraySortOnOptions:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Cette propriété d’assistance est utilisée en interne par les méthodes findItem() et sort(). Les autres utilisations de cette propriété ne sont pas prises en charge. Renvoie la valeur -1 si ISortField ne doit pas être utilisé par la classe Sort pour trier le champ (il n’existe aucune fonction compareFunction ni de nom). Dans le cas contraire, renvoie un masque binaire d’options de tri.
Implémentation
public function get arraySortOnOptions():intcompareFunction | propriété |
compareFunction:Function| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| 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 ISort, Flex ignore les propriétés compareFunction des objets ISortField de l’objet ISort.
La fonction de comparaison doit présenter la signature suivante :
function myCompare(a:Object, b:Object):int
Cette fonction renvoie les valeurs suivantes :
- -1 si
aapparaît avantbdans la séquence triée - 0 si
a=b - 1 si
aapparaît aprèsbdans la séquence triée
Implémentation
public function get compareFunction():Function public function set compareFunction(value:Function):voiddescending | propriété |
descending:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Détermine si ce champ doit être trié dans l’ordre décroissant.
La valeur par défaut est false (ordre croissant).
Implémentation
public function get descending():Boolean public function set descending(value:Boolean):voidname | propriété |
numeric | propriété |
numeric:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| 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.
Cette propriété est utilisée par la classe SortField si aucune fonction de comparaison personnalisée n’est fournie.
Si la valeur de cette propriété est true, la fonction de comparaison numérique intégrée est utilisée. Chacun des éléments de données est projeté vers une fonction Number() avant la comparaison.
Si la valeur de cette propriété est false, la fonction de comparaison de chaînes intégrée est utilisée. Chacun des éléments de données est projeté vers une fonction String() avant la comparaison.
Si la valeur de cette propriété est null, le premier élément de données est introspecté afin de déterminer s’il s’agit d’un nombre ou d’une chaîne. Le tri est réalisé en fonction de cette introspection.
La valeur par défaut est null.
Implémentation
public function get numeric():Object public function set numeric(value:Object):voidusingCustomCompareFunction | propriété |
usingCustomCompareFunction:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
La valeur est true si cet objet ISortField utilise une fonction de comparaison personnalisée.
Implémentation
public function get usingCustomCompareFunction():BooleaninitializeDefaultCompareFunction | () | méthode |
public function initializeDefaultCompareFunction(obj:Object):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fonction d’assistance appelée par la classe Sort pour définir la fonction de comparaison par défaut et réaliser une comparaison en fonction de l’un de ces trois éléments : si une fonction de comparaison personnalisée a été définie ou non, le type de données du champ spécifié ou la valeur de la propriété numeric. Si la propriété numeric a la valeur true, une comparaison numérique est effectuée lors du tri.
Paramètres
obj:Object — Objet qui contient les données. Si le nom du champ a été défini avec la propriété name, le nom est utilisé pour accéder à la valeur de données à partir de cet objet. Dans tous les autres cas, l’objet lui-même est utilisé en tant que valeur de données.
|
reverse | () | méthode |
public function reverse():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Inverse les critères de ce champ de tri. Si le champ était trié dans l’ordre décroissant, par exemple, il est trié dans l’ordre croissant.
Remarque : une interface ICollectionView n’est pas automatiquement mise à jour lorsque les objets ISortField sont modifiés. Appelez sa méthode refresh() pour actualiser la vue.
Tue Jun 12 2018, 09:30 AM Z