IViewCursor  - AS3 Flex

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.

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

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.

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

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

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

Eléments de l’API associés

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

Eléments de l’API associés

Référence à l’interface ICollectionView à laquelle ce curseur est associé.

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

Paramètres

Eléments de l’API associés

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

Paramètres

Eléments de l’API associés

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

Paramètres

Eléments de l’API associés

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.

Paramètres

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.

Eléments de l’API associés

      var myArrayCollection:ICollectionView = new ArrayCollection([ "Bobby", "Mark", "Trevor", "Jacey", "Tyler" ]);
      var cursor:IViewCursor = myArrayCollection.createCursor();
      while (!cursor.afterLast)
      {
          trace(cursor.current);
          cursor.moveNext();
      }
      

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.

      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();
      }
      

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Paramètres

Eléments de l’API associés

Distribué lorsque la position du curseur est mise à jour.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :