AsyncListView  - AS3 Flex

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.

La valeur par défaut est A function that unconditionally returns null..

Eléments de l’API associés

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.

La valeur par défaut est A function that unconditionally returns null..

Eléments de l’API associés

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.

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

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.

La valeur par défaut est null.

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

Constructeur.

Ajoute l’élément spécifié à la fin de la liste. Equivaut à addItemAt(élément, longueur).

Paramètres

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.

Paramètres

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.

Paramètres

Eléments de l’API associés

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.

Paramètres

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.

Paramètres

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.

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.

Paramètres

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

Paramètres

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

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.

Distribué lorsque la longueur de la liste a été modifiée ou qu’un élément list est remplacé.

Les valeurs des propriétés de l’objet d’événement sont les suivantes : Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.