IViewCursor  - AS3 Flex

If the cursor is located after the last item in the view, this property is true . If the ICollectionView is empty (length == 0), this property is true.

This property can be used as the source for data binding. When this property is modified, it dispatches the cursorUpdate event.

If the cursor is located before the first item in the view, this property is true. If the ICollectionView is empty (length == 0), this property is true.

This property can be used as the source for data binding. When this property is modified, it dispatches the cursorUpdate event.

Provides access to a bookmark that corresponds to the item returned by the current property. The bookmark can be used to move the cursor to a previously visited item, or to a position relative to that item. (See the seek() method for more information.)

This property can be used as the source for data binding. When this property is modified, it dispatches the cursorUpdate event.

Related API Elements

Provides access the object at the location in the source collection referenced by this cursor. If the cursor is beyond the ends of the collection (beforeFirst, afterLast) this will return null.

This property can be used as the source for data binding. When this property is modified, it dispatches the cursorUpdate event.

Related API Elements

A reference to the ICollectionView with which this cursor is associated.

Finds an item with the specified properties within the collection and positions the cursor to that item. If the item can not be found, the cursor location does not change.

The findAny() method can only be called on sorted views; if the view isn't sorted, a CursorError is thrown.

If the associated collection is remote, and not all of the items have been cached locally, this method begins an asynchronous fetch from the remote collection. If one is already in progress, this method waits for it to complete before making another fetch request.

If multiple items can match the search criteria then the item found is non-deterministic. If it is important to find the first or last occurrence of an item in a non-unique index, use the findFirst() or findLast() method.

If the data is not local and an asynchronous operation must be performed, an ItemPendingError is thrown.

Parameters

Related API Elements

Finds the first item with the specified properties within the collection and positions the cursor to that item. If the item can not be found, no cursor location does not change.

The findFirst() method can only be called on sorted views; if the view isn't sorted, a CursorError is thrown.

If the associated collection is remote, and not all of the items have been cached locally, this method begins an asynchronous fetch from the remote collection. If one is already in progress, this method waits for it to complete before making another fetch request.

If it is not important to find the first occurrence of an item in a non-unique index, use findAny(), which may be a little faster than the findFirst() method.

If the data is not local and an asynchronous operation must be performed, an ItemPendingError is thrown.

Parameters

Related API Elements

Finds the last item with the specified properties within the collection and positions the cursor on that item. If the item can not be found, the cursor location does not chanage.

The findLast() method can only be called on sorted views; if the view isn't sorted, a CursorError is thrown.

If the associated collection is remote, and not all of the items have been cached locally, this method begins an asynchronous fetch from the remote collection. If one is already in progress, this method waits for it to complete before making another fetch request.

If it is not important to find the last occurrence of an item in a non-unique index, use the findAny() method, which may be a little faster.

If the data is not local and an asynchronous operation must be performed, an ItemPendingError is thrown.

Parameters

Related API Elements

Inserts the specified item before the cursor's current position. If the cursor is afterLast, the insertion occurs at the end of the view. If the cursor is beforeFirst on a non-empty view, an error is thrown.

Parameters

Moves the cursor to the next item within the collection. On success the current property is updated to reference the object at this new location. Returns true if the resulting current property is valid, or false if not (the property value is afterLast).

If the data is not local and an asynchronous operation must be performed, an ItemPendingError is thrown. See the ItemPendingError documentation and the collections documentation for more information on using the ItemPendingError.

Related API Elements

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

Moves the cursor to the previous item within the collection. On success the current property is updated to reference the object at this new location. Returns true if the resulting current property is valid, or false if not (the property value is beforeFirst).

If the data is not local and an asynchronous operation must be performed, an ItemPendingError is thrown. See the ItemPendingError documentation and the collections documentation for more information on using the ItemPendingError.

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

Related API Elements

Removes the current item and returns it. If the cursor location is beforeFirst or afterLast, throws a CursorError. If you remove any item other than the last item, the cursor moves to the next item. If you remove the last item, the cursor is at the AFTER_LAST bookmark.

If the item after the removed item is not local and an asynchronous operation must be performed, an ItemPendingError is thrown. See the ItemPendingError documentation and the collections documentation for more information on using the ItemPendingError.

Related API Elements

Moves the cursor to a location at an offset from the specified bookmark. The offset can be negative, in which case the cursor is positioned an offset number of items prior to the specified bookmark.

If the associated collection is remote, and not all of the items have been cached locally, this method begins an asynchronous fetch from the remote collection.

If the data is not local and an asynchronous operation must be performed, an ItemPendingError is thrown. See the ItemPendingError documentation and the collections documentation for more information on using the ItemPendingError.

Parameters

Related API Elements

Dispatched whenever the cursor position is updated.

The properties of the event object have the following values: