mx.collections.IViewCursor (Flex™ 2 레퍼런스 가이드)

	property	정의
		afterLast : Boolean [read-only] 커서가 뷰내의 마지막 아이템의 뒤에 있으면, 이 property는 `true` 가 됩니다.	IViewCursor
		beforeFirst : Boolean [read-only] 현재의 위치가 뷰내의 최초의 아이템의 전에 있는 경우입니다.	IViewCursor
		bookmark : CursorBookmark [read-only] `current` property로부터 돌려주어진 아이템에 대응하는 북마크에의 액세스를 제공합니다.	IViewCursor
		current : Object [read-only] 소스 콜렉션내에서 이 커서에 의해 참조되고 있는 위치에 있는 object에의 액세스를 제공합니다.	IViewCursor
		view : ICollectionView [read-only] 이 커서와 관련지을 수 있었던 ICollectionView 에의 참조입니다.	IViewCursor

	Methods	정의
		addEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.	IEventDispatcher
		dispatchEvent (event:Event ):Boolean 이벤트를 event 플로우(flow)에 dispatch합니다.	IEventDispatcher
		findAny (values:Object ):Boolean 콜렉션내에서 지정된 property를 가지는 아이템을 찾아, 그 아이템에 커서를 배치합니다.	IViewCursor
		findFirst (values:Object ):Boolean 콜렉션내에서 지정된 property를 가지는 최초의 아이템을 찾아, 그 아이템에 커서를 배치합니다.	IViewCursor
		findLast (values:Object ):Boolean 콜렉션내에서 지정된 property를 가지는 마지막 아이템을 찾아, 그 아이템에 커서를 배치합니다.	IViewCursor
		hasEventListener (type:String ):Boolean EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.	IEventDispatcher
		insert (item:Object ):void 현재의 커서 위치전으로 지정한 아이템을 삽입합니다.	IViewCursor
		moveNext ():Boolean 콜렉션내의 다음의 아이템에 커서를 이동합니다.	IViewCursor
		movePrevious ():Boolean 콜렉션내의 앞의 아이템에 커서를 이동합니다.	IViewCursor
		remove ():Object 현재의 아이템을 삭제해, 현재의 아이템을 돌려줍니다.	IViewCursor
		removeEventListener (type:String , listener:Function , useCapture:Boolean = false):void EventDispatcher object로부터 listener를 삭제합니다.	IEventDispatcher
		seek (bookmark:CursorBookmark , offset:int = 0, prefetch:int = 0):void 지정된 북마크로부터 멀어진 오프셋(offset) 위치에 커서를 이동합니다.	IViewCursor
		willTrigger (type:String ):Boolean 지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.	IEventDispatcher

	이벤트	일람	정의
		cursorUpdate	커서의 위치가 갱신되면 항상 dispatch됩니다.	IViewCursor

afterLast:Boolean [read-only]

커서가 뷰내의 마지막 아이템의 뒤에 있으면, 이 property는 true 가 됩니다. ICollectionView 가 empty (길이 == 0)의 경우는, 이 property는 true 가 됩니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

Implements
public function get afterLast():Boolean

beforeFirst:Boolean [read-only]

커서가 뷰내의 최초의 아이템의 전에 있으면, 이 property는 true 가 됩니다. ICollectionView 가 empty (길이 == 0)의 경우는, 이 property는 true 가 됩니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

Implements
public function get beforeFirst():Boolean

bookmark:CursorBookmark [read-only]

current property로부터 돌려주어진 아이템에 대응하는 북마크에의 액세스를 제공합니다. 이 북마크를 사용해, 전에 액세스 한 아이템, 또는 그 아이템과의 상대 위치에 커서를 이동할 수 있습니다. 상세한 것에 대하여는,seek() Methods를 참조해 주세요.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

Implements
public function get bookmark():CursorBookmark

See also

current
seek()

current:Object [read-only]

소스 콜렉션내에서 이 커서에 의해 참조되고 있는 위치에 있는 object에의 액세스를 제공합니다. 커서가 콜렉션의 말미를 넘은 장소에 있는 경우 (beforeFirst,afterLast),null 를 돌려줍니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

