This page was saved using jaction on 2006-09-04 8:33:45.
Address: http://flexdocs.kr/docs/flex2/langref/mx/collections/ICollectionView.html
Title: mx.collections.ICollectionView (Flex™ 2 레퍼런스 가이드)  •  Size: 36964
Packagemx.collections
인터페이스public interface ICollectionView extends IEventDispatcher
인프리멘타ListCollectionView

ICollectionView 는, 데이터의 콜렉션에 대한 뷰입니다. 이 뷰는, 기본으로 되는 데이터를 변경하지 않고 , 다양한 조건으로 소트 된 데이터 또는 필터로 좁혀진 데이터의 표시를 실시하도록(듯이) 변경할 수 있습니다. IViewCursor 는 콜렉션내의 아이템에의 액세스를 제공합니다. IViewCursor 인터페이스의 insert() Methods 및 remove() Methods를 사용해 콜렉션을 변경할 수 있습니다.

ICollectionView 는, 리모트로부터 취득한 데이터에 대한 뷰입니다. 리모트의 가능성이 있는 데이터로 이 인터페이스를 Implements하는 경우는,ItemPendingError 로 나타나는, 데이터를 취득할 수 없는 경우를 처리하는 것이 중요합니다.

IList 인터페이스는 ICollectionView 인터페이스 대신에 됩니다.

See also

mx.collections.IViewCursor
mx.collections.errors.ItemPendingError
mx.collections.IList
데이터 프로바이더 및 콜렉션의 사용

Public property
 property정의
  filterFunction : Function
함수의 조건에 일치하지 않는 아이템을 삭제하기 위해서 뷰가 사용하는 함수입니다.
ICollectionView
  length : int
[read-only] 이 뷰내의 아이템의 수입니다.
ICollectionView
  sort : Sort
ICollectionView 에 적용되는 소트입니다.
ICollectionView
Public Methods
 Methods정의
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
IEventDispatcher
  contains (item:Object ):Boolean
뷰로 지정된 object를 포함할지 어떨지를 돌려줍니다.
ICollectionView
  createCursor ():IViewCursor
이 뷰에 대해서 사용하는 새로운 IViewCursor 를 작성합니다.
ICollectionView
  disableAutoUpdate ():void
콜렉션 자체 및 콜렉션내의 아이템의 변경이 뷰로부터 dispatch되지 않게 합니다.
ICollectionView
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
IEventDispatcher
  enableAutoUpdate ():void
자동 갱신을 유효하게 합니다.
ICollectionView
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
IEventDispatcher
  itemUpdated (item:Object , property:Object = null, oldValue:Object = null, newValue:Object = null):void
아이템이 갱신된 뷰를 통지합니다.
ICollectionView
  refresh ():Boolean
뷰에 소트와 필터를 적용합니다.
ICollectionView
 InheritedremoveEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
IEventDispatcher
 InheritedwillTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
IEventDispatcher
이벤트
 이벤트일람정의
  collectionChange ICollectionView 가 어떠한 방법으로 갱신되면 dispatch됩니다. ICollectionView
property의 상세
filterFunctionproperty
filterFunction:Function   [read-write]

함수의 조건에 일치하지 않는 아이템을 삭제하기 위해서 뷰가 사용하는 함수입니다. filterFunction 의 서명은 다음대로 된다고 예상됩니다. 

f(item:Object) :Boolean
지정된 아이템이 뷰에 남아 있는 경우는, 반환값은 true 입니다.

필터가 지원(support)되어 있지 않은 경우는, 이 property에 액세스 하면 에러가 슬로우 됩니다. filterFunction property를 설정한 다음에,refresh() 를 호출해 뷰를 갱신합니다.

메모 : ICollectionView 의 Implements에서는, 필터 함수를 실행하기 전에 리모트로부터 모든 아이템을 취득합니다. 페이징을 사용하고 있는 경우는, 데이터를 취득하기 전에 리모트 콜렉션에 필터를 적용합니다.

Implements
    public function get filterFunction():Function
    public function set filterFunction(value:Function ):void

See also

refresh()
lengthproperty 
length:int   [read-only]

이 뷰내의 아이템의 수입니다. 0 은 아이템이 없는 것을 의미해,-1 는 길이가 불명한 것을 의미합니다.

Implements
    public function get length():int
sortproperty 
sort:Sort   [read-write]

ICollectionView 에 적용되는 소트입니다. 소트를 설정해도 뷰는 자동적으로 갱신되지 않기 때문에, 이 property를 설정한 다음에 refresh() Methods를 호출할 필요가 있습니다. 소트가 지원(support)되어 있지 않은 경우는, 이 property에 액세스 하면 에러가 슬로우 됩니다.

메모 : ICollectionView 의 Implements에서는, 소트를 실행하기 전에 리모트로부터 모든 아이템을 취득합니다. 소트 된 리스트에 페이징을 사용하고 있는 경우는, 데이터를 취득하기 전에 리모트 콜렉션에 소트를 적용합니다.

Implements
    public function get sort():Sort
    public function set sort(value:Sort ):void

See also

refresh()
Methods의 상세
contains()Methods
public function contains(item:Object ):Boolean

뷰로 지정된 object를 포함할지 어떨지를 돌려줍니다. IViewCursor.findxxx Methods의 경우와는 달라, 이 검색이 성공하는 것은, Parameters에 완전하게 일치하는 아이템이 발견되었을 때 뿐입니다. 뷰에 필터가 적용되고 있는 경우, 이 Methods는, 기본으로 되는 콜렉션에 아이템이 포함되어 있는 경우에서도 false 를 돌려줍니다.

Parameters
item:Object — 검색 대상의 object입니다.

