This page was saved using jaction on 2006-09-04 8:33:51.
Address: http://flexdocs.kr/docs/flex2/langref/mx/collections/ListCollectionView.html
Title: mx.collections.ListCollectionView (Flex™ 2 레퍼런스 가이드)  •  Size: 88443
Packagemx.collections
Classpublic class ListCollectionView
InheritanceListCollectionView Inheritance Proxy Inheritance Object
ImplementsICollectionView , IList , IMXMLObject
SubclassesArrayCollection , XMLListCollection

ListCollectionView 클래스에서는,ICollectionView 인터페이스의 property와 Methods가 IList 인터페이스에 적합하는 object에 추가됩니다. 따라서,IList 또는 ICollectionView 를 필요로 하는 것에 이 클래스의 object를 건네줄 수가 있습니다.

이 클래스에서는,[] 배열 표기를 사용해 getItemAt() Methods 및 setItemAt() Methods에 액세스 할 수도 있습니다. myListCollectionView[index] 등의 코드를 사용하면,myListCollectionView object의 getItemAt() Methods 또는 setItemAt() Methods가 불려 갑니다.

MXML 문장구조법expandedMXML 문장구조법의 비표시

<mx:ListCollectionView> 의 속성은 다음과 같습니다. 이 속성은, 모든 서브 클래스에 Inheritance됩니다. 

 <mx:ListCollectionView property filterFunction="null" list="null" sort="null"
 event collectionChange="디폴트 없음" />

Public property
 property정의
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor　 　 함수에의 참조입니다.
Object
  filterFunction : Function
함수의 조건에 일치하지 않는 아이템을 삭제하기 위해서 뷰가 사용하는 함수입니다.
ListCollectionView
  length : int
[read-only] 이 뷰내의 아이템의 수입니다.
ListCollectionView
  list : IList
이 콜렉션뷰가 둘러싸는 IList 입니다.
ListCollectionView
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  sort : Sort
ICollectionView 에 적용되는 소트입니다.
ListCollectionView
Protected property
 property정의
  localIndex : Array
뷰에 소트 또는 필터를 적용하면, 그 뷰 (소트에 의해 아이템의 순서가 변경되었는지, 또는 필터에 의해 아이템수가 줄어든 뷰)에 포함되어 있는 아이템의 배열이 localIndex property에 소트순서에 포함됩니다.
ListCollectionView
Public Methods
 Methods정의
  ListCollectionView (list:IList = null)
ListCollectionView constructor　 　 입니다.
ListCollectionView
  addEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
ListCollectionView
  addItem (item:Object ):void
지정된 아이템을 리스트의 말미에 추가합니다.
ListCollectionView
  addItemAt (item:Object , index:int ):void
지정된 인덱스 위치에 아이템을 추가합니다.
ListCollectionView
  contains (item:Object ):Boolean
뷰로 지정된 object를 포함할지 어떨지를 돌려줍니다.
ListCollectionView
  createCursor ():IViewCursor
이 뷰에 대해서 사용하는 새로운 IViewCursor 를 작성합니다.
ListCollectionView
  disableAutoUpdate ():void
콜렉션 자체 및 콜렉션내의 아이템의 변경이 뷰로부터 dispatch되지 않게 합니다.
ListCollectionView
  dispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
ListCollectionView
  enableAutoUpdate ():void
자동 갱신을 유효하게 합니다.
ListCollectionView
  getItemAt (index:int , prefetch:int = 0):Object
지정된 인덱스 위치에 있는 아이템을 취득합니다.
ListCollectionView
  getItemIndex (item:Object ):int
아이템이 리스트내에 있어, getItemAt(index) == 아이템이 되는 것 같은 경우는, 아이템의 인덱스를 돌려줍니다.
ListCollectionView
  hasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
ListCollectionView
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
  initialized (document:Object , id:String ):void
MXML 태그를 사용해 ListCollectionView 를 작성했을 때에, MXML 컴파일러에 의해 자동적으로 불려 갑니다.
ListCollectionView
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
  itemUpdated (item:Object , property:Object = null, oldValue:Object = null, newValue:Object = null):void
아이템이 갱신된 뷰를 통지합니다.
ListCollectionView
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
  refresh ():Boolean
뷰에 소트와 필터를 적용합니다.
ListCollectionView
  removeAll ():void
리스트로부터 모든 아이템을 삭제합니다.
ListCollectionView
  removeEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
ListCollectionView
  removeItemAt (index:int ):Object
지정된 인덱스 위치에 있는 아이템을 삭제해, 돌려줍니다.
ListCollectionView
  setItemAt (item:Object , index:int ):Object
지정된 인덱스 위치에 아이템을 배치합니다.
ListCollectionView
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
  toArray ():Array
IList Implements과 같은 순서로 지정된 배열을 돌려줍니다.
ListCollectionView
  toString ():String
이 뷰의 내용을 string에 프리티프린트 해, 돌려줍니다.
ListCollectionView
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
  willTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
ListCollectionView
Protected Methods
 Methods정의
 InheritedcallProperty (name:* , ... rest):*
함수로서 호출해 가능한 object property의 동작을 덧쓰기합니다.
Proxy
 InheriteddeleteProperty (name:* ):Boolean
property를 삭제하는 요구를 덧쓰기합니다.
Proxy
 InheritedgetDescendants (name:* ):*
descendant 연산자의 사용을 재정의(override) 합니다.
Proxy
 InheritedgetProperty (name:* ):*
property의 값에 대한 요구를 덧쓰기합니다.
Proxy
 InheritedhasProperty (name:* ):Boolean
object가 특정의 property를 가지고 있을지 어떨지를 이름 마다 체크하는 요구를 덧쓰기합니다.
Proxy
 InheritedisAttribute (name:* ):Boolean
지정된 QName 가 속성으로서 마크 되고 있는지 어떤지를 확인합니다.
Proxy
 InheritednextName (index:int ):String
인덱스 번호를 사용해, 프록시가 되는 object의 property를 열거해 property명을 취득할 수 있습니다.
Proxy
 InheritednextNameIndex (index:int ):int
인덱스 번호를 사용해, 프록시가 되는 object의 property를 열거할 수 있습니다.
Proxy
 InheritednextValue (index:int ):*
인덱스 번호를 사용해, 프록시가 되는 object의 property를 열거해 property치를 취득할 수 있습니다.
Proxy
 InheritedsetProperty (name:* , value:* ):void
property의 값을 변경하는 호출을 덧쓰기합니다.
Proxy
이벤트
 이벤트일람정의
  collectionChange ICollectionView 가 어떠한 방법으로 갱신되면 dispatch됩니다. ListCollectionView
property의 상세
filterFunctionproperty
filterFunction:Function   [read-write]

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

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

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

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

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

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

See also

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

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

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

Implements
    public function get length():int
listproperty 
list:IList   [read-write]

이 콜렉션뷰가 둘러싸는 IList 입니다.

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

Implements
    public function get list():IList
    public function set list(value:IList ):void
localIndexproperty 
protected var localIndex:Array

뷰에 소트 또는 필터를 적용하면, 그 뷰 (소트에 의해 아이템의 순서가 변경되었는지, 또는 필터에 의해 아이템수가 줄어든 뷰)에 포함되어 있는 아이템의 배열이 localIndex property에 소트순서에 포함됩니다. ListCollectionView 클래스는 이 property를 사용해, 뷰내의 아이템에 액세스 합니다. localIndex property는, 소스에 없는 것을 포함할 수 없습니다만, 소스내에 있는 모든 것을 포함할 수도 있습니다. 소트가 실행되지 않는 경우, 이 property는 null 가 됩니다.

sortproperty 
sort:Sort   [read-write]

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

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

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

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

See also

refresh()
constructor　 　 의 상세
ListCollectionView()constructor　 　
public 함수 ListCollectionView(list:IList = null)

ListCollectionView constructor　 　 입니다.