Implements
public function get current():Object

view:ICollectionView [read-only]

이 커서와 관련지을 수 있었던 ICollectionView 에의 참조입니다.

Implements
public function get view():ICollectionView

public function findAny(values:Object ):Boolean

콜렉션내에서 지정된 property를 가지는 아이템을 찾아, 그 아이템에 커서를 배치합니다. 아이템이 발견되지 않는 경우는, 커서 위치는 변경되지 않습니다.

findAny() Methods는, 소트 된 뷰 에 대해서만 호출할 수가 있습니다. 뷰가 소트되어 있지 않은 경우는,CursorError 가 슬로우 됩니다.

관련지을 수 있었던 콜렉션이 리모트로, 모든 아이템이 로컬로 캐쉬되고 있는 것은 아닌 경우는, 이 Methods는 리모트 콜렉션으로부터 비동기 취득을 개시합니다. 처리중의 취득 요구가 존재하는 경우, 이 Methods는 그 요구의 처리가 완료할 때까지 대기하고 나서, 다른 취득 요구를 송신합니다.

복수의 아이템이 검색 조건에 일치하는 경우는, 검색된 아이템은 비결정적입니다. 일의가 아닌 인덱스내에서 최초 또는 마지막 아이템을 검색하는 경우는,findFirst() 또는 findLast() Methods를 사용합니다.

Parameters의 값은, 결합 배열 (검색하는 실제의 object)과 같이, 이름과 값의 페어로서 설정할 필요가 있습니다. 지정한 이름의 값은, 소트로 지정한 property에 일치할 필요가 있습니다. 예를 들어, property x,y, 및 z 가 현재의 소트에 포함되어 있는 경우이면, 값 {x: x-value, y: y-value, z: z-value} 를 지정합니다.

모든 데이터가 로컬의 경우, 이 Methods는, 아이템이 발견되는 경우는 true 를 돌려주어, 발견되지 않는 경우는 false 를 돌려줍니다. 데이터가 로컬은 아니고, 비동기 처리를 실행할 필요가 있는 경우는, ItemPendingError 가 슬로우 됩니다.

Parameters

values:Object

반환값

Boolean

public function findFirst(values:Object ):Boolean

콜렉션내에서 지정된 property를 가지는 최초의 아이템을 찾아, 그 아이템에 커서를 배치합니다. 아이템이 발견되지 않는 경우는, 커서 위치는 변경되지 않습니다.

findFirst() Methods는, 소트 된 뷰 에 대해서만 호출할 수가 있습니다. 뷰가 소트되어 있지 않은 경우는,CursorError 가 슬로우 됩니다.

관련지을 수 있었던 콜렉션이 리모트로, 모든 아이템이 로컬로 캐쉬되고 있는 것은 아닌 경우는, 이 Methods는 리모트 콜렉션으로부터 비동기 취득을 개시합니다. 처리중의 취득 요구가 존재하는 경우, 이 Methods는 그 요구의 처리가 완료할 때까지 대기하고 나서, 다른 취득 요구를 송신합니다.

일의가 아닌 인덱스내에서, 검색되는 것이 최초의 아이템이 아니어도 상관없는 경우는,findAny() 를 사용하면,findFirst() method 보다 약간 빠르게 처리할 수 있습니다.

지정하는 값은, 결합 배열 (검색하는 실제의 object)과 같이, 이름과 값의 페어로서 설정할 필요가 있습니다. 지정한 이름의 값은, 소트로 지정한 property에 일치할 필요가 있습니다. 예를 들어, property x,y, 및 z 가 현재의 소트에 포함되어 있는 경우이면, 값 {x: x-value, y: y-value, z: z-value} 를 지정합니다.

모든 데이터가 로컬의 경우, 이 Methods는, 아이템이 발견되는 경우는 true 를 돌려주어, 발견되지 않는 경우는 false 를 돌려줍니다. 데이터가 로컬은 아니고, 비동기 처리를 실행할 필요가 있는 경우는, ItemPendingError 가 슬로우 됩니다.

Parameters

values:Object

반환값

Boolean

public function findLast(values:Object ):Boolean

콜렉션내에서 지정된 property를 가지는 마지막 아이템을 찾아, 그 아이템에 커서를 배치합니다. 아이템이 발견되지 않는 경우는, 커서 위치는 변경되지 않습니다.

findLast() Methods는, 소트 된 뷰 에 대해서만 호출할 수가 있습니다. 뷰가 소트되어 있지 않은 경우는,CursorError 가 슬로우 됩니다.

관련지을 수 있었던 콜렉션이 리모트로, 모든 아이템이 로컬로 캐쉬되고 있는 것은 아닌 경우는, 이 Methods는 리모트 콜렉션으로부터 비동기 취득을 개시합니다. 처리중의 취득 요구가 존재하는 경우, 이 Methods는 그 요구의 처리가 완료할 때까지 대기하고 나서, 다른 취득 요구를 송신합니다.

일의가 아닌 인덱스내에서, 검색되는 것이 마지막 아이템이 아니어도 상관없는 경우는,findAny() 를 사용하면, 약간 빠르게 처리할 수 있습니다.

지정하는 값은, 결합 배열 (검색하는 실제의 object)과 같이, 이름과 값의 페어로서 설정할 필요가 있습니다. 지정한 이름의 값은, 소트로 지정한 property에 일치할 필요가 있습니다. 예를 들어, property x,y, 및 z 가 현재의 소트에 포함되어 있는 경우이면, 값 {x: x-value, y: y-value, z: z-value} 를 지정합니다.

모든 데이터가 로컬의 경우, 이 Methods는, 아이템이 발견되는 경우는 true 를 돌려주어, 발견되지 않는 경우는 false 를 돌려줍니다. 데이터가 로컬은 아니고, 비동기 처리를 실행할 필요가 있는 경우는, ItemPendingError 가 슬로우 됩니다.

Parameters

values:Object

반환값

Boolean

public function insert(item:Object ):void

현재의 커서 위치전으로 지정한 아이템을 삽입합니다. 커서가 afterLast 의 경우, 뷰의 말미에 삽입됩니다. empty이 아닌 뷰로 커서가 beforeFirst 의 경우는, 에러가 슬로우 됩니다.

Parameters

item:Object

public function moveNext():Boolean

콜렉션내의 다음의 아이템에 커서를 이동합니다. 이동하면,current property가 갱신되어, 이 새로운 위치에 있는 object를 참조합니다. 이 결과의 current property의 값이 유효하면 true 를, 유효하지 않은 경우 (property의 값이 afterLast 의 경우)는 false 를 돌려줍니다.

데이터가 로컬은 아니고, 비동기 처리를 실행할 필요가 있는 경우는, ItemPendingError 가 슬로우 됩니다. ItemPendingError 의 사용의 상세한 것에 대하여는, ItemPendingError 및 콜렉션의 설명을 참조해 주세요.

반환값

Boolean — 아직 리스트내의 경우는 true 가 되어,current 의 최초의 값 또는 현재의 값이 afterLast 의 경우는 false 가 됩니다.

Example

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

public function movePrevious():Boolean

콜렉션내의 앞의 아이템에 커서를 이동합니다. 이동하면,current property가 갱신되어, 이 새로운 위치에 있는 object를 참조합니다. 이 결과의 current property의 값이 유효하면 true 를, 유효하지 않은 경우 (property의 값이 beforeFirst 의 경우)는 false 를 돌려줍니다.

데이터가 로컬은 아니고, 비동기 처리를 실행할 필요가 있는 경우는, ItemPendingError 가 슬로우 됩니다. ItemPendingError 의 사용의 상세한 것에 대하여는, ItemPendingError 및 콜렉션의 설명을 참조해 주세요.

반환값

Boolean — 아직 리스트내의 경우는 true 가 되어,current 의 최초의 값 또는 현재의 값이 beforeFirst 의 경우는 false 가 됩니다.

Example

var myArrayCollection:ICollectionView = new ArrayCollection(["Bobby", "Mark", "Trevor", "Jacey", "Tyler"]);
var cursor:ICursor = myArrayCollection.createCursor();
cursor.seek(CursorBookmark.last);
while (! cursor.beforeFirst)
      {
trace(current);
cursor.movePrevious();
      }

public function remove():Object

현재의 아이템을 삭제해, 현재의 아이템을 돌려줍니다. 커서의 위치가 beforeFirst 또는 afterLast 의 경우는, CursorError 를 슬로우 합니다. 마지막 아이템 이외의 아이템을 삭제하는 경우, 커서는 다음의 아이템으로 이동합니다. 마지막 아이템을 삭제하면, 커서는 AFTER_LAST 북마크에 놓여집니다.

삭제된 아이템의 다음의 아이템이 로컬은 아니고, 비동기 처리를 실행할 필요가 있는 경우는, ItemPendingError 가 슬로우 됩니다. ItemPendingError 의 사용의 상세한 것에 대하여는, ItemPendingError 및 콜렉션의 설명을 참조해 주세요.

반환값

Object

See also

mx.collections.errors.ItemPendingError

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

지정된 북마크로부터 멀어진 오프셋(offset) 위치에 커서를 이동합니다. 부의 오프셋(offset)를 지정할 수도 있습니다. 이 경우 커서는, 지정된 북마크보다,offset 로 지정한 아이템수만큼 앞의 위치에 배치됩니다.

관련지을 수 있었던 콜렉션이 리모트로, 모든 아이템이 로컬로 캐쉬되고 있는 것은 아닌 경우는, 이 Methods는 리모트 콜렉션으로부터 비동기 취득을 개시합니다.

데이터가 로컬은 아니고, 비동기 처리를 실행할 필요가 있는 경우는, ItemPendingError 가 슬로우 됩니다. ItemPendingError 의 사용의 상세한 것에 대하여는, ItemPendingError 및 콜렉션의 설명을 참조해 주세요.

Parameters

	`bookmark:CursorBookmark` — 특정의 위치에 재배치할 수 있는 마커 정보에의 `CursorBookmark` 참조입니다. 이 Parameters에는,`bookmark` property로부터 돌려주어진 값을 설정하는 일도, 다음의 몇개의 북마크 정수치를 설정할 수도 있습니다. `CursorBookmark.FIRST` - 콜렉션의 선두 (최초의 엘리먼트)로부터 시크 합니다. `CursorBookmark.CURRENT` - 콜렉션의 현재의 위치로부터 시크 합니다. `CursorBookmark.LAST` - 콜렉션의 말미 (마지막 엘리먼트)로부터 시크 합니다.

	`offset:int` (default = `0`) — 시크 하는 지정 북마크로부터의 거리를 나타냅니다. 부의 수를 지정하면, 커서는 지정의 북마크보다 앞의 위치에 이동을 시도합니다. 지정의 오프셋(offset)가 콜렉션의 말미를 넘는 경우는, 커서는 말미를 넘어`beforeFirst` 또는 `afterLast` 의 위치에 배치됩니다.

	`prefetch:int` (default = `0`) — 리모트 데이터에 사용됩니다. 시크 처리가 완료하면, 특정의 방향으로 반복 처리를 실행하는 의도를 나타냅니다. 이것에 의해, 시크시에, 필요한 네트워크 왕복 여행수가 감소합니다. 요구시에 반복 방향을 알 수 있고 있는 경우는, 요구전에 적절한 양의 데이터가 돌려주어져 요구의 반복 처리를 실행할 수 있습니다.

See also

mx.collections.errors.ItemPendingError

Event object type: mx.events.FlexEvent
FlexEvent.type property = mx.events.FlexEvent.CURSOR_UPDATE

커서의 위치가 갱신되면 항상 dispatch됩니다.

FlexEvent.CURSOR_UPDATE 정수에 의해,cursorUpdate 이벤트의 event object의 type property치가 정의됩니다.

event object의 각 property에는 다음의 값이 설정됩니다.

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 `myButton.addEventListener()` 를 사용하면,`currentTarget` 의 값은 "myButton" 가 됩니다.
`target`	이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,`currentTarget` property를 사용해 주세요.

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Interface IViewCursor	property \| Methods \| event

Package	mx.collections
인터페이스	public interface IViewCursor extends IEventDispatcher