IViewCursor  - AS3 Flex

カーソルがビュー内の最後のアイテムの後にある場合、このプロパティは true になります。 ICollectionView が空（長さ == 0）の場合、このプロパティは true になります。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 cursorUpdate イベントが送出されます。

カーソルがビュー内の最初のアイテムの前にある場合、このプロパティは true になります。 ICollectionView が空（長さ == 0）の場合、このプロパティは true になります。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 cursorUpdate イベントが送出されます。

current プロパティが返したアイテムに対応するブックマークにアクセスできるようにします。 ブックマークを使用して、前にアクセスしたアイテム、またはそのアイテムと相対的な位置にカーソルを移動できます。 詳細については、seek() メソッドを参照してください。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 cursorUpdate イベントが送出されます。

関連する API エレメント

ソースコレクション内でこのカーソルが参照する位置にあるオブジェクトにアクセスできるようにします。 カーソルがコレクションの末尾（beforeFirst、afterLast)を越えた場所にある場合、null を返します。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 cursorUpdate イベントが送出されます。

関連する API エレメント

このカーソルと関連付けられた ICollectionView への参照です。

コレクション内で指定されたプロパティを持つアイテムを探し、そのアイテムにカーソルを移動します。 アイテムが見つからない場合は、カーソル位置は変更されません。

findAny() メソッドは、ソートされたビューに対してのみ呼び出せます。ビューがソートされていない場合は、CursorError がスローされます。

関連付けられたコレクションがリモートで、すべてのアイテムがローカルにキャッシュされているわけではない場合、このメソッドはリモートコレクションから非同期取得を開始します。 処理中の取得要求が存在する場合、このメソッドはその要求の処理が完了するまで待機してから、別の取得要求を送信します。

複数のアイテムが検索条件に一致する場合は、検索されたアイテムは非決定的です。 一意ではないインデックス内で最初のアイテムまたは最後のアイテムを検索する場合は、findFirst() メソッドまたは findLast() メソッドを使用します。

データがローカルではなく、非同期処理を実行する必要がある場合は、ItemPendingError がスローされます。

パラメーター

関連する API エレメント

コレクション内で指定されたプロパティを持つ最初のアイテムを探し、そのアイテムにカーソルを移動します。 アイテムが見つからない場合は、カーソル位置は変更されません。

findFirst() メソッドは、ソートされたビューに対してのみ呼び出せます。ビューがソートされていない場合は、CursorError がスローされます。

関連付けられたコレクションがリモートで、すべてのアイテムがローカルにキャッシュされているわけではない場合、このメソッドはリモートコレクションから非同期取得を開始します。 処理中の取得要求が存在する場合、このメソッドはその要求の処理が完了するまで待機してから、別の取得要求を送信します。

一意ではないインデックス内で、検索されるのが最初のアイテムでなくてもかまわない場合は、findAny() を使用すると、findFirst() メソッドより若干速く処理できます。

データがローカルではなく、非同期処理を実行する必要がある場合は、ItemPendingError がスローされます。

パラメーター

関連する API エレメント

コレクション内で指定されたプロパティを持つ最後のアイテムを探し、そのアイテムにカーソルを移動します。 アイテムが見つからない場合は、カーソル位置は変更されません。

findLast() メソッドは、ソートされたビューに対してのみ呼び出せます。ビューがソートされていない場合は、CursorError がスローされます。

関連付けられたコレクションがリモートで、すべてのアイテムがローカルにキャッシュされているわけではない場合、このメソッドはリモートコレクションから非同期取得を開始します。 処理中の取得要求が存在する場合、このメソッドはその要求の処理が完了するまで待機してから、別の取得要求を送信します。

一意ではないインデックス内で、検索されるのが最後のアイテムでなくてもかまわない場合は、findAny() を使用すると、若干速く処理できます。

データがローカルではなく、非同期処理を実行する必要がある場合は、ItemPendingError がスローされます。

パラメーター

関連する API エレメント

現在のカーソル位置の前に指定したアイテムを挿入します。 カーソルが afterLast の場合、アイテムはビューの末尾に挿入されます。 空ではないビューでカーソルが beforeFirst の場合は、エラーがスローされます。

パラメーター

コレクション内の次のアイテムにカーソルを移動します。 移動すると、current プロパティが更新され、この新しい位置にあるオブジェクトが参照されます。 true を返すのは、結果の current プロパティが有効な場合、false を返すのは、有効でない場合です（プロパティの値が afterLast の場合）。

データがローカルではなく、非同期処理を実行する必要がある場合は、ItemPendingError がスローされます。 ItemPendingError の使用の詳細については、ItemPendingError およびコレクションの説明を参照してください。

関連する API エレメント

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

コレクション内の前のアイテムにカーソルを移動します。 移動すると、current プロパティが更新され、この新しい位置にあるオブジェクトが参照されます。 true を返すのは、結果の current プロパティが有効な場合、false を返すのは、有効でない場合です（プロパティの値が beforeFirst の場合）。

データがローカルではなく、非同期処理を実行する必要がある場合は、ItemPendingError がスローされます。 ItemPendingError の使用の詳細については、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();
      }
      

関連する API エレメント

現在のアイテムを削除し、その現在のアイテムを返します。 カーソルの位置が beforeFirst または afterLast の場合、CursorError をスローします。 最後のアイテム以外のアイテムを削除する場合、カーソルは次のアイテムに移動します。 最後のアイテムを削除すると、カーソルは AFTER_LAST ブックマークに置かれます。

削除されたアイテムの次のアイテムがローカルではなく、非同期処理を実行する必要がある場合は、ItemPendingError がスローされます。 ItemPendingError の使用の詳細については、ItemPendingError およびコレクションの説明を参照してください。

関連する API エレメント

指定されたブックマークから離れたオフセット位置にカーソルを移動します。 負のオフセットを指定することもできます。この場合カーソルは、指定されたブックマークより、offset に指定したアイテム数だけ手前の位置に配置されます。

関連付けられたコレクションがリモートで、すべてのアイテムがローカルでキャッシュされているわけではない場合、このメソッドはリモートコレクションから非同期取得を開始します。

データがローカルではなく、非同期処理を実行する必要がある場合は、ItemPendingError がスローされます。 ItemPendingError の使用の詳細については、ItemPendingError およびコレクションの説明を参照してください。

パラメーター

関連する API エレメント

カーソルの位置が更新されると常に送出されます。

イベントオブジェクトの各プロパティには次の値が設定されています。