mx.collectionsItemResponder La classe ItemResponder fournit une implémentation par défaut de l’interface mx.rpc.IResponder.mx.rpc:IResponderObject La classe ItemResponder fournit une implémentation par défaut de l’interface mx.rpc.IResponder. Elle représente un répondeur qui permet de spécifier les méthodes à appeler au terme d’une demande, qu’elle aboutisse ou qu’elle génère une erreur. L’objet de la classe permet également de fournir des données (un jeton) devant être utilisées par les méthodes de répondeur.

Vous pouvez utiliser un objet ItemResponder dans l’instruction catch d’un bloc try pour obtenir des données distantes, comme l’illustre l’exemple de code ci-dessous :


     import mx.collections.ItemResponder;
     //...
 
     try
     {
        //...
        cursor.moveNext();
     }
    catch(e:ItemPendingError)
     {
        e.addResponder(new ItemResponder(myResultFunction, myFaultFunction, {info:"..."}));
     }

La méthode result spécifiée doit présenter la signature suivante :

     public function myResultFunction(result:Object, token:Object = null):void;

La méthode fault spécifiée doit présenter la signature suivante :

     public function myFaultFunction(error:Object, token:Object = null):void;

Toute autre signature provoquera une erreur d’exécution.

mx.collections.errors.ItemPendingErrorItemResponder Construit une occurrence du répondeur avec les données et les gestionnaires spécifiés.resultFonction à appeler lorsque la demande aboutit. Elle doit présenter la signature suivante : 
	     		    public function (result:Object, token:Object = null):void;
faultFonction à appeler lorsque la demande génère une erreur. Elle doit présenter la signature suivante : 
	     		    public function (error:ErrorMessage, token:Object = null):void;
tokennullInformations supplémentaires facultatives sur l’objet à associer à cette demande. Cet objet est transmis aux fonctions result et fault en tant que deuxième paramètre. Construit une occurrence du répondeur avec les données et les gestionnaires spécifiés. fault Cette méthode est appelée par un service lorsqu’une erreur est reçue.infoObjet contenant des informations sur l’erreur survenue. Cette méthode est appelée par un service lorsqu’une erreur est reçue. result Cette méthode est appelée par un service lorsque la valeur de retour est reçue.dataObjet contenant les informations renvoyées par la demande. Cette méthode est appelée par un service lorsque la valeur de retour est reçue. Sort Fournit les informations de tri requises pour réaliser un tri dans une vue existante (interface ICollectionView ou classe implémentant l’interface). The <mx:Sort> tag has the following attributes:

  <mx:Sort
  Properties
  compareFunction="Internal compare function"
  fields="null"
  unique="false | true"
  />

In case items have inconsistent data types or items have complex data types, the use of the default built-in compare functions is not recommended. Inconsistent sorting results may occur in such cases. To avoid such problem, provide a custom compare function and/or make the item types consistent.

Just like any other AdvancedStyleClient-based classes, the Sort and SortField classes do not have a parent-child relationship in terms of event handling. Locale changes in a Sort instance are not dispatched to its SortField instances automatically. The only exceptional case is the internal default SortField instance used when no explicit fields are provided. In this case, the internal default SortField instance follows the locale style that the owner Sort instance has.

]]>mx.collections:ISortflash.events:EventDispatcher Fournit les informations de tri requises pour réaliser un tri dans une vue existante (interface ICollectionView ou classe implémentant l’interface). Après avoir affecté une occurrence Sort à la propriété sort de la vue, vous devez appeler la méthode refresh() de la vue pour appliquer les critères de tri. Le tri est généralement défini pour des collections d’éléments complexes, c’est-à-dire pour des collections dans lesquelles le tri est réalisé sur une ou plusieurs propriétés des objets de la collection. L’exemple suivant illustre cette utilisation : 

     var col:ICollectionView = new ArrayCollection();
     // In the real world, the collection would have more than one item.
     col.addItem({first:"Anders", last:"Dickerson"});
     // Create the Sort instance.
     var sort:Sort = new Sort();
     // Set the sort field; sort on the last name first, first name second.
     // Both fields are case-insensitive.
     sort.fields = [new SortField("last",true), new SortField("first",true)];
       // Assign the Sort object to the view.
     col.sort = sort;
     // Apply the sort to the collection.
     col.refresh();

Dans certaines situations, la collection contient des éléments simples de type String, Date, Boolean, etc. Dans ce cas, appliquez le tri directement au type simple. Lorsque vous réalisez un tri pour des éléments simples, utilisez un seul champ de tri et spécifiez la valeur null pour le (premier) paramètre name du constructeur d’objet SortField. Par exemple : 


     var col:ICollectionView = new ArrayCollection();
     col.addItem("California");
     col.addItem("Arizona");
     var sort:Sort = new Sort();
     // There is only one sort field, so use a null 
     // first parameter.
     sort.fields = [new SortField(null, true)];
     col.sort = sort;
     col.refresh();

Les implémentations Flex de l’interface ICollectionView extraient tous les éléments d’un emplacement distant avant de procéder au tri. Si vous utilisez la pagination avec une liste triée, appliquez le tri à la collection distante avant d’extraire les données.

Par défaut, cette classe de tri ne permet pas d’effectuer correctement un tri spécifique par langue des chaînes de caractères. Pour ce type de tri, reportez-vous aux classes spark.collections.Sort et spark.collections.SortField.

mx.collections.ICollectionViewISortFieldspark.collections.Sortspark.collections.SortFieldSort Constructeur. Constructeur.

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

findItem Retrouve l’objet spécifié dans le tableau spécifié (ou le point d’insertion s’il est demandé) et retourne l’index si cet objet est retrouvé, ou -1 dans le cas contraire.int Index de l’élément retrouvé dans le tableau. Si la valeur du paramètre returnInsertionIndex est false et que l’élément est introuvable, la valeur retournée est -1. Si la valeur du paramètre returnInsertionIndex est true et que l’élément est introuvable, la valeur retournée est l’index du point où les valeurs seraient insérées dans le tableau trié. itemsTableau dans lequel la recherche doit être réalisée. valuesObjet contenant les propriétés à rechercher (ou l’objet à rechercher lui-même). L’objet doit se composer de paires nom/valeur, où les noms de champ sont les noms des champs spécifiés par la propriété fields, dans l’ordre dans lequel ils sont utilisés dans cette propriété. Il n’est pas obligatoire de spécifier tous les champs de la propriété fields, mais vous ne pouvez pas ignorer des champs si d’autres champs figurant après dans la séquence sont définis. Par conséquent, si la propriété fields contient trois champs, vous pouvez spécifier les premier et deuxième champs de ce paramètre, mais vous ne pouvez pas spécifier uniquement les premier et troisième champs. modeChaîne contenant le type de recherche à réaliser. Valeurs valides : ANY_INDEX_MODERetourne une position valide pour les valeurs. FIRST_INDEX_MODE Retourne la position où la première occurrence de la valeur a été retrouvée. LAST_INDEX_MODE Retourne la position où la dernière occurrence de la valeur spécifiée a été retrouvée. returnInsertionIndexfalseSi la méthode ne retrouve pas d’élément identifié par le paramètre values et que la valeur de ce paramètre est true, la méthode findItem() retourne le point d’insertion des valeurs, c’est-à-dire le point où vous devez insérer l’élément, dans l’ordre de tri. compareFunctionnullFonction de comparaison à utiliser pour retrouver l’élément. Si vous ne spécifiez pas ce paramètre ou si vous spécifiez une valeur null, la fonction findItem() utilise la fonction de comparaison déterminée par la propriété compareFunction de l’occurrence ISort et transmet le tableau de champs déterminé par l’objet de valeurs et les objets SortField actuels. Si vous fournissez une valeur non nulle, la fonction findItem() l’utilise en tant que fonction de comparaison. La signature de la fonction transmise comme compareFunction doit avoir la forme suivante : function myCompareFunction(a:Object, b:Object):int. Notez l’absence de troisième argument contrairement à la fonction de comparaison pour la propriété ISort.compareFunction(). Retrouve l’objet spécifié dans le tableau spécifié (ou le point d’insertion s’il est demandé) et retourne 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. propertyAffectsSort Retourne une valeur indiquant si la propriété spécifiée est utilisée dans le contrôle du tri.Indique si la valeur de la propriété est susceptible d’influer sur le résultat du tri. Lorsque le tri utilise la fonction compareFunction par défaut, la valeur true est retournée si le paramètre property spécifie un champ de tri. Si le tri ou un objet ISortField utilisent un comparateur personnalisé, il est impossible de savoir si la propriété peut influer sur le résultat du tri. La valeur retournée est alors true. propertyNom du champ à tester. Retourne 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 retourne toujours la valeur true. reverse Parcourt le tableau fields et appelle la méthode reverse() sur chacun des objets ISortField dans le tableau. 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.

sort Applique le tri actuel au tableau spécifié et non à une copie.itemsTableau d’éléments à trier. 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.

ANY_INDEX_MODE Lors de l’exécution d’une recherche, retourne l’index d’un élément correspondant.any Lors de l’exécution d’une recherche, retourne l’index d’un élément correspondant. FIRST_INDEX_MODE Lors de l’exécution d’une recherche, retourne l’index du premier élément correspondant.first Lors de l’exécution d’une recherche, retourne l’index du premier élément correspondant. LAST_INDEX_MODE Lors de l’exécution d’une recherche, renvoie l’index du dernier élément correspondant.last Lors de l’exécution d’une recherche, renvoie l’index du dernier élément correspondant. compareFunction Méthode utilisée pour comparer des éléments lors du tri. 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 retourner 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.

fields Tableau d’objets ISortField spécifiant les champs à comparer.null 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. SortFieldunique Indique si le tri doit être unique.false 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. ISortField L’interface 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. L’interface 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. initializeDefaultCompareFunction 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.objObjet 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. 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. reverse Inverse les critères de ce champ de tri. 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.

arraySortOnOptions 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. compareFunction Fonction comparant deux éléments lors d’un tri d’éléments pour la collection associée. 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 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
descending Détermine si ce champ doit être trié dans l’ordre décroissant. Détermine si ce champ doit être trié dans l’ordre décroissant.

La valeur par défaut est false (ordre croissant).

name Nom du champ à trier. Nom du champ à trier. numeric 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.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.

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.

usingCustomCompareFunction La valeur est true si cet objet ISortField utilise une fonction de comparaison personnalisée. La valeur est true si cet objet ISortField utilise une fonction de comparaison personnalisée. ArrayList La classe ArrayList est une simple implémentation de l’interface IList qui utilise un tableau de sauvegarde comme source de données. mx.collections:IListflash.utils:IExternalizablemx.core:IPropertyChangeNotifierflash.events:EventDispatcher La classe ArrayList est une simple implémentation de l’interface IList qui utilise un tableau de sauvegarde comme source de données. Les éléments du tableau de sauvegarde peuvent être accédés et manipulés avec les méthodes et les propriétés de l’interface IList. Les opérations réalisées sur une occurrence ArrayList modifient la source de données. Par exemple, si vous utilisez la méthode removeItemAt() sur une classe ArrayList, vous supprimez l’élément du tableau sous-jacent. Cette classe de base ne renverra pas d’objets ItemPendingError mais il est possible qu’une sous-classe le puisse. 
  <mx:ArrayList
  Properties
  source="null"
  />
collectionChange Distribué lorsque l’interface IList a été mise à jour.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Distribué lorsque l’interface IList a été mise à jour. ArrayList Construire une nouvelle classe ArrayList à l’aide du tableau spécifié comme source. sourcenullTableau à utiliser en tant que source pour la classe ArrayList. Construire une nouvelle classe ArrayList à l’aide du tableau spécifié comme source. Si aucune source n’est spécifiée, un tableau vide est utilisé. addAllAt addListmx.collections:IListListe d’éléments à ajouter à la liste actuelle. indexEmplacement de la liste actuelle où les nouveaux éléments doivent être placés. addAll addListmx.collections:IListListe d’éléments à ajouter à la liste actuelle. addItemAt Ajoutez l’élément à l’index spécifié.si l’index est inférieur à 0 ou supérieur à la longueur RangeErrorRangeErroriteml’élément à placer à l’index indexl’index sur lequel placer l’élément Ajoutez l’élément à l’index spécifié. Tout élément qui était après cet index est déplacé d’une placce. addItem Ajoutez l’élément spécifié à la fin de la liste.itemElément à ajouter Ajoutez l’élément spécifié à la fin de la liste. Equivaut à addItemAt(élément, longueur) ; getItemAt Obtenez l’élément à l’index spécifié.si les données de cet index doivent être chargées à partir d’un emplacement distant ItemPendingErrorItemPendingErrorsi l’index < 0 ou index >= longueur RangeErrorRangeErrorl’élément qui se trouve à cet index ou null si aucun élément n’est retrouvé indexl’index dans la liste à partir duquel récupérer l’élément prefetch0Valeur int indiquant le nombre d’éléments à récupérer au cours de la demande si l’élément n’est pas local, ainsi que leur direction. Obtenez l’élément à l’index spécifié. getItemIndex Retourne l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément.l’index de l’élément, -1 si l’élément n’est pas dans la liste. itemElément à retrouver Retourne l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément. Notez que, dans cette implémentation, la recherche est linéaire et est donc O(n). itemUpdateHandler Appelé lorsqu’un des éléments contenus dans la liste distribue un événement ObjectChange.eventmx.events:PropertyChangeEventObjet événement de l’événement ObjectChange. Appelé lorsqu’un des éléments contenus dans la liste distribue un événement ObjectChange. L’enveloppe dans un objet CollectionEventKind.UPDATE. itemUpdated Signale à la vue qu’un élément a été mis à jour.itemElément mis à jour dans la vue. propertynullChaîne, valeur QName ou entier indiquant la propriété modifiée. oldValuenullAncienne valeur de cette propriété (si la valeur de la propriété était null, il peut s’agir de l’ancienne valeur de l’élément). newValuenullNouvelle valeur de cette propriété (si la valeur de la propriété était null, il n’est pas nécessaire de la spécifier, car l’élément est supposé correspondre à la nouvelle valeur). Signale à la vue qu’un élément a été mis à jour. Cette méthode est utile lorsque le contenu de la vue n’implémente pas l’interface IPropertyDispatcher. Si une propriété est spécifiée, il est possible que la vue puisse optimiser son mécanisme de notification. Dans le cas contraire, elle peut simplement choisir d’actualiser l’ensemble de la vue. mx.events.CollectionEventmx.core.IPropertyChangeNotifiermx.events.PropertyChangeEventremoveAll Supprime tous les éléments de la liste. Supprime tous les éléments de la liste. removeItemAt Supprime l’élément qui se trouve à l’index spécifié et le renvoie.Erreur renvoyée lorsque index < 0 ou index >= length. RangeErrorRangeErrorElément qui a été supprimé. indexIndex auquel l’élément doit être supprimé. Supprime l’élément qui se trouve à l’index spécifié et le renvoie. Tous les éléments qui se trouvent après cet index se trouvent désormais avancés d’un index. removeItem Supprime l’élément spécifié de cette liste, s’il existe. Valeur booléenne qui indique si l’élément a été supprimé. itemRéférence de l’objet de l’élément qui doit être supprimé. Supprime l’élément spécifié de cette liste, s’il existe. setItemAt Placez l’élément à l’index spécifié.si l’index est inférieur à 0 ou supérieur ou égal à la longueur RangeErrorRangeErrorElément remplacé ou null si aucun élément n’a été remplacé itemNouvelle valeur de l’index indexl’index sur lequel placer l’élément Placez l’élément à l’index spécifié. Si un élément se trouvait déjà à cet index, le nouvel élément le remplace et il est retourné. startTrackUpdates Si l’élément est une interface IEventDispatcher, recherchez les mises à jour.itemElément transmis à la méthodeaddItemAt(). Si l’élément est une interface IEventDispatcher, recherchez les mises à jour. Cette méthode est appelée par la méthode addItemAt() et lorsque la source est affectée initialement. stopTrackUpdates Si l’élément est une interface IEventDispatcher, arrêtez de rechercher les mises à jour.itemElément transmis à la méthoderemoveItemAt(). Si l’élément est une interface IEventDispatcher, arrêtez de rechercher les mises à jour. Cette méthode est appelée par les méthodes removeItemAt() et removeAll(), et avant l’affectation d’une nouvelle source. toArray Renvoyez un tableau rempli dans le même ordre que l’implémentation de l’interface IList.si les données n’ont pas encore été entièrement chargées à partir d’un emplacement distant ItemPendingErrorItemPendingErrorTableau rempli dans le même ordre que l’implémentation de l’interface IList. Renvoyez un tableau rempli dans le même ordre que l’implémentation de l’interface IList. toString Imprime le contenu de cette classe ArrayList dans une chaîne et la retourne.Chaîne contenant le contenu de la classe ArrayList. Imprime le contenu de cette classe ArrayList dans une chaîne et la retourne. length Obtenez le nombre d’éléments de la liste. Obtenez le nombre d’éléments de la liste. Une classe ArrayList doit toujours connaître sa longueur. Il ne doit donc pas être renvoyé -1, une sous-classe peut annuler ce comportement. source Le tableau source pour cette classe ArrayList. Le tableau source pour cette classe ArrayList. Toutes les modifications effectuées à l’aide de l’interface IList seront répercutées dans le tableau source. Si aucun tableau source n’a été fourni, la classe ArrayList va en créer un en interne. Les modifications apportées directement au tableau sous-jacent (par exemple, en appelant theList.source.pop() n’entraîneront pas la distribution de classes CollectionEvents. uid Permet d’accéder à l’ID unique de cette liste. Permet d’accéder à l’ID unique de cette liste. SortField Fournit les informations de tri requises pour réaliser un tri sur un champ ou une propriété dans une vue de collection. The <mx:SortField> tag has the following attributes:

  <mx:SortField
  Properties
  caseInsensitive="false"
  compareFunction="Internal compare function"
  descending="false"
  name="null"
  numeric="null"
  />
]]>mx.collections:ISortFieldflash.events:EventDispatcher Fournit les informations de tri requises pour réaliser un tri sur un champ ou une propriété dans une vue de collection. La classe SortField est destinée à une utilisation avec la classe Sort. Le tri est généralement défini pour des collections d’éléments complexes, c’est-à-dire pour des éléments dans lesquels le tri est réalisé sur les propriétés de ces objets. Exemple : 

     var col:ICollectionView = new ArrayCollection();
     col.addItem({first:"Anders", last:"Dickerson"});
     var sort:Sort = new Sort();
     sort.fields = [new SortField("first", true)];
     col.sort = sort;
Dans certaines situations, la collection contient des éléments simples de type String, Date, Boolean, etc. Dans ce cas, le tri doit être appliqué directement au type simple. Lorsque vous créez un tri pour cette fonction, un seul champ de tri est nécessaire. Sa propriété name ne doit pas être définie. Par exemple : 

     var col:ICollectionView = new ArrayCollection();
     col.addItem("California");
     col.addItem("Arizona");
     var sort:Sort = new Sort();
     sort.fields = [new SortField(null, true)];
     col.sort = sort;

Par défaut, la comparaison fournie par la classe SortField ne permet pas d’effectuer correctement un tri spécifique par langue des chaînes de caractères. Pour ce type de tri, reportez-vous aux classes spark.collections.Sort et spark.collections.SortField.

mx.collections.ICollectionViewmx.collections.Sortspark.collections.Sortspark.collections.SortFieldSortField Constructeur.namenullNom 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. caseInsensitivefalseLors du tri de chaînes, indique au comparateur s’il faut ignorer la casse des valeurs. descendingfalseIndique au comparateur si les éléments doivent être classés dans l’ordre décroissant. numericnullIndique au comparateur si les éléments de tri doivent être comparés en tant que nombres et non selon l’ordre alphabétique. Constructeur. initializeDefaultCompareFunction 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.objObjet 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. 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. reverse Inverse les critères de ce champ de tri. 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.

arraySortOnOptions 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. caseInsensitive Détermine si le tri de ce champ doit ou non être sensible à la casse.false Détermine si le tri de ce champ doit ou non être sensible à la casse. compareFunction Fonction comparant deux éléments lors d’un tri d’éléments pour la collection associée. 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 SortField de l’objet ISort.

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

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

Cette fonction doit retourner 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.

Remarque : si vous avez besoin d’effectuer un tri spécifique par langue, utilisez la classe spark.collections.SortField. spark.collections.SortFielddescending Détermine si ce champ doit être trié dans l’ordre décroissant. Détermine si ce champ doit être trié dans l’ordre décroissant.

La valeur par défaut est false (ordre croissant).

name Nom du champ à trier.null Nom du champ à trier. numeric 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.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.

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.

usingCustomCompareFunction La valeur est true si cet objet ISortField utilise une fonction de comparaison personnalisée. La valeur est true si cet objet ISortField utilise une fonction de comparaison personnalisée. AsyncListView La classe AsyncListView est une implémentation de l’interface IList qui gère les erreurs ItemPendingErrors renvoyées par les méthodes getItemAt(), removeItemAt() et toArray(). The <mx:AsyncListView> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:AsyncListView
  Properties
    createFailedItemFunction="null"
    createPendingItemFunction="null"
    list="null"
  />
]]>mx.collections:IListmx.utils:OnDemandEventDispatcher La classe AsyncListView est une implémentation de l’interface IList qui gère les erreurs ItemPendingErrors renvoyées par les méthodes méthode getItemAt(), méthode additem() et toArray().

La méthode getItemAt() gère les erreurs ItemPendingErrors en renvoyant un élément « en attente » provisoire jusqu’à ce que la demande sous-jacente aboutisse ou échoue. L’élément provisoire est produit par l’appel de la fonction spécifiée par la propriété createPendingItemFunction. Si la demande aboutit, l’élément réel remplace celui provisoire. Si elle échoue, l’élément provisoire est remplacé par l’élément renvoyé en appelant la fonction spécifiée par la propriété createFailedItemFunction.

Cette classe délègue les méthodes et les propriétés IList à sa list. Si aucune liste n’est spécifiée, les méthodes qui font muter la collection ne sont pas opératoires et les méthodes qui interrogent la collection renvoient une valeur vide comme null ou zéro, selon le cas.

Cette classe est conçue pour être utilisée avec les composants Spark basés sur la classe DataGroup, tels que List et ComboBox. Les classes Spark ne fournissent pas de prise en charge intrinsèque de la gestion des erreurs ItemPendingError.

AsyncListView ne prend pas en charge la réinsertion d’éléments qui sont en attente ou qui ont échoué. Dès qu’un élément qui a échoué ou qui est en attente est supprimé, sa connexion à une demande en attente de données est perdue. L’utilisation de Glisser-déposer pour déplacer un élément en attente dans une ASyncListView ou le tri d’une ASyncListView contenant des éléments qui sont en attente ou qui ont échoué n’est pas pris en charge car ces opérations suppriment puis réinsèrent des éléments de liste.

collectionChange Distribué lorsque la longueur de la liste a été modifiée ou qu’un élément list est remplacé. mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Distribué lorsque la longueur de la liste a été modifiée ou qu’un élément list est remplacé. AsyncListView Constructeur.listmx.collections:IListnullValeur initiale de la propriété list, IList auquel nous déléguons. Constructeur. addItemAt Ajoute l’élément à l’index spécifié.itemElément à placer à l’index. indexIndex auquel placer l’élément. Ajoute l’élément à l’index spécifié. L’index de tout élément supérieur à l’index de l’élément ajouté est augmenté d’une unité. Si l’index spécifié est inférieur à zéro ou supérieur à la longueur de la liste, une erreur RangeError est renvoyée. addItem Ajoute l’élément spécifié à la fin de la liste.itemElément à ajouter. Ajoute l’élément spécifié à la fin de la liste. Equivaut à addItemAt(élément, longueur). getItemAt Renvoie la valeur list.getItemAt(index) Erreur renvoyée lorsque index < 0 ou index >= length. RangeErrorRangeErrorElément de liste présent à l’index spécifié. indexIndex de liste à partir duquel l’élément doit être récupéré. prefetch0Valeur int indiquant le nombre d’éléments à récupérer au cours de la demande si l’élément n’est pas local, ainsi que leur direction. Renvoie la valeur de List.getItemAt(index).

Cette méthode intercepte les erreurs ItemPendingErrors (IPE) générées suite à l’appel de la méthode getItemAt(). Si une IPE est renvoyée, un IResponder est ajouté à l’IPE et un élément « en attente » provisoire, créé à l’aide de createPendingItemFunction est renvoyé. Si la demande sous-jacente réussit, l’élément en attente est remplacé par le véritable élément. Dans le cas contraire, l’élément en attente est remplacé par une valeur produite par un l’appel de createFailedItemFunction.

createPendingItemFunctioncreateFailedItemFunctionmx.collections.errors.ItemPendingErrormx.rpc.IRespondergetItemIndex Renvoie l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément.Index de l’élément ou -1 s’il ne se trouve pas dans la liste. itemElément à retrouver. Renvoie l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément.

Remarque : contrairement aux méthodes IViewCursor.findxxx(), la méthode getItemIndex() n’accepte pas les paramètres contenant uniquement un sous-ensemble des champs de l’élément recherché. Cette méthode recherche toujours un élément qui correspond exactement au paramètre d’entrée.

itemUpdated Signale à la vue qu’un élément a été mis à jour.itemElément mis à jour dans la vue. propertynullNom de la propriété mise à jour. oldValuenullAncienne valeur de cette propriété (si la valeur de la propriété était null, il peut s’agir de l’ancienne valeur de l’élément). newValuenullNouvelle valeur de cette propriété (si la valeur de la propriété était null, il n’est pas nécessaire de la spécifier, car l’élément est supposé correspondre à la nouvelle valeur). Signale à la vue qu’un élément a été mis à jour. Cette méthode est utile lorsque le contenu de la vue n’implémente pas l’interface IEventDispatcher et distribue un événement PropertyChangeEvent. Si une propriété est spécifiée, il est possible que la vue puisse optimiser son mécanisme de notification. Dans le cas contraire, elle peut simplement choisir d’actualiser l’ensemble de la vue. removeAll Supprime tous les éléments de la liste. Supprime tous les éléments de la liste.

Si un élément n’est pas local et qu’une opération asynchrone doit être réalisée, une erreur ItemPendingError est renvoyée.

Pour plus d’informations sur l’utilisation de la classe ItemPendingError, voir la documentation relative à ItemPendingError et aux collections.

removeItemAt Supprime l’élément actuel ou en attente qui se trouve à l’index spécifié et le renvoie.Erreur renvoyée lorsque index < 0 ou index >= length. RangeErrorRangeErrorElément qui a été supprimé ou qui est null. indexIndex de liste à partir duquel l’élément doit être récupéré. Supprime l’élément actuel ou en attente qui se trouve à l’index spécifié et le renvoie. L’index de tous les éléments dont l’index est supérieur à celui spécifié est réduit de 1.

En l’absence d’élément actuel ou en attente à l’index spécifié, par exemple si un appel de la méthode getItemAt(index) n’a pas provoqué la pagination des données, la list sous-jacente peut renvoyer une erreur ItemPendingError. L’implémentation ignore l’erreur ItemPendingError et renvoie null.

setItemAt Place l’élément à l’index spécifié.Elément remplacé ou null si aucun élément n’a été remplacé. itemNouvel élément à placer à l’index spécifié. indexIndex auquel placer l’élément. Place l’élément à l’index spécifié. Si un élément se trouvait déjà à cet index, le nouvel élément le remplace et il est retourné. toArray Renvoie un tableau contenant les mêmes éléments que cette AsyncListView. tableau contenant les mêmes éléments que cette AsyncListView. Renvoie un tableau contenant les mêmes éléments que cette AsyncListView. Le tableau est initialisé en récupérant chaque élément avec getItemAt(), de manière à ce que les éléments en attente soient substitués là où des valeurs réelles se sont pas encore disponibles. Le tableau ne sera pas mis à jour lorsque la classe ASyncListView remplace les éléments en attente par des valeurs réelles (ou qui ont échoué). toString Renvoie une chaîne qui contient la longueur de la liste et le nombre de requêtes d’éléments en attente. Brève description de la liste. Renvoie une chaîne qui contient la longueur de la liste et le nombre de requêtes d’éléments en attente. Il ne déclenche pas de demandes en attente. createFailedItemFunction Une fonction de rappel utilisée pour créer un élément de substitution lorsqu’une demande ayant entraîné le renvoi d’une erreur ItemPendingError échoue.A function that unconditionally returns null. Une fonction de rappel utilisée pour créer un élément de substitution lorsqu’une demande ayant entraîné le renvoi d’une erreur ItemPendingError échoue. L’élément existant, généralement un élément en attente créé par la fonction de rappel spécifiée par la propriété createPendingItemFunction(), est remplacé par l’élément ayant échoué.

La valeur de cette propriété doit être une fonction à deux paramètres, l’index de l’élément demandé et l’objet « info » d’échec, qui est transmis à partir de la méthode IResponder fault(). Dans la plupart des cas, vous pouvez ignorer le second paramètre. Vous trouverez ci-dessous un exemple d’implémentation de la fonction callback :

     function createFailedItem(index:int, info:Object):Object
     {
         return "[" + index + "request failed]";        
     }

La définition de cette propriété n’affecte pas les éléments en échec qui ont déjà été créés. La définition de cette propriété sur null empêche la création des éléments en échec.

getItemAt()createPendingItemFunctionmx.rpc.IResponder.faultcreatePendingItemFunction Une fonction de rappel utilisée pour créer un élément provisoire lorsque la demande initiale provoque le renvoi d’une erreur ItemPendingError.A function that unconditionally returns null. Une fonction de rappel utilisée pour créer un élément provisoire lorsque la demande initiale provoque le renvoi d’une erreur ItemPendingError. Si la demande aboutit, l’élément provisoire est automatiquement remplacé par l’élément actuel. Si la demande échoue, l’élément est remplacé par un autre élément créé avec la fonction de rappel spécifiée par la propriété createFailedItemFunction.

La valeur de cette propriété doit être une fonction à deux paramètres, l’index de l’élément de fournisseur de données demandé et ItemPendingError. Dans la plupart des cas, le second paramètre peut être ignoré. L’exemple suivant illustre une implémentation de la fonction de rappel : 

     function createPendingItem(index:int, ipe:ItemPendingError):Object
     {
         return "[" + index + "request is pending...]";        
     }

La définition de cette propriété n’affecte pas les éléments en attente provisoires qui ont déjà été créés. La définition de cette propriété sur null empêche la création d’éléments en attente provisoires.

getItemAt()createFailedItemFunctionmx.collections.errors.ItemPendingErrorlength Nombre d’éléments dans cette collection. Nombre d’éléments dans cette collection. 0 signifie que la collection ne contient aucun élément. -1 signifie que la longueur de la collection est inconnue. list Objet IList enveloppé par cette collection.mx.collections:IListnull Objet IList enveloppé par cette collection. C’est-à-dire l’objet auquel l’ensemble des méthodes IList sont déléguées.

Si cette propriété est null, les méthodes de mutation IList, telles que setItemAt(), ne sont pas opératoires. Les méthodes de requête IList, par exemple getItemAt(), renvoient la valeur null ou zéro (-1 pour getItemIndex()), selon le cas.

ArrayCollection La classe ArrayCollection est une classe d’enveloppe qui présente un tableau sous la forme d’une collection accessible, pouvant être manipulée à l’aide des méthodes et propriétés des interfaces ICollectionView ou IList.The <mx:ArrayCollection> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:ArrayCollection
  Properties
  source="null"
  />
]]>flash.utils:IExternalizablemx.collections:ListCollectionView La classe ArrayCollection est une classe d’enveloppe qui présente un tableau sous la forme d’une collection accessible, pouvant être manipulée à l’aide des méthodes et propriétés des interfaces ICollectionView ou IList. Les opérations réalisées sur une occurrence ArrayCollection modifient la source de données. Par exemple, si vous utilisez la méthode removeItemAt() sur une occurrence ArrayCollection, vous supprimez l’élément du tableau sous-jacent. Le code suivant crée un objet ArrayCollection simple accédant et manipulant un tableau contenant un élément Object unique. Il extrait l’élément à l’aide de la méthode getItemAt de l’interface IList et d’un objet IViewCursor obtenu par le biais de la méthode createCursor de l’interface ICollectionView. 
  var myCollection:ArrayCollection = new ArrayCollection([ { first: 'Matt', last: 'Matthews' } ]);
  var myCursor:IViewCursor = myCollection.createCursor();
  var firstItem:Object = myCollection.getItemAt(0);
  var firstItemFromCursor:Object = myCursor.current;
  if (firstItem == firstItemFromCursor)
        doCelebration();
ArrayCollection Constructeur.sourcenullTableau source. Constructeur.

Crée une nouvelle occurrence ArrayCollection à l’aide du tableau source spécifié. Si aucun tableau n’est spécifié, un tableau vide est utilisé.

source Source des données dans l’occurrence ArrayCollection. Source des données dans l’occurrence ArrayCollection. L’objet ArrayCollection ne représente pas les modifications apportées directement au tableau source. Utilisez systématiquement les méthodes ICollectionView ou IList pour modifier la collection. ISort L’interface ISort définit l’interface des classes qui fournissent les informations de tri requises pour trier les données d’une vue de collection. L’interface ISort définit l’interface des classes qui fournissent les informations de tri requises pour trier les données d’une vue de collection. mx.collections.ICollectionViewmx.collections.ISortFieldfindItem Retrouve l’objet spécifié dans le tableau spécifié (ou le point d’insertion s’il est demandé) et retourne l’index si cet objet est retrouvé, ou -1 dans le cas contraire.S’il existe des erreurs de paramètres, le critère de recherche n'est pas compatible avec le tri ou la fonction de comparaison associée au tri ne peut pas être déterminée. SortErrorSortErrorint Index de l’élément retrouvé dans le tableau. Si la valeur du paramètre returnInsertionIndex est false et que l’élément est introuvable, la valeur retournée est -1. Si la valeur du paramètre returnInsertionIndex est true et que l’élément est introuvable, la valeur retournée est l’index du point où les valeurs seraient insérées dans le tableau trié. itemsTableau dans lequel la recherche doit être réalisée. valuesObjet contenant les propriétés à rechercher (ou l’objet à rechercher lui-même). L’objet doit se composer de paires nom/valeur, où les noms de champ sont les noms des champs spécifiés par la propriété fields, dans l’ordre dans lequel ils sont utilisés dans cette propriété. Il n’est pas obligatoire de spécifier tous les champs de la propriété fields, mais vous ne pouvez pas ignorer des champs si d’autres champs figurant après dans la séquence sont définis. Par conséquent, si la propriété fields contient trois champs, vous pouvez spécifier les premier et deuxième champs de ce paramètre, mais vous ne pouvez pas spécifier uniquement les premier et troisième champs. modeChaîne contenant le type de recherche à réaliser. Valeurs valides : ANY_INDEX_MODERetourne une position valide pour les valeurs. FIRST_INDEX_MODE Retourne la position où la première occurrence de la valeur a été retrouvée. LAST_INDEX_MODE Retourne la position où la dernière occurrence de la valeur spécifiée a été retrouvée. returnInsertionIndexfalseSi la méthode ne retrouve pas d’élément identifié par le paramètre values et que la valeur de ce paramètre est true, la méthode findItem() retourne le point d’insertion des valeurs, c’est-à-dire le point où vous devez insérer l’élément, dans l’ordre de tri. compareFunctionnullFonction de comparaison à utiliser pour retrouver l’élément. Si vous ne spécifiez pas ce paramètre ou si vous spécifiez une valeur null, la fonction findItem() utilise la fonction de comparaison déterminée par la propriété compareFunction de l’occurrence ISort et transmet le tableau de champs déterminé par l’objet de valeurs et les objets SortField actuels. Si vous fournissez une valeur non nulle, la fonction findItem() l’utilise en tant que fonction de comparaison. La signature de la fonction transmise comme compareFunction doit avoir la forme suivante : function myCompareFunction(a:Object, b:Object):int. Notez l’absence de troisième argument contrairement à la fonction de comparaison pour la propriété ISort.compareFunction(). Retrouve l’objet spécifié dans le tableau spécifié (ou le point d’insertion s’il est demandé) et retourne 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. propertyAffectsSort Retourne une valeur indiquant si la propriété spécifiée est utilisée dans le contrôle du tri.Indique si la valeur de la propriété est susceptible d’influer sur le résultat du tri. Lorsque le tri utilise la fonction compareFunction par défaut, la valeur true est retournée si le paramètre property spécifie un champ de tri. Si le tri ou un objet ISortField utilisent un comparateur personnalisé, il est impossible de savoir si la propriété peut influer sur le résultat du tri. La valeur retournée est alors true. propertyNom du champ à tester. Retourne 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 retourne toujours la valeur true. reverse Parcourt le tableau fields et appelle la méthode reverse() sur chacun des objets ISortField dans le tableau. 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.

sort Applique le tri actuel au tableau spécifié et non à une copie.itemsTableau d’éléments à trier. 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.

compareFunction Méthode utilisée pour comparer des éléments lors du tri. 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 retourner 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.

fields Tableau d’objets ISortField spécifiant les champs à comparer.null 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. ISortFieldunique Indique si le tri doit être unique.false 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. XMLListCollection La classe XMLListCollection fournit une fonctionnalité de collecte à un objet XMLList et permet d’accéder à certaines méthodes de la classe native XMLList.The <mx:XMLListCollection> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:XMLListCollection
  Properties
  source="null"
  />
]]>mx.collections:ListCollectionView La classe XMLListCollection fournit une fonctionnalité de collecte à un objet XMLList et permet d’accéder à certaines méthodes de la classe native XMLList. XMLListXMLXMLListCollection Constructeur.sourcenullObjet XMLList contenant les données devant être représentées par l’objet XMLListCollection. Constructeur.

Crée un nouvel objet XMLListCollection à partir de l’objet XMLList spécifié.

attribute Appelle la méthode attribute() de chaque objet XML de l’objet XMLList et renvoie une liste de résultats XMLList, correspondant au nom attributeName concerné.Objet XMLList contenant les objets XML correspondants. attributeNameAttribut pour lequel une correspondance doit être recherchée dans les objets XML de l’objet XMLList. Appelle la méthode attribute() de chaque objet XML de l’objet XMLList et renvoie une liste de résultats XMLList, correspondant au nom attributeName concerné. XML.attribute()attributes Appelle la méthode attributes() de chaque objet XML de l’objet XMLList et renvoie une liste d’attributs XMLList pour chaque objet XML.Objet XMLList contenant les objets XML résultants, répertoriant les différents attributs. Appelle la méthode attributes() de chaque objet XML de l’objet XMLList et renvoie une liste d’attributs XMLList pour chaque objet XML. XML.attributes()child Appelle la méthode child() de chaque objet XML de l’objet XMLList et renvoie un objet XMLList contenant les enfants correspondant au nom de propriété spécifié, dans l’ordre correct.Objet XMLList des enfants d’objets XML correspondants dans l’objet XMLList d’origine. propertyNamePropriété pour laquelle une correspondance doit être recherchée. Appelle la méthode child() de chaque objet XML de l’objet XMLList et renvoie un objet XMLList contenant les enfants correspondant au nom de propriété spécifié, dans l’ordre correct. XML.child()children Appelle la méthode children() de chaque objet XML de l’objet XMLList et renvoie une liste de résultats XMLList.Objet XMLList contenant les enfants d’objets XML présents dans l’objet XMLList d’origine. Appelle la méthode children() de chaque objet XML de l’objet XMLList et renvoie une liste de résultats XMLList. XML.children()copy Renvoie une copie profonde de l’objet XMLList.Copie de l’objet XMLList. Renvoie une copie profonde de l’objet XMLList. descendants Appelle la méthode descendants() de chaque objet XML de l’objet XMLList et renvoie une liste de résultats XMLList.Objet XMLList contenant les descendants (enfants, petits-enfants, etc.) d’objets XML correspondants présents dans l’objet XMLList d’origine. name*Nom des éléments pour lesquels une correspondance doit être établie. Appelle la méthode descendants() de chaque objet XML de l’objet XMLList et renvoie une liste de résultats XMLList. Le paramètre name est transmis à la méthode descendants() de l’objet XML. Si vous ne spécifiez pas de paramètre, la chaîne « ~~ » est transmise à la méthode descendants(). XML.descendants()elements Appelle la méthode elements() de chaque objet XML de l’objet XMLList.Objet XMLList contenant les éléments enfant d’objets XML correspondants dans l’objet XMLList d’origine. name*Nom des éléments pour lesquels une correspondance doit être établie. Appelle la méthode elements() de chaque objet XML de l’objet XMLList. Le paramètre name est transmis à la méthode elements() de l’objet XML. Si vous ne spécifiez pas de paramètre, la chaîne « ~~ » est transmise à la méthode elements(). XML.elements()text Appelle la méthode text() de chaque objet XML de l’objet XMLList et renvoie une liste de résultats XMLList.Objet XMLList contenant le résultat. Appelle la méthode text() de chaque objet XML de l’objet XMLList et renvoie une liste de résultats XMLList. XML.text()toString Renvoie une représentation de chaîne de l’objet XMLList en appelant la méthode toString() pour chaque objet XML de l’objet XMLList.Représentation sous forme de chaîne de l’objet XMLList. Renvoie une représentation de chaîne de l’objet XMLList en appelant la méthode toString() pour chaque objet XML de l’objet XMLList. Si la propriété prettyPrinting de la classe XML est définie sur true, les résultats de chaque objet XML de l’objet XMLList sont séparés par le caractère de retour. Dans le cas contraire, si la propriété prettyPrinting est définie sur false, les résultats sont tout simplement concaténés et ne sont pas séparés par des caractères de retour.

Pour les objets XML dont le contenu est simple, la méthode toString() enlève les informations suivantes de la chaîne renvoyée : balise de début, attributs, déclarations d’espace de nom et balise de fin. Utilisez la méthode toXMLString() si vous souhaitez préserver ces informations dans la chaîne renvoyée pour les objets XML dont le contenu est simple.

XML.prettyPrintingtoXMLString Renvoie une représentation de chaîne de l’objet XMLList en appelant la méthode toXMLString() pour chaque objet XML de l’objet XMLList.Représentation sous forme de chaîne de l’objet XMLList. Renvoie une représentation de chaîne de l’objet XMLList en appelant la méthode toXMLString() pour chaque objet XML de l’objet XMLList. Si la propriété prettyPrinting de la classe XML est définie sur true, les résultats de chaque objet XML de l’objet XMLList sont séparés par le caractère de retour. Dans le cas contraire, si la propriété prettyPrinting est définie sur false, les résultats sont concaténés et ne sont pas séparés par des caractères de retour.

Pour les objets XML dont le contenu est simple, la méthode toXMLString() conserve les informations suivantes dans la chaîne renvoyée : balise de début, attributs, déclarations d’espace de nom et balise de fin. Utilisez la méthode toString() si vous souhaitez enlever ces informations de la chaîne renvoyée pour les objets XML dont le contenu est simple.

XML.prettyPrintingsource Objet XMLList sous-jacent de cette collection. Objet XMLList sous-jacent de cette collection. L’objet XMLListCollection ne représente pas les modifications apportées directement à l’objet XMLList source. Utilisez systématiquement les méthodes XMLListCollection pour modifier la collection. IList Collection d’éléments organisés par ordinaux.flash.events:IEventDispatcher Collection d’éléments organisés par ordinaux. Fournit des méthodes d’accès et de manipulation basées sur l’index.

Une interface IList peut être une vue contenant des données extraites à partir d’un emplacement distant. Lorsque vous écrivez une collection susceptible d’être distante, vous devez envisager les situations où les données ne sont pas encore disponibles, signalées par l’erreur ItemPendingError.

L’interface ICollectionView constitue une alternative à l’interface IList.

mx.collections.errors.ItemPendingErrormx.collections.ICollectionViewmx.collections.ListCollectionViewcollectionChange Distribué lorsque l’interface IList a été mise à jour.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Distribué lorsque l’interface IList a été mise à jour. addItemAt Ajoute l’élément à l’index spécifié.Erreur renvoyée lorsque l’index est inférieur à 0 ou supérieur à la longueur de la liste. RangeErrorRangeErroritemElément à placer à l’index. indexIndex auquel placer l’élément. Ajoute l’élément à l’index spécifié. L’index de tout élément supérieur à l’index de l’élément ajouté est augmenté d’une unité. Si l’index spécifié est inférieur à zéro ou supérieur à la longueur de la liste, une erreur RangeError est renvoyée. addItem Ajoute l’élément spécifié à la fin de la liste.itemElément à ajouter. Ajoute l’élément spécifié à la fin de la liste. Equivaut à addItemAt(élément, longueur). getItemAt Obtient l’élément qui se trouve à l’index spécifié.Erreur renvoyée lorsque les données de cet index doivent être chargées à partir d’un emplacement distant. ItemPendingErrormx.collections.errors:ItemPendingErrorErreur renvoyée lorsque index < 0 ou index >= length. RangeErrorRangeErrorElément qui se trouve à cet index ou null si aucun élément n’est retrouvé. indexIndex de la liste à partir duquel extraire l’élément. prefetch0Valeur int indiquant le nombre d’éléments à récupérer au cours de la demande si l’élément n’est pas local, ainsi que leur direction. Obtient l’élément qui se trouve à l’index spécifié. getItemIndex Renvoie l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément.Index de l’élément ou -1 s’il ne se trouve pas dans la liste. itemElément à retrouver. Renvoie l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément.

Remarque : contrairement aux méthodes IViewCursor.findxxx(), la méthode getItemIndex() n’accepte pas les paramètres contenant uniquement un sous-ensemble des champs de l’élément recherché. Cette méthode recherche toujours un élément qui correspond exactement au paramètre d’entrée.

itemUpdated Signale à la vue qu’un élément a été mis à jour.itemElément mis à jour dans la vue. propertynullNom de la propriété mise à jour. oldValuenullAncienne valeur de cette propriété (si la valeur de la propriété était null, il peut s’agir de l’ancienne valeur de l’élément). newValuenullNouvelle valeur de cette propriété (si la valeur de la propriété était null, il n’est pas nécessaire de la spécifier, car l’élément est supposé correspondre à la nouvelle valeur). Signale à la vue qu’un élément a été mis à jour. Cette méthode est utile lorsque le contenu de la vue n’implémente pas l’interface IEventDispatcher et distribue un événement PropertyChangeEvent. Si une propriété est spécifiée, il est possible que la vue puisse optimiser son mécanisme de notification. Dans le cas contraire, elle peut simplement choisir d’actualiser l’ensemble de la vue. mx.events.CollectionEventmx.events.PropertyChangeEventremoveAll Supprime tous les éléments de la liste. Supprime tous les éléments de la liste.

Si un élément n’est pas local et qu’une opération asynchrone doit être réalisée, une erreur ItemPendingError est renvoyée.

Pour plus d’informations sur l’utilisation de la classe ItemPendingError, voir la documentation relative à ItemPendingError et aux collections.

removeItemAt Supprime l’élément qui se trouve à l’index spécifié et le renvoie.Erreur renvoyée lorsque l’index est inférieur à 0 ou supérieur à la longueur. RangeErrorRangeErrorElément qui a été supprimé. indexIndex auquel l’élément doit être supprimé. Supprime l’élément qui se trouve à l’index spécifié et le renvoie. Tous les éléments qui se trouvent après cet index se trouvent désormais avancés d’un index. setItemAt Place l’élément à l’index spécifié.Erreur renvoyée lorsque l’index est inférieur à 0 ou supérieur à la longueur. RangeErrorRangeErrorElément remplacé ou null si aucun élément n’a été remplacé. itemNouvel élément à placer à l’index spécifié. indexIndex auquel placer l’élément. Place l’élément à l’index spécifié. Si un élément se trouvait déjà à cet index, le nouvel élément le remplace et il est retourné. toArray Retourne un tableau rempli dans le même ordre en tant que qu’implémentation IList.Erreur renvoyée lorsque les données n’ont pas encore été entièrement chargées à partir d’un emplacement distant. ItemPendingErrormx.collections.errors:ItemPendingErrorTableau. Renvoie un tableau rempli dans le même ordre en tant que qu’implémentation IList. Cette méthode peut renvoyer une erreur ItemPendingError. length Nombre d’éléments dans cette collection. Nombre d’éléments dans cette collection. 0 signifie que la collection ne contient aucun élément. -1 signifie que la longueur de la collection est inconnue. ListCollectionView La classe ListCollectionView ajoute les propriétés et méthodes de l’interface ICollectionView à un objet conforme à l’interface IList.The <mx:ListCollectionView> has the following attributes, which all of its subclasses inherit:

  <mx:ListCollectionView
  Properties
  filterFunction="null"
  list="null"
  sort="null"
  Events
  collectionChange="No default"
  />
]]>mx.collections:ICollectionViewmx.collections:IListmx.core:IMXMLObjectflash.utils:Proxy La classe ListCollectionView ajoute les propriétés et méthodes de l’interface ICollectionView à un objet conforme à l’interface IList. Ainsi, vous pouvez transmettre un objet de cette classe à n’importe quelle méthode nécessitant une interface IList ou ICollectionView.

Cette classe permet également d’utiliser la notation de tableau [ ] pour accéder aux méthodes getItemAt() et setItemAt(). Si vous utilisez du code tel que myListCollectionView[index], Flex appelle la méthode getItemAt() ou setItemAt() de l’objet myListCollectionView.

