HierarchicalCollectionViewCursor

パッケージ	mx.collections
クラス	public class HierarchicalCollectionViewCursor
継承	HierarchicalCollectionViewCursor EventDispatcher Object
実装	IHierarchicalCollectionViewCursor

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

HierarchicalCollectionViewCursor クラスは、標準コレクションの階層ビューのカーソルを定義します。このカーソルが内部を移動するコレクションは階層的である必要はありません。フラットでもかまいません。このクラスは、移動するデータのツリー構造の情報について IHierarchicalData に委任します。

関連する API エレメント

HierarchicalCollectionView

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		afterLast : Boolean [読み取り専用] カーソルがビュー内の最後のアイテムの後にある場合、このプロパティは true になります。	HierarchicalCollectionViewCursor
		beforeFirst : Boolean [読み取り専用] カーソルがビュー内の最初のアイテムの前にある場合、このプロパティは true になります。	HierarchicalCollectionViewCursor
		bookmark : CursorBookmark [読み取り専用] current プロパティが返したアイテムに対応するブックマークにアクセスできるようにします。	HierarchicalCollectionViewCursor
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		current : Object [読み取り専用] ソースコレクション内でこのカーソルが参照する位置にあるオブジェクトにアクセスできるようにします。	HierarchicalCollectionViewCursor
		currentDepth : int [読み取り専用] ソースコレクション内でこのカーソルが参照する位置にあるノードの深さが含まれます。	HierarchicalCollectionViewCursor
		view : ICollectionView [読み取り専用] このカーソルと関連付けられた ICollectionView への参照です。	HierarchicalCollectionViewCursor

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		HierarchicalCollectionViewCursor(collection:HierarchicalCollectionView, model:ICollectionView, hierarchicalData:IHierarchicalData) コンストラクターです。	HierarchicalCollectionViewCursor
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		findAny(values:Object):Boolean コレクション内で指定されたプロパティを持つアイテムを探し、そのアイテムにカーソルを移動します。	HierarchicalCollectionViewCursor
		findFirst(values:Object):Boolean コレクション内で指定されたプロパティを持つ最初のアイテムを探し、そのアイテムにカーソルを移動します。	HierarchicalCollectionViewCursor
		findLast(values:Object):Boolean コレクション内で指定されたプロパティを持つ最後のアイテムを探し、そのアイテムにカーソルを移動します。	HierarchicalCollectionViewCursor
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		insert(item:Object):void 現在のカーソル位置の前に指定したアイテムを挿入します。	HierarchicalCollectionViewCursor
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		moveNext():Boolean コレクション内の次のアイテムにカーソルを移動します。	HierarchicalCollectionViewCursor
		movePrevious():Boolean コレクション内の前のアイテムにカーソルを移動します。	HierarchicalCollectionViewCursor
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		remove():Object 現在のアイテムを削除し、その現在のアイテムを返します。	HierarchicalCollectionViewCursor
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		seek(bookmark:CursorBookmark, offset:int = 0, prefetch:int = 0):void 指定されたブックマークから離れたオフセット位置にカーソルを移動します。	HierarchicalCollectionViewCursor
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

イベント

イベントの詳細についてはここをクリックしてください

継承されるイベントを隠す

継承されるイベントを表示

	イベント		概要	定義元
		activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
		deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher

プロパティの詳細

afterLast

プロパティ

afterLast:Boolean [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

実装
public function get afterLast():Boolean

beforeFirst

プロパティ

beforeFirst:Boolean [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

実装
public function get beforeFirst():Boolean

bookmark

プロパティ

bookmark:CursorBookmark [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

実装
public function get bookmark():CursorBookmark

current

プロパティ

current:Object [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

実装
public function get current():Object

currentDepth

プロパティ

currentDepth:int [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

ソースコレクション内でこのカーソルが参照する位置にあるノードの深さが含まれます。カーソルがコレクションの末尾を越える場合、このプロパティには 0 が含まれます。

実装
public function get currentDepth():int

view

プロパティ

view:ICollectionView [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

実装
public function get view():ICollectionView

コンストラクターの詳細

()

コンストラクター

public function HierarchicalCollectionViewCursor(collection:HierarchicalCollectionView, model:ICollectionView, hierarchicalData:IHierarchicalData)

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

コンストラクターです。

パラメーター

	`collection:HierarchicalCollectionView` — このカーソルが参照する HierarchicalCollectionView インスタンスです。

	`model:ICollectionView` — ソースデータコレクションです。

	`hierarchicalData:IHierarchicalData` — HierarchicalCollectionView インスタンスの作成に使用するデータです。

メソッドの詳細

findAny

()

メソッド

public function findAny(values:Object):Boolean

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

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

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

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

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

パラメーター

values:Object — 検索条件です。オブジェクトの値は、結合配列 (検索する実際のオブジェクト) のように、名前と値のペアとして設定する必要があります。指定した名前の値は、ソートで指定したプロパティと一致する必要があります。例えば、プロパティ x、y、および z が現在のソートに含まれている場合、値は {x: x-value, y: y-value, z: z-value} に指定する必要があります。

戻り値

Boolean — すべてのデータがローカルの場合、このメソッドは、アイテムが見つかる場合は true を返し、見つからない場合は false を返します。

findFirst

()

メソッド

public function findFirst(values:Object):Boolean

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

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

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

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

パラメーター

戻り値

Boolean — すべてのデータがローカルの場合、このメソッドは、アイテムが見つかる場合は true を返し、見つからない場合は false を返します。

findLast

()

メソッド

public function findLast(values:Object):Boolean

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

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

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

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

パラメーター

戻り値

Boolean — すべてのデータがローカルの場合、このメソッドは、アイテムが見つかる場合は true を返し、見つからない場合は false を返します。

insert

()

メソッド

public function insert(item:Object):void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

パラメーター

item:Object — 現在のカーソル位置の前に挿入するアイテムです。

moveNext

()

メソッド

public function moveNext():Boolean

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

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

戻り値

Boolean — まだリスト内の場合は true になります。false になるのは、current の最初の値または現在の値が afterLast の場合です。

movePrevious

()

メソッド

public function movePrevious():Boolean

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

戻り値

Boolean — まだリスト内の場合は true になります。false になるのは、current の最初の値または現在の値が beforeFirst の場合です。次に実際の使用例を示します。

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

remove

()

メソッド

public function remove():Object

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

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

戻り値

Object — 削除されたアイテムです。

seek

()

メソッド

public function seek(bookmark:CursorBookmark, offset:int = 0, prefetch:int = 0):void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

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

パラメーター

	`bookmark:CursorBookmark` — 特定の位置に再配置できるマーカー情報への `CursorBookmark` 参照です。このパラメーターには、`bookmark` プロパティから返された値を設定することも、次のいずれかのブックマーク定数値を設定することもできます。 `CursorBookmark.FIRST` は、コレクションの先頭（最初のエレメント）からシークします。 `CursorBookmark.CURRENT` は、コレクションの現在の位置からシークします。 `CursorBookmark.LAST` は、コレクションの末尾（最後のエレメント）からシークします。

	`offset:int` (default = `0`) — 指定されたブックマークからシークする距離を示します。負の数を指定すると、カーソルは指定のブックマークより手前の位置への移動を試みます。指定されたオフセットがコレクションの末尾を越える場合、カーソルはコレクションの末尾から離れて、`beforeFirst` または `afterLast` の位置に配置されます。

	`prefetch:int` (default = `0`) — リモートデータに使用されます。シーク処理が完了した後、特定の方向に繰り返し処理を実行することを示します。これにより、シーク時に必要なネットワークラウンドトリップ回数が減少します。要求時に反復方向がわかっている場合は、要求の前に適切な量のデータが返され、要求の繰り返し処理を実行できます。

法律上の注意 | プライバシーポリシー

HierarchicalCollectionViewCursor - AS3 Flex

クラス x

afterLast

beforeFirst

bookmark

current

currentDepth

view