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():int
compareFunction | 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
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
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 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):void
name | 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):void
usingCustomCompareFunction | 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():Boolean
initializeDefaultCompareFunction | () | 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