collectionChange Distribué lorsque l’interface ICollectionView a été mise à jour.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Distribué lorsque l’interface ICollectionView a été mise à jour. ListCollectionView Constructeur ListCollectionView.listmx.collections:IListnullInterface IList que la classe ListCollectionView est censée envelopper. Constructeur ListCollectionView. addAllAt Ajoute une liste d’éléments à la liste actuelle, en les plaçant à l’index de position transmis à la fonction.Erreur renvoyée lorsque l’index est inférieur à 0 ou supérieur à la longueur de la liste. RangeErrorRangeErroraddListmx.collections:IListListe d’éléments à ajouter à la liste actuelle. indexEmplacement de la liste actuelle où les nouveaux éléments doivent être placés. Ajoute une liste d’éléments à la liste actuelle, en les plaçant à l’index de position transmis à la fonction. Les éléments sont placés à l’emplacement de l’index, dans l’ordre dans lequel ils sont reçus. addAll Ajoute une liste d’éléments à la liste actuelle, en les plaçant à la fin de la liste, dans l’ordre dans lequel ils sont transmis.addListmx.collections:IListListe d’éléments à ajouter à la liste actuelle. Ajoute une liste d’éléments à la liste actuelle, en les plaçant à la fin de la liste, dans l’ordre dans lequel ils sont transmis. addEventListener typelisteneruseCapturefalsepriority0useWeakReferencefalse addItemAt Ajoute l’élément à l’index spécifié.itemElément à placer à l’index. indexIndex auquel placer l’élément. Ajoute l’élément à l’index spécifié. L’index de tout élément supérieur à l’index de l’élément ajouté est augmenté d’une unité. Si l’index spécifié est inférieur à zéro ou supérieur à la longueur de la liste, une erreur RangeError est renvoyée. addItem Ajoute l’élément spécifié à la fin de la liste.itemElément à ajouter. Ajoute l’élément spécifié à la fin de la liste. Equivaut à addItemAt(élément, longueur). contains Indique en retour si la vue contient l’objet spécifié.true si après application du filtre éventuel, l’interface ICollectionView contient l’élément ; false dans le cas contraire. itemObjet à rechercher. Indique en retour si la vue contient l’objet spécifié. Contrairement aux méthodes IViewCursor.findxxx, cette recherche aboutit uniquement si un élément correspondant exactement au paramètre est trouvé. Si un filtre est appliqué à la vue, cette méthode peut renvoyer false, même si la collection sous-jacente contient bien l’élément. enableAutoUpdate()mx.events.CollectionEventcreateCursor Crée une nouvelle interface IViewCursor fonctionnant avec cette vue.Nouvelle implémentation IViewCursor. mx.collections:IViewCursor Crée une nouvelle interface IViewCursor fonctionnant avec cette vue. disableAutoUpdate Empêche la vue de distribuer les modifications apportées à la collection et aux éléments de la collection. Empêche la vue de distribuer les modifications apportées à la collection et aux éléments de la collection. Empêche également la vue de mettre à jour les positions des éléments si les positions au sein de la collection changent. Les modifications sont mises en file d’attente et distribuées de façon appropriée après l’appel de la méthode enableAutoUpdate. S’il y a plus d’événements de que mises à jour réalisées sur un élément unique, il se peut que la vue soit réinitialisée. La méthode disableAutoUpdate fonctionne de manière cumulative : pour que la vue distribue les événements et soit actualisée, le nombre d’appels doit être identique au nombre d’appels de la méthode enableAutoUpdate. Sachez que la méthode disableAutoUpdate affecte uniquement les vues individuelles. Les modifications peuvent être détectées au coup par coup par les autres vues. mx.collections.ICollectionView.enableAutoUpdate()mx.events.CollectionEventdispatchEvent event enableAutoUpdate Active la mise à jour automatique. Active la mise à jour automatique. Pour plus d’informations, voir disableAutoUpdate. mx.collections.ICollectionView.disableAutoUpdate()getItemAt Obtient l’élément qui se trouve à l’index spécifié.Elément qui se trouve à cet index ou null si aucun élément n’est retrouvé. indexIndex de la liste à partir duquel extraire l’élément. prefetch0Valeur int indiquant le nombre d’éléments à récupérer au cours de la demande si l’élément n’est pas local, ainsi que leur direction. Obtient l’élément qui se trouve à l’index spécifié. getItemIndex Renvoie l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément.Index de l’élément ou -1 s’il ne se trouve pas dans la liste. itemElément à retrouver. Renvoie l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément.

Remarque : contrairement aux méthodes IViewCursor.findxxx(), la méthode getItemIndex() n’accepte pas les paramètres contenant uniquement un sous-ensemble des champs de l’élément recherché. Cette méthode recherche toujours un élément qui correspond exactement au paramètre d’entrée.

hasEventListener type initialized Appelée automatiquement par le compilateur MXML lorsqu’une occurrence ListCollectionView est créée en utilisant une balise MXML.documentDocument MXML contenant cette occurrence ListCollectionView. idIgnoré. Appelée automatiquement par le compilateur MXML lorsqu’une occurrence ListCollectionView est créée en utilisant une balise MXML. Si vous créez l’occurrence ListCollectionView par le biais d’ActionScript, vous devez appeler cette méthode en transmettant le document MXML et la valeur null pour la propriété id. itemUpdated Signale à la vue qu’un élément a été mis à jour.itemElément mis à jour dans la vue. propertynullNom de la propriété mise à jour. oldValuenullAncienne valeur de cette propriété (si la valeur de la propriété était null, il peut s’agir de l’ancienne valeur de l’élément). newValuenullNouvelle valeur de cette propriété (si la valeur de la propriété était null, il n’est pas nécessaire de la spécifier, car l’élément est supposé correspondre à la nouvelle valeur). Signale à la vue qu’un élément a été mis à jour. Cette méthode est utile lorsque le contenu de la vue n’implémente pas l’interface IPropertyChangeNotifier. Si l’appel de cette méthode inclut un paramètre property, il est possible que la vue puisse optimiser son mécanisme de notification. Dans le cas contraire, elle peut simplement choisir d’actualiser l’ensemble de la vue. mx.events.CollectionEventmx.core.IPropertyChangeNotifiermx.events.PropertyChangeEventrefresh Applique le tri et le filtre à la vue.true si la méthode refresh() est terminée et false si cela n’est pas le cas. Applique le tri et le filtre à la vue. L’interface ICollectionView ne détecte pas automatiquement les modifications apportées à un tri ou à un filtre. Par conséquent, vous devez appeler la méthode refresh() pour actualiser la vue après avoir défini la propriété sort ou filterFunction. Si l’implémentation ICollectionView implémente également l’interface IMXMLObject, vous devez appeler la méthode refresh() à partir de la méthode initialized().

Renvoie true si l’actualisation aboutit et false si le tri n’est pas encore terminé (c’est-à-dire si des éléments sont toujours en attente). Un client de la vue doit attendre un événement CollectionEvent dont la propriété CollectionEventKind.REFRESH est définie sur kind pour faire en sorte que l’opération refresh() aboutisse.

removeAll Supprime tous les éléments de la liste. Supprime tous les éléments de la liste. removeEventListener typelisteneruseCapturefalse removeItemAt Supprime l’élément qui se trouve à l’index spécifié et le renvoie.Elément qui a été supprimé. indexIndex auquel l’élément doit être supprimé. Supprime l’élément qui se trouve à l’index spécifié et le renvoie. Tous les éléments qui se trouvent après cet index se trouvent désormais avancés d’un index. setItemAt Place l’élément à l’index spécifié.Elément remplacé ou null si aucun élément n’a été remplacé. itemNouvel élément à placer à l’index spécifié. indexIndex auquel placer l’élément. Place l’élément à l’index spécifié. Si un élément se trouvait déjà à cet index, le nouvel élément le remplace et il est retourné. toArray Retourne un tableau rempli dans le même ordre en tant que qu’implémentation IList.Tableau. Renvoie un tableau rempli dans le même ordre en tant que qu’implémentation IList. Cette méthode peut renvoyer une erreur ItemPendingError. toString Imprime le contenu de cette vue dans une chaîne et la renvoie.Contenu de cette vue, sous forme de chaîne. Imprime le contenu de cette vue dans une chaîne et la renvoie. willTrigger type localIndex Lorsque la vue est triée ou filtrée, la propriété localIndex contient un tableau d’éléments dans la vue triée ou filtrée (ordonnée ou réduite), dans l’ordre de tri. Lorsque la vue est triée ou filtrée, la propriété localIndex contient un tableau d’éléments dans la vue triée ou filtrée (ordonnée ou réduite), dans l’ordre de tri. La classe ListCollectionView utilise cette propriété pour accéder aux éléments de la vue. La propriété localIndex ne doit pas contenir d’élément non présent dans la source, mais elle ne doit pas obligatoirement contenir tous les éléments de la source. La valeur de cette propriété est null lorsqu’aucun tri n’est réalisé. filterFunction Fonction que la vue utilisera pour éliminer les éléments qui ne correspondent pas aux critères de la fonction. Fonction que la vue utilisera pour éliminer les éléments qui ne correspondent pas aux critères de la fonction. Une fonction filterFunction doit présenter la signature suivante : 
f(item:Object):Boolean
Où la valeur de retour est true si l’élément spécifié doit rester dans la vue.

Si un filtre n’est pas pris en charge, Flex renvoie une erreur lors de l’accès à cette propriété. Pour que la vue soit mise à jour, vous devez appeler la méthode refresh() après avoir défini la propriété filterFunction.

Remarque : les implémentations Flex de l’interface ICollectionView extraient tous les éléments d’un emplacement distant avant d’exécuter la fonction de filtrage. Si vous utilisez la pagination, appliquez le filtre à la collection distante avant d’extraire les données.

refresh()length Nombre d’éléments présents dans cette vue. Nombre d’éléments présents dans cette vue. 0 signifie qu’elle ne contient aucun élément et -1 signifie que la longueur est inconnue. list Interface IList enveloppée par cette vue de collection.mx.collections:IList Interface IList enveloppée par cette vue de collection. sort L’objet ISort qui sera appliqué à l’interface ICollectionView.mx.collections:ISort L’objet ISort qui sera appliqué à l’interface ICollectionView. Le fait de définir le tri n’actualise pas automatiquement la vue. Par conséquent, vous devez appeler la méthode refresh() après avoir défini cette propriété. Si un tri n’est pas pris en charge, une erreur est renvoyée lors de l’accès à cette propriété.

Remarque : les implémentations Flex de l’interface ICollectionView extraient tous les éléments d’un emplacement distant avant de procéder au tri. Si vous utilisez la pagination avec une liste triée, appliquez le tri à la collection distante avant d’extraire les données.

refresh()ICollectionView Une interface ICollectionView est une vue contenant une collection de données.flash.events:IEventDispatcher Une interface ICollectionView est une vue contenant une collection de données. La vue peut être modifiée de façon à afficher des données triées en fonction de divers critères ou des données filtrées, sans modifier les données sous-jacentes. Une interface IViewCursor permet d’accéder aux éléments présents dans une collection. Vous pouvez modifier la collection à l’aide des méthodes insert() et remove() de l’interface IViewCursor.

Une interface ICollectionView peut être une vue contenant des données extraites à partir d’un emplacement distant. Lorsque vous implémentez cette interface pour des données susceptibles d’être distantes, vous devez envisager les situations où les données ne sont pas encore disponibles, signalées par l’erreur ItemPendingError.

L’interface IList constitue une alternative à l’interface ICollectionView.

mx.collections.IViewCursormx.collections.errors.ItemPendingErrormx.collections.IListcollectionChange Distribué lorsque l’interface ICollectionView a été mise à jour.mx.events.CollectionEvent.COLLECTION_CHANGEmx.events.CollectionEvent Distribué lorsque l’interface ICollectionView a été mise à jour. contains Indique en retour si la vue contient l’objet spécifié.true si après application du filtre éventuel, l’interface ICollectionView contient l’élément ; false dans le cas contraire. itemObjet à rechercher. Indique en retour si la vue contient l’objet spécifié. Contrairement aux méthodes IViewCursor.findxxx, cette recherche aboutit uniquement si un élément correspondant exactement au paramètre est trouvé. Si un filtre est appliqué à la vue, cette méthode peut renvoyer false, même si la collection sous-jacente contient bien l’élément. createCursor Crée une nouvelle interface IViewCursor fonctionnant avec cette vue.Nouvelle implémentation IViewCursor. mx.collections:IViewCursor Crée une nouvelle interface IViewCursor fonctionnant avec cette vue. disableAutoUpdate Empêche la vue de distribuer les modifications apportées à la collection et aux éléments de la collection. Empêche la vue de distribuer les modifications apportées à la collection et aux éléments de la collection. Empêche également la vue de mettre à jour les positions des éléments si les positions au sein de la collection changent. Les modifications sont mises en file d’attente et distribuées de façon appropriée après l’appel de la méthode enableAutoUpdate. S’il y a plus d’événements de que mises à jour réalisées sur un élément unique, il se peut que la vue soit réinitialisée. La méthode disableAutoUpdate fonctionne de manière cumulative : pour que la vue distribue les événements et soit actualisée, le nombre d’appels doit être identique au nombre d’appels de la méthode enableAutoUpdate. Sachez que la méthode disableAutoUpdate affecte uniquement les vues individuelles. Les modifications peuvent être détectées au coup par coup par les autres vues. enableAutoUpdate Active la mise à jour automatique. Active la mise à jour automatique. Pour plus d’informations, voir disableAutoUpdate. disableAutoUpdate()itemUpdated Signale à la vue qu’un élément a été mis à jour.itemElément mis à jour dans la vue. propertynullNom de la propriété mise à jour. oldValuenullAncienne valeur de cette propriété (si la valeur de la propriété était null, il peut s’agir de l’ancienne valeur de l’élément). newValuenullNouvelle valeur de cette propriété (si la valeur de la propriété était null, il n’est pas nécessaire de la spécifier, car l’élément est supposé correspondre à la nouvelle valeur). Signale à la vue qu’un élément a été mis à jour. Cette méthode est utile lorsque le contenu de la vue n’implémente pas l’interface IPropertyChangeNotifier. Si l’appel de cette méthode inclut un paramètre property, il est possible que la vue puisse optimiser son mécanisme de notification. Dans le cas contraire, elle peut simplement choisir d’actualiser l’ensemble de la vue. mx.events.CollectionEventmx.core.IPropertyChangeNotifiermx.events.PropertyChangeEventrefresh Applique le tri et le filtre à la vue.true si la méthode refresh() est terminée et false si cela n’est pas le cas. Applique le tri et le filtre à la vue. L’interface ICollectionView ne détecte pas automatiquement les modifications apportées à un tri ou à un filtre. Par conséquent, vous devez appeler la méthode refresh() pour actualiser la vue après avoir défini la propriété sort ou filterFunction. Si l’implémentation ICollectionView implémente également l’interface IMXMLObject, vous devez appeler la méthode refresh() à partir de la méthode initialized().

Renvoie true si l’actualisation aboutit et false si le tri n’est pas encore terminé (c’est-à-dire si des éléments sont toujours en attente). Un client de la vue doit attendre un événement CollectionEvent dont la propriété CollectionEventKind.REFRESH est définie sur kind pour faire en sorte que l’opération refresh() aboutisse.

filterFunction Fonction que la vue utilisera pour éliminer les éléments qui ne correspondent pas aux critères de la fonction. Fonction que la vue utilisera pour éliminer les éléments qui ne correspondent pas aux critères de la fonction. Une fonction filterFunction doit présenter la signature suivante : 
f(item:Object):Boolean
Où la valeur de retour est true si l’élément spécifié doit rester dans la vue.

Si un filtre n’est pas pris en charge, Flex renvoie une erreur lors de l’accès à cette propriété. Pour que la vue soit mise à jour, vous devez appeler la méthode refresh() après avoir défini la propriété filterFunction.

Remarque : les implémentations Flex de l’interface ICollectionView extraient tous les éléments d’un emplacement distant avant d’exécuter la fonction de filtrage. Si vous utilisez la pagination, appliquez le filtre à la collection distante avant d’extraire les données.

refresh()length Nombre d’éléments présents dans cette vue. Nombre d’éléments présents dans cette vue. 0 signifie qu’elle ne contient aucun élément et -1 signifie que la longueur est inconnue. sort L’objet ISort qui sera appliqué à l’interface ICollectionView.mx.collections:ISort L’objet ISort qui sera appliqué à l’interface ICollectionView. Le fait de définir le tri n’actualise pas automatiquement la vue. Par conséquent, vous devez appeler la méthode refresh() après avoir défini cette propriété. Si un tri n’est pas pris en charge, une erreur est renvoyée lors de l’accès à cette propriété.

Remarque : les implémentations Flex de l’interface ICollectionView extraient tous les éléments d’un emplacement distant avant de procéder au tri. Si vous utilisez la pagination avec une liste triée, appliquez le tri à la collection distante avant d’extraire les données.

refresh()CursorBookmark Encapsule les aspects relatifs à la position d’un curseur dans une interface ICollectionView.Object Encapsule les aspects relatifs à la position d’un curseur dans une interface ICollectionView. Les signets permettent de replacer un curseur à sa position absolue au sein de l’interface ICollectionView. mx.collections.IViewCursor.bookmarkmx.collections.IViewCursor.seek()CursorBookmark Crée une nouvelle occurrence d’un signet en utilisant la valeur spécifiée.valueValeur de ce signet. Crée une nouvelle occurrence d’un signet en utilisant la valeur spécifiée. getViewIndex Obtient l’index approximatif de l’élément représenté par ce signet dans la vue.Index de l’élément. Si l’élément ne se trouve pas dans la vue actuelle, cette méthode retourne -1. Cette méthode retourne également -1 s’il est impossible de connaître l’emplacement à l’aide de l’index. Obtient l’index approximatif de l’élément représenté par ce signet dans la vue. Si l’élément ne fait plus l’objet d’une pagination, cette méthode peut renvoyer une erreur ItemPendingError. CURRENT Signet représentant l’élément actuel de l’interface IViewCursor dans une interface ICollectionView.mx.collections:CursorBookmark Signet représentant l’élément actuel de l’interface IViewCursor dans une interface ICollectionView. FIRST Signet du premier élément dans une interface ICollectionView.mx.collections:CursorBookmark Signet du premier élément dans une interface ICollectionView. LAST Signet du dernier élément dans une interface ICollectionView.mx.collections:CursorBookmark Signet du dernier élément dans une interface ICollectionView. Si la vue ne contient aucun élément, ce curseur se trouve à ce signet. value Représentation du marqueur sous-jacent du signet. Représentation du marqueur sous-jacent du signet. Cette valeur est en général comprise uniquement par une implémentation IViewCursor ou ICollectionView. IViewCursor Définit l’interface permettant d’énumérer une vue de collection de manière bidirectionnelle.flash.events:IEventDispatcher Définit l’interface permettant d’énumérer une vue de collection de manière bidirectionnelle. Ce curseur fournit des fonctions de recherche et de gestion de signets, ainsi que des méthodes de modification (insertion et suppression). Lorsqu’un curseur est extrait pour la première fois à partir d’une vue (en général à l’aide de la méthode createCursor() de l’interface ICollectionView), la valeur de la propriété current doit être le premier élément de la vue, sauf si celle-ci est vide. cursorUpdate Distribué lorsque la position du curseur est mise à jour.mx.events.FlexEvent.CURSOR_UPDATEmx.events.FlexEvent Distribué lorsque la position du curseur est mise à jour. findAny Retrouve dans la collection un élément correspondant aux propriétés spécifiées et place le curseur sur cet élément.Lorsque toutes les données sont locales, cette méthode retourne true si l’élément est retrouvé, false dans le cas contraire. valuesCritères de recherche. Les valeurs de l’objet doivent être configurées comme paires nom-valeur, comme dans un tableau associatif, ou correspondre à l’objet réel à rechercher. Les valeurs des noms spécifiés doivent correspondre aux propriétés spécifiées dans le tri. Par exemple, si les propriétés x, y et z sont définies dans le tri actuel, les valeurs spécifiées doivent être {x: x-value, y: y-value, z: z-value}. Retrouve dans la collection un élément correspondant aux propriétés spécifiées et place le curseur sur cet élément. Si l’élément est introuvable, l’emplacement du curseur ne change pas.

La méthode findAny() peut uniquement être appelée sur des vues triées. Si la vue n’est pas triée, une erreur CursorError est renvoyée.

Si la collection associée est distante et que tous les éléments n’ont pas été mis en cache localement, cette méthode procède à une récupération asynchrone à partir de la collection distante. Si une demande de récupération est déjà en cours, cette méthode attend qu’elle soit terminée avant de procéder à une nouvelle demande de récupération.

Si plusieurs éléments correspondent aux critères de recherche, l’élément retrouvé est non déterministe. S’il s’avère indispensable de retrouver la première ou la dernière occurrence d’un élément dans un index non unique, utilisez la méthode findFirst() ou findLast().

Si les données ne sont pas locales et qu’une opération asynchrone doit être réalisée, une erreur ItemPendingError est renvoyée.

findFirst()findLast()mx.collections.errors.ItemPendingErrorfindFirst Retrouve dans la collection le premier élément correspondant aux propriétés spécifiées et place le curseur sur cet élément.Lorsque toutes les données sont locales, cette méthode retourne true si l’élément est retrouvé, false dans le cas contraire. valuesCritères de recherche. Les valeurs de l’objet doivent être configurées comme paires nom-valeur, comme dans un tableau associatif, ou correspondre à l’objet réel à rechercher. Les valeurs des noms spécifiés doivent correspondre aux propriétés spécifiées dans le tri. Par exemple, si les propriétés x, y et z sont définies dans le tri actuel, les valeurs spécifiées doivent être {x: x-value, y: y-value, z: z-value}. Retrouve dans la collection le premier élément correspondant aux propriétés spécifiées et place le curseur sur cet élément. Si l’élément est introuvable, l’emplacement du curseur ne change pas.

La méthode findFirst() peut uniquement être appelée sur des vues triées. Si la vue n’est pas triée, une erreur CursorError est renvoyée.

Si la collection associée est distante et que tous les éléments n’ont pas été mis en cache localement, cette méthode procède à une récupération asynchrone à partir de la collection distante. Si une demande de récupération est déjà en cours, cette méthode attend qu’elle soit terminée avant de procéder à une nouvelle demande de récupération.

S’il n’est pas nécessaire de retrouver la première occurrence d’un élément dans un index non unique, utilisez la méthode findAny(), qui est parfois plus rapide que la méthode findFirst.

Si les données ne sont pas locales et qu’une opération asynchrone doit être réalisée, une erreur ItemPendingError est renvoyée.

findAny()findLast()mx.collections.errors.ItemPendingErrorfindLast Retrouve dans la collection le dernier élément correspondant aux propriétés spécifiées et place le curseur sur cet élément.Lorsque toutes les données sont locales, cette méthode retourne true si l’élément est retrouvé, false dans le cas contraire. valuesCritères de recherche. Les valeurs de l’objet doivent être configurées comme paires nom-valeur, comme dans un tableau associatif, ou correspondre à l’objet réel à rechercher. Les valeurs des noms spécifiés doivent correspondre aux propriétés spécifiées dans le tri. Par exemple, si les propriétés x, y et z sont définies dans le tri actuel, les valeurs spécifiées doivent être {x: x-value, y: y-value, z: z-value}. Retrouve dans la collection le dernier élément correspondant aux propriétés spécifiées et place le curseur sur cet élément. Si l’élément est introuvable, l’emplacement du curseur ne change pas.

La méthode findLast() peut uniquement être appelée sur des vues triées. Si la vue n’est pas triée, une erreur CursorError est renvoyée.

Si la collection associée est distante et que tous les éléments n’ont pas été mis en cache localement, cette méthode procède à une récupération asynchrone à partir de la collection distante. Si une demande de récupération est déjà en cours, cette méthode attend qu’elle soit terminée avant de procéder à une nouvelle demande de récupération.

S’il n’est pas indispensable de retrouver la dernière occurrence d’un élément dans un index non unique, utilisez la méthode findAny(), qui sera peut-être plus rapide.

Si les données ne sont pas locales et qu’une opération asynchrone doit être réalisée, une erreur ItemPendingError est renvoyée.

findAny()findFirst()mx.collections.errors.ItemPendingErrorinsert Insère l’élément spécifié avant la position actuelle du curseur.itemElément à insérer avant la position actuelle du curseur. Insère l’élément spécifié avant la position actuelle du curseur. Si le curseur se trouve en position afterLast, l’insertion est réalisée à la fin de la vue. Si le curseur se trouve en position beforeFirst dans une vue non vide, une erreur est renvoyée. moveNext Déplace le curseur sur l’élément suivant dans la collection.true si la valeur est toujours dans la liste, false si la valeur de la propriété current était initialement afterLast ou si elle a depuis pris cette valeur. Déplace le curseur sur l’élément suivant dans la collection. Si l’opération aboutit, la propriété current est mise à jour de manière à faire référence à l’objet, à son nouvel emplacement. Renvoie true si la propriété current résultante est valide ou false dans le cas contraire (la valeur de la propriété est afterLast).

Si les données ne sont pas locales et qu’une opération asynchrone doit être réalisée, une erreur ItemPendingError est renvoyée. Pour plus d’informations sur l’utilisation de la classe ItemPendingError, voir la documentation relative à ItemPendingError et aux collections.

 
      var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]);
      var cursor:IViewCursor = myArrayCollection.createCursor();
      while (!cursor.afterLast)
      {
          trace(cursor.current);
          cursor.moveNext();
      }
currentmovePrevious()mx.collections.errors.ItemPendingErrormovePrevious Déplace le curseur sur l’élément précédent dans la collection.true si la valeur est toujours dans la liste, false si la valeur de la propriété current était initialement beforeFirst ou si elle a depuis pris cette valeur. Par exemple : 
      var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]);
      var cursor:IViewCursor = myArrayCollection.createCursor();
      cursor.seek(CursorBookmark.last);
      while (!cursor.beforeFirst)
      {
          trace(current);
          cursor.movePrevious();
      }
Déplace le curseur sur l’élément précédent dans la collection. Si l’opération aboutit, la propriété current est mise à jour de manière à faire référence à l’objet, à son nouvel emplacement. Renvoie true si la propriété current résultante est valide ou false dans le cas contraire (la valeur de la propriété est beforeFirst).

Si les données ne sont pas locales et qu’une opération asynchrone doit être réalisée, une erreur ItemPendingError est renvoyée. Pour plus d’informations sur l’utilisation de la classe ItemPendingError, voir la documentation relative à ItemPendingError et aux collections.

currentmoveNext()mx.collections.errors.ItemPendingErrorremove Supprime l’élément actuel et le renvoie.Elément qui a été supprimé. Supprime l’élément actuel et le renvoie. Si la position du curseur est beforeFirst ou afterLast, renvoie une erreur CursorError. Si vous supprimez un élément autre que le dernier élément, le curseur passe à l’élément suivant. Si vous supprimez le dernier élément, le curseur est placé au niveau du signet AFTER_LAST.

Si après la suppression de l’élément, l’élément n’est pas local et qu’une opération asynchrone doit être réalisée, une erreur ItemPendingError est renvoyée. Pour plus d’informations sur l’utilisation de la classe ItemPendingError, voir la documentation relative à ItemPendingError et aux collections.

mx.collections.errors.ItemPendingErrorseek Déplace le curseur sur une position décalée par rapport au signet spécifié.bookmarkmx.collections:CursorBookmarkRéférence CursorBookmark aux informations de marqueur permettant de replacer le curseur sur une position spécifique. Vous pouvez définir ce paramètre sur la valeur renvoyée par la propriété bookmark ou sur l’une des valeurs de constante de signet suivantes :
  • CursorBookmark.FIRST : démarre la recherche à partir du début de la collection (premier élément)
  • CursorBookmark.CURRENT : démarre la recherche à partir de la position actuelle dans la collection
  • CursorBookmark.LAST : démarre la recherche à partir de la fin de la collection (dernier élément)
offset0Indique jusqu’où effectuer la recherche, à partir du signet spécifié. Si le nombre spécifié est négatif, le curseur essaie de se déplacer devant le signet spécifié. Si le décalage spécifié est extérieur à la collection, le curseur est placé par rapport à la fin, sur la positon beforeFirst ou afterLast. prefetch0Paramètre utilisé pour les données distantes. Indique l’intention de procéder à une itération dans une direction spécifique une fois l’opération de recherche terminée. Cela réduit le nombre d’allers-retours réseau requis pendant la recherche. Si la direction de l’itération est connue au moment de la demande, la quantité adaptée de données peut être renvoyée avant la demande pour réaliser l’itération. Déplace le curseur sur une position décalée par rapport au signet spécifié. Le décalage peut être négatif, auquel cas le curseur est placé devant le signet spécifié, la valeur offset désignant le nombre d’éléments entre le curseur et ce signet.

Si la collection associée est distante et que tous les éléments n’ont pas été mis en cache localement, cette méthode procède à une récupération asynchrone à partir de la collection distante.

Si les données ne sont pas locales et qu’une opération asynchrone doit être réalisée, une erreur ItemPendingError est renvoyée. Pour plus d’informations sur l’utilisation de la classe ItemPendingError, voir la documentation relative à ItemPendingError et aux collections.

mx.collections.errors.ItemPendingErrorafterLast Si le curseur se trouve après le dernier élément de la vue, la valeur de cette propriété est true. Si le curseur se trouve après le dernier élément de la vue, la valeur de cette propriété est true. Si l’interface ICollectionView est vide (longueur == 0), la valeur de cette propriété est true. beforeFirst Si le curseur se trouve avant le premier élément de la vue, la valeur de cette propriété est true. Si le curseur se trouve avant le premier élément de la vue, la valeur de cette propriété est true. Si l’interface ICollectionView est vide (longueur == 0), la valeur de cette propriété est true. bookmark Permet d’accéder à un signet correspondant à l’élément renvoyé par la propriété current.mx.collections:CursorBookmark Permet d’accéder à un signet correspondant à l’élément renvoyé par la propriété current. Le signet peut être utilisé pour déplacer le curseur sur un élément précédemment visité ou sur une position relative à cet élément (pour plus d’informations, voir la méthode seek()). currentseek()current Permet d’accéder à l’objet qui se trouve à l’emplacement référencé par le curseur dans la collection source. Permet d’accéder à l’objet qui se trouve à l’emplacement référencé par le curseur dans la collection source. Si le curseur est au-delà des limites de la collection (en position beforeFirst ou afterLast), la valeur retournée est null. moveNext()movePrevious()seek()beforeFirstafterLastview Référence à l’interface ICollectionView à laquelle ce curseur est associé.mx.collections:ICollectionView Référence à l’interface ICollectionView à laquelle ce curseur est associé.