Parameters
list:IList (default = null) — 이 ListCollectionView 가 둘러싸는 IList 입니다.
Methods의 상세
addEventListener()Methods
public function addEventListener(type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다. event listener는, 특정의 타입의 이벤트, 단계, 및 우선도에 관한 표시 리스트내의 모든 노드에 등록할 수 있습니다.

event listener가 정상적으로 등록된 후에,addEventListener() 를 한층 더 호출해 우선도를 변경할 수 없습니다. listener의 우선도를 변경하려면 , 최초로 removeListener() 를 호출할 필요가 있습니다. 그 후, 같은 listener를 새로운 우선도 레벨로 재차 등록할 수 있습니다.

listener가 등록된 후에,type 또는 useCapture 에 다른 값을 설정해 재차 addEventListener() 를 호출하면, 다른 listener 등록이 작성되는 것에 주의해 주세요. 예를 들어, 최초로 listener를 등록할 경우에 useCapture 를 true 로 설정하면, 그 listener는 capther 단계만으로 리스닝 합니다. useCapture 에 false 를 설정해, 같은 listener objects를 사용해 재차 addEventListener() 를 호출하면, 다른 2 살의 listener가 등록됩니다. 1 개은 capther 단계에서 리스닝 하는 listener로, 이제(벌써) 1 개은 타겟 단계와 바브 링 단계에서 리스닝 하는 listener입니다.

타겟 단계 또는 바브 링 단계만을 대상으로 하는 event listener를 등록할 수 없습니다. 등록시에 이러한 단계가 짜 합쳐지는 것은, 바브 링은 타겟 노드의 조상 밖에 적용되지 않기 때문입니다.

event listener가 불필요하게 되었을 경우는,EventDispatcher.removeEventListener() 를 호출해, event listener를 삭제합니다. 삭제하지 않는 경우, 메모리의 문제가 발생할 가능성이 있습니다. 가베지 컬렉터는 참조를 가지는 object를 삭제하지 않기 때문에, 등록되어 있는 event listener에 관계한 object는 메모리로부터 자동적으로 제거되지 않습니다.

EventDispatcher 인스턴스를 복사해도, 거기에 관련지을 수 있고 있는 event listener는 복사되지 않습니다. 새롭게 작성한 노드에 event listener가 필요한 경우는, 노드를 작성한 후에, listener를 관련지을 필요가 있습니다. 다만, EventDispatcher 인스턴스를 이동했을 경우는, 관련지을 수 있고 있는 event listener도 함께 이동됩니다.

이벤트가 노드로 처리될 때, event listener가 그 노드에 등록중이면, event listener는 현재의 단계에서는 방아쇠 되지 않습니다. 다만, 바브 링 단계 등, event 플로우(flow)의 뒤의 단계에서 방아쇠 할 수가 있습니다.

이벤트가 노드로 처리되고 있을 때 event listener가 노드로부터 삭제되었을 경우에서도, 이벤트는 현재의 액션에 의해 방아쇠 됩니다. 삭제된 후는, 그 후의 처리로 다시 등록되지 않는 이상 event listener는 두 번 다시 불려 가지 않습니다.

Parameters
type:String — 이벤트의 형태입니다.
 
listener:Function — 이벤트를 처리하는 listener 함수입니다. 이 함수는, 다음의 예의 같게, Event object를 유일한 Parameters로서 받아, 아무것도 돌려주지 않는 것으로 있을 필요가 있습니다.

function(evt:Event) :void

함수는 임의의 이름을 가질 수가 있습니다.
 
useCapture:Boolean (default = false) — listener가, capther 단계, 또는 타겟 및 바브 링 단계에서 동작할지 어떨지를 판단합니다. useCapture 를 true 로 설정하면, listener는 capther 단계만으로 이벤트를 처리해, 타겟 단계 또는 바브 링 단계에서는 처리하지 않습니다. useCapture 를 false 로 설정하면, listener는 타겟 단계 또는 바브 링 단계만으로 이벤트를 처리합니다. 3 개의 단계 모두로 이벤트를 받으려면 ,addEventListener() 를 2 회 호출합니다. useCapture 을 true 로 설정해 1 번 호출해,useCapture 를 false 로 설정해 한번 더 호출합니다.
 
priority:int (default = 0) — event listener의 우선도 레벨입니다. 우선도는, 32 비트 정수로 지정합니다. 수치가 커지는 만큼 우선도가 높아집니다. 우선도가 n 의 모든 listener는, 우선도가 n-1 의 listener보다 전에 처리됩니다. 복수의 listener에 대해서 같은 우선도가 설정되어 있는 경우, 그것들은 추가된 차례로 처리됩니다. 디폴트의 우선도는 0 입니다.
 
useWeakReference:Boolean (default = false) — listener에게로의 참조가 강참조와 약참조의 머지않아일까를 판단합니다. 디폴트인 강참조의 경우는, listener의 가베지 콜렉션이 회피됩니다. 약참조에서는 회피되지 않습니다.
addItem()Methods 
public function addItem(item:Object ):void

지정된 아이템을 리스트의 말미에 추가합니다. addItemAt(item, length) 와 같습니다.

Parameters
item:Object — 추가하는 아이템입니다.
addItemAt()Methods 
public function addItemAt(item:Object , index:int ):void

지정된 인덱스 위치에 아이템을 추가합니다. 이 인덱스의 뒤에 있는 아이템은, 1 개씩 밖에 이동됩니다. 리스트가 지정된 인덱스보다 짧은 경우는, 새로운 아이템이 들어가도록(듯이) 확대합니다.

Parameters
item:Object — 인덱스 위치에 배치하는 아이템입니다.
 
index:int — 아이템을 배치하는 인덱스 위치입니다.
contains()Methods 
public function contains(item:Object ):Boolean

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

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

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

See also

enableAutoUpdate()
mx.events.CollectionEvent
createCursor()Methods 
public function createCursor():IViewCursor

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

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

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

See also

mx.collections.ICollectionView.enableAutoUpdate()
mx.events.CollectionEvent
dispatchEvent()Methods 
public function dispatchEvent(event:Event ):Boolean

이벤트를 event 플로우(flow)에 dispatch합니다. event 타겟은 EventDispatcher object입니다. 이것에 대해서 dispatchEvent() 가 불려 갑니다.

Parameters
event:Event — event 플로우(flow)에 dispatch되는 event object입니다.

반환값
Boolean — 이벤트로 preventDefault() 이 불려 가지 않는 한 true 를 돌려줍니다. 불려 갔을 경우는 false 를 돌려줍니다.
enableAutoUpdate()Methods 
public function enableAutoUpdate():void

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

See also

mx.collections.ICollectionView.disableAutoUpdate()
getItemAt()Methods 
public function getItemAt(index:int , prefetch:int = 0):Object

지정된 인덱스 위치에 있는 아이템을 취득합니다.

Parameters
index:int — 아이템을 취득하는 리스트의 인덱스입니다.
 
prefetch:int (default = 0) — 아이템이 로컬이 아닌 경우에, 요구시에 취득하는 아이템의 방향과 양을 나타내는 int 값입니다.

반환값
Object — 그 인덱스 위치에 있는 아이템으로, 아이템이 없는 경우는 null 입니다.
getItemIndex()Methods 
public function getItemIndex(item:Object ):int

아이템이 리스트내에 있어, getItemAt(index) == 아이템이 되는 것 같은 경우는, 아이템의 인덱스를 돌려줍니다.

메모 : IViewCursor.findxxx() Methods의 경우와 달리,getItemIndex() Methods에는, 검색 대상의 아이템에 포함되어 있는 필드의 부분집합만을 Parameters로서 건네줄 수 없습니다. 이 Methods는, 항상 입력 Parameters에 완전하게 일치하는 아이템을 검색합니다.

Parameters
item:Object — 검색하는 아이템입니다.

반환값
int — 아이템의 인덱스로, 아이템이 리스트내에 없는 경우는 -1 입니다.
hasEventListener()Methods 
public function hasEventListener(type:String ):Boolean

EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다. 이것에 의해, EventDispatcher object가 event 타입의 처리를 event 플로우(flow) 계층의 어디서 변경했는지를 판단할 수 있습니다. 특정의 event 타입이 실제로 event listener를 방아쇠 할지 어떨지를 결정하려면 ,IEventDispatcher.willTrigger() 를 사용합니다.

hasEventListener() 와 willTrigger() 의 차이는,hasEventListener() 에서는 자신이 속하는 object만 검증되어willTrigger() 에서는 type Parameters로 지정된 이벤트의 event 플로우(flow) 전체가 검증되는 것입니다.

Parameters
type:String — 이벤트의 형태입니다.

반환값
Boolean — 지정한 타입의 listener가 등록되어 있는 경우는 true, 그 이외의 경우는 false 입니다.
initialized()Methods 
public function initialized(document:Object , id:String ):void

MXML 태그를 사용해 ListCollectionView 를 작성했을 때에, MXML 컴파일러에 의해 자동적으로 불려 갑니다. ActionScript 를 개입시켜 ListCollectionView 를 작성했을 경우, MXML 문서와 id 의 null 를 건네주어 이 Methods를 호출할 필요가 있습니다.

Parameters
document:Object — 이 ListCollectionView 를 포함한 MXML 문서입니다.
 
id:String — 무시됩니다.
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 입니다.
removeAll()Methods 
public function removeAll():void

리스트로부터 모든 아이템을 삭제합니다.

removeEventListener()Methods 
public function removeEventListener(type:String , listener:Function , useCapture:Boolean = false):void

EventDispatcher object로부터 listener를 삭제합니다. 대응하는 listener가 EventDispatcher object에 등록되지 않은 경우는, 이 Methods를 호출해도 효과는 없습니다.

Parameters
type:String — 이벤트의 형태입니다.
 
listener:Function — 삭제하는 listener objects입니다.
 
useCapture:Boolean (default = false) — listener가, capther 단계, 또는 타겟 및 바브 링 단계에 대해서 등록되었는지 어떠했는지를 나타냅니다. listener가 capther 단계 뿐만이 아니라 타겟 단계와 바브 링 단계에도 등록되어 있는 경우는,removeEventListener() 를 2 회 호출해 양쪽 모두의 listener를 삭제할 필요가 있습니다. 1 회는 useCapture 를 true 로 설정해, 이제(벌써) 1 회는 useCapture 를 false 로 설정할 필요가 있습니다.
removeItemAt()Methods 
public function removeItemAt(index:int ):Object

지정된 인덱스 위치에 있는 아이템을 삭제해, 돌려줍니다. 이 인덱스보다 후에 있던 아이템은, 인덱스가 1 개씩 전이 됩니다.

Parameters
index:int — 아이템이 삭제되는 인덱스입니다.

반환값
Object — 삭제된 아이템입니다.
setItemAt()Methods 
public function setItemAt(item:Object , index:int ):Object

지정된 인덱스 위치에 아이템을 배치합니다. 아이템이 이미 그 인덱스 위치에 있는 경우는, 새로운 아이템으로 옮겨져 인덱스 위치에 있던 아이템이 돌려주어집니다.

Parameters
item:Object — 지정된 인덱스 위치에 배치되는 새로운 아이템입니다.
 
index:int — index 아이템을 배치하는 인덱스 위치입니다.

반환값
Object — 옮겨놓을 수 있었던 아이템으로, 아이템이 없는 경우는 null 입니다.
toArray()Methods 
public function toArray():Array

IList Implements과 같은 순서로 지정된 배열을 돌려줍니다. 이 Methods에서는, ItemPendingError 가 슬로우 되는 일이 있습니다.

반환값
Array
toString()Methods 
public function toString():String

이 뷰의 내용을 string에 프리티프린트 해, 돌려줍니다.

반환값
String
willTrigger()Methods 
public function willTrigger(type:String ):Boolean

지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다. 지정된 타입의 이벤트가 이 EventDispatcher object 또는 그 자손에게 dispatch되었을 때에, event listener가 event 플로우(flow)의 임의의 단계에서 방아쇠 되는 경우, 이 Methods는 true 를 돌려줍니다.

hasEventListener() 와 willTrigger() 의 차이는,hasEventListener() 에서는 자신이 속하는 object만 검증되어willTrigger() 에서는 type Parameters로 지정된 이벤트의 event 플로우(flow) 전체가 검증되는 것입니다.

Parameters
type:String — 이벤트의 형태입니다.

반환값
Boolean — 지정한 타입의 listener가 방아쇠 되었을 경우는 true, 그 이외의 경우는 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/ListCollectionView.html