반환값
Boolean — 임의의 필터를 적용한 후, ICollectionView 에 아이템이 포함되어 있으면 true 를 돌려줍니다. 그 이외의 경우는, false 를 돌려줍니다.
createCursor()Methods 
public function createCursor():IViewCursor

이 뷰에 대해서 사용하는 새로운 IViewCursor 를 작성합니다.

반환값
IViewCursor — 새로운 IViewCursor Implements입니다.
disableAutoUpdate()Methods 
public function disableAutoUpdate():void

콜렉션 자체 및 콜렉션내의 아이템의 변경이 뷰로부터 dispatch되지 않게 합니다. 콜렉션내에 있어서의 위치가 변경되었을 때에, 뷰내의 아이템의 위치가 갱신되는 것을 방지하는 기능도 합니다. enableAutoUpdate 가 불려 간 다음에, 변경은 적절히 큐에 포함되어 dispatch됩니다. 단일의 아이템에 대해서 갱신보다 많은 이벤트가 발생했을 경우는, 뷰가 리셋트 되는 일이 있습니다. disableAutoUpdate Methods는 누적적으로 동작합니다. 뷰로부터 이벤트가 dispatch되어 뷰가 갱신되려면 ,enableAutoUpdate 가 같은 회수 불려 갈 필요가 있습니다. disableAutoUpdate 는 개개의 뷰에서만 유효하기 때문에, 편집은 다른 뷰에 의해 개별적으로 검출됩니다.

enableAutoUpdate()Methods 
public function enableAutoUpdate():void

자동 갱신을 유효하게 합니다. 상세한 것에 대하여는, 「disableAutoUpdate」를 참조해 주세요.

See also

disableAutoUpdate()
itemUpdated()Methods 
public function itemUpdated(item:Object , property:Object = null, oldValue:Object = null, newValue:Object = null):void

아이템이 갱신된 뷰를 통지합니다. 이 Methods는, 뷰의 내용이 IPropertyChangeNotifier 를 Implements하지 않는 경우에 편리합니다. 이 Methods의 호출에 property Parameters가 포함되어 있는 경우는, 뷰가 통지 메카니즘을 최적화할 수 있는 일이 있습니다. property를 지정하지 않으면 뷰 전체의 단순한 갱신이 선택됩니다.

Parameters
item:Object — 갱신된 뷰내의 아이템입니다.
 
property:Object (default = null) — 갱신된 property의 이름입니다.
 
oldValue:Object (default = null) — 그 property의 낡은 값입니다. property가 null 의 경우는 아이템의 낡은 값을 지정할 수 있습니다.
 
newValue:Object (default = null) — 그 property의 새로운 값입니다. property가 null 의 경우는, 아이템은 새로운 값이라고 보여지기 (위해)때문에 지정할 필요는 없습니다.

See also

mx.events.CollectionEvent
mx.core.IPropertyChangeNotifier
mx.events.PropertyChangeEvent
refresh()Methods 
public function refresh():Boolean

뷰에 소트와 필터를 적용합니다. ICollectionView 는, 소트 또는 필터의 변경을 자동 검출하지 않습니다. 따라서,sort property 또는 filterFunction property의 설정 후에 뷰를 갱신하려면 ,refresh() Methods를 호출할 필요가 있습니다. ICollectionView 에 IMXMLObject 인터페이스도 Implements되고 있는 경우는,initialized() Methods로부터 refresh() Methods를 호출해 주세요.

갱신이 정상적으로 실행되었을 경우는 true 를 돌려주어, 소트가 완료하고 있지 않는 경우 (아이템이 보류중등)는 false 를 돌려줍니다. 뷰의 클라이언트는,refresh() 조작이 완료한 것을 확인하기 위해서 CollectionEventKind.REFRESH kind property를 사용해 CollectionEvent 이벤트를 기다릴 필요가 있습니다.

반환값
Boolean — refresh()가 완료했을 경우는 true, refresh()가 완료하고 있지 않는 경우는 false 입니다.
이벤트의 상세
collectionChangeevent 
Event object type: mx.events.CollectionEvent
CollectionEvent.type property = mx.events.CollectionEvent.COLLECTION_CHANGE

ICollectionView 가 어떠한 방법으로 갱신되면 dispatch됩니다.

CollectionEvent.COLLECTION_CHANGE 정수는, 콜렉션이 변경될 때 dispatch되는 이벤트의 event object의 type property치를 정의합니다.

event object의 각 property에는 다음의 값이 설정되어 있습니다. 이벤트의 종류에 따라서는 무효인 property도 있습니다. 상세한 것에 대하여는, 각 property의 설명을 참조해 주세요.

PropertyValue
bubblesfalse
cancelablefalse
currentTarget이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 myButton.addEventListener() 를 사용하면,currentTarget 의 값은 "myButton" 가 됩니다.
items이벤트의 영향을 받는 아이템의 정보를 가지는 object의 배열입니다. 이 필드의 내용은 이벤트의 종류에 응해 다릅니다. 상세한 것에 대하여는,items property를 참조해 주세요.
kind이벤트의 종류입니다. 유효한 값이 정수로서 CollectionEventKind 클래스에 정의됩니다.
locationitems property로 지정된 아이템의 타겟 콜렉션내에 있어서의 위치입니다.
oldLocationitems property로 지정된 아이템의 콜렉션내에 있어서의 이전의 위치입니다.
target이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,currentTarget property를 사용해 주세요.
typeCollectionEvent.COLLECTION_CHANGE



© 2004-2006 Adobe Systems Incorporated. All rights reserved.
2006.08. 17, 오후 11:21, GMT-07:00


 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/collections/ICollectionView.html