ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
mx.collections 

CursorBookmark  - AS3 Flex

Packagemx.collections
Classpublic class CursorBookmark
InheritanceCursorBookmark Inheritance Object

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Encapsulates the positional aspects of a cursor in an ICollectionView. Bookmarks are used to return a cursor to an absolute position within the ICollectionView.

Related API Elements



Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  CURRENT : CursorBookmark
[static] [read-only] A bookmark representing the current item for the IViewCursor in an ICollectionView.
CursorBookmark
  FIRST : CursorBookmark
[static] [read-only] A bookmark for the first item in an ICollectionView.
CursorBookmark
  LAST : CursorBookmark
[static] [read-only] A bookmark for the last item in an ICollectionView.
CursorBookmark
  value : Object
[read-only] The underlying marker representation of the bookmark.
CursorBookmark
Public Methods
 MethodDefined By
  
Creates a new instance of a bookmark with the specified value.
CursorBookmark
  
Gets the approximate index of the item represented by this bookmark in its view.
CursorBookmark
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
Property Detail

CURRENT

property
CURRENT:CursorBookmark  [read-only]

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

A bookmark representing the current item for the IViewCursor in an ICollectionView.



Implementation
    public static function get CURRENT():CursorBookmark

FIRST

property 
FIRST:CursorBookmark  [read-only]

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

A bookmark for the first item in an ICollectionView.



Implementation
    public static function get FIRST():CursorBookmark

LAST

property 
LAST:CursorBookmark  [read-only]

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

A bookmark for the last item in an ICollectionView. If the view has no items, the cursor is at this bookmark.



Implementation
    public static function get LAST():CursorBookmark

value

property 
value:Object  [read-only]

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

The underlying marker representation of the bookmark. This value is generally understood only by the IViewCursor or ICollectionView implementation.



Implementation
    public function get value():Object
Constructor Detail

CursorBookmark

()Constructor
public function CursorBookmark(value:Object)

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Creates a new instance of a bookmark with the specified value.

Parameters
value:Object — The value of this bookmark.
Method Detail

getViewIndex

()method
public function getViewIndex():int

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Gets the approximate index of the item represented by this bookmark in its view. If the item has been paged out, this method could throw an ItemPendingError.

Returns
int — The index of the item. If the item is not in the current view, this method returns -1. This method also returns -1 if index-based location is not possible.