| Package | mx.collections |
| 인터페이스 | public interface IList extends IEventDispatcher |
| 인프리멘타 | ListCollectionView |
IList 는, 리모트로부터 취득한 데이터에 대한 뷰입니다. 리모트의 가능성이 있는 콜렉션을 기술하는 경우는, 데이터가 그 시점에서 아직 취득할 수 없는 경우를 상정해 처리하는 것이 중요합니다. 이것에는,ItemPendingError 를 사용합니다.
ICollectionView 는 IList 대신에 됩니다.
See also
| Methods | 정의 | ||
|---|---|---|---|
 | addEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
| IEventDispatcher | |
| addItem (item:Object ):void
지정된 아이템을 리스트의 말미에 추가합니다.
| IList | ||
| addItemAt (item:Object , index:int ):void
지정된 인덱스 위치에 아이템을 추가합니다.
| IList | ||
| dispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
| IEventDispatcher | |
| getItemAt (index:int , prefetch:int = 0):Object
지정된 인덱스 위치에 있는 아이템을 취득합니다.
| IList | ||
| getItemIndex (item:Object ):int
아이템이 리스트내에 있어, getItemAt(index) == 아이템이 되는 것 같은 경우는, 아이템의 인덱스를 돌려줍니다.
| IList | ||
| hasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
| IEventDispatcher | |
| itemUpdated (item:Object , property:Object = null, oldValue:Object = null, newValue:Object = null):void
아이템이 갱신된 뷰를 통지합니다.
| IList | ||
| removeAll ():void
리스트로부터 모든 아이템을 삭제합니다.
| IList | ||
| removeEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
| IEventDispatcher | |
| removeItemAt (index:int ):Object
지정된 인덱스 위치에 있는 아이템을 삭제해, 돌려줍니다.
| IList | ||
| setItemAt (item:Object , index:int ):Object
지정된 인덱스 위치에 아이템을 배치합니다.
| IList | ||
| toArray ():Array
IList Implements과 같은 순서로 지정된 배열을 돌려줍니다.
| IList | ||
| willTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
| IEventDispatcher | |
| 이벤트 | 일람 | 정의 | ||
|---|---|---|---|---|
| collectionChange | IList 가 어떠한 방법으로 갱신되면 dispatch됩니다. | IList | ||
| length | property |
상속된 Public Methods의 비표시
상속된 Public Methods 보기 length:int [read-only]콜렉션내의 아이템의 수입니다. 0 은 아이템이 없는 것을 의미해,-1 는 길이가 불명한 것을 의미합니다.
Implements public function get length():int
| addItem | () | Methods |
public function addItem(item:Object ):void
지정된 아이템을 리스트의 말미에 추가합니다. addItemAt(item, length) 와 같습니다.
item:Object — 추가하는 아이템입니다.
|
| addItemAt | () | Methods |
public function addItemAt(item:Object , index:int ):void 지정된 인덱스 위치에 아이템을 추가합니다. 이 인덱스의 뒤에 있는 아이템은, 1 개씩 밖에 이동됩니다. 리스트가 지정된 인덱스보다 짧은 경우는, 새로운 아이템이 들어가도록(듯이) 확대합니다.
Parametersitem:Object — 인덱스 위치에 배치하는 아이템입니다.
|
|
index:int — 아이템을 배치하는 인덱스 위치입니다.
|
RangeError — 인덱스가 0 미만의 경우.
|
| getItemAt | () | Methods |
public function getItemAt(index:int , prefetch:int = 0):Object 지정된 인덱스 위치에 있는 아이템을 취득합니다.
Parametersindex:int — 아이템을 취득하는 리스트의 인덱스입니다.
|
|
prefetch:int (default = 0)int 값입니다.
|
Object —
그 인덱스 위치에 있는 아이템으로, 아이템이 없는 경우는 null 입니다.
|
ItemPendingError — 리모트로부터 인덱스의 데이터를 로드할 필요가 있는 경우.
|
|
RangeError — index < 0 또는 index >= length 의 경우.
|
| getItemIndex | () | Methods |
public function getItemIndex(item:Object ):int 아이템이 리스트내에 있어, getItemAt(index) == 아이템이 되는 것 같은 경우는, 아이템의 인덱스를 돌려줍니다.
메모 : IViewCursor.findxxx() Methods의 경우와 달리,getItemIndex() Methods에는, 검색 대상의 아이템에 포함되어 있는 필드의 부분집합만을 Parameters로서 건네줄 수 없습니다. 이 Methods는, 항상 입력 Parameters에 완전하게 일치하는 아이템을 검색합니다.
item:Object — 검색하는 아이템입니다.
|
int —
아이템의 인덱스로, 아이템이 리스트내에 없는 경우는 -1 입니다.
|
| itemUpdated | () | Methods |
public function itemUpdated(item:Object , property:Object = null, oldValue:Object = null, newValue:Object = null):void
아이템이 갱신된 뷰를 통지합니다. 이것은, 뷰의 내용이 IEventDispatcher 를 Implements하지 않고,PropertyChangeEvent 를 dispatch하는 경우에 편리합니다. property를 지정하면, 뷰는 통지 메카니즘을 최적화할 수 있습니다. property를 지정하지 않으면 뷰 전체의 단순한 갱신이 선택됩니다.
item:Object — 갱신된 뷰내의 아이템입니다.
|
|
property:Object (default = null) |
|
oldValue:Object (default = null) |
|
newValue:Object (default = null) |
See also
| removeAll | () | Methods |
public function removeAll():void 리스트로부터 모든 아이템을 삭제합니다.
아이템이 로컬은 아니고, 비동기 처리를 실행할 필요가 있는 경우는,ItemPendingError 가 슬로우 됩니다.
ItemPendingError 의 사용의 상세한 것에 대하여는, ItemPendingError 및 콜렉션의 설명을 참조해 주세요.
| removeItemAt | () | Methods |
public function removeItemAt(index:int ):Object 지정된 인덱스 위치에 있는 아이템을 삭제해, 돌려줍니다. 이 인덱스보다 후에 있던 아이템은, 인덱스가 1 개씩 전이 됩니다.
Parametersindex:int — 아이템이 삭제되는 인덱스입니다.
|
Object —
삭제된 아이템입니다.
|
RangeError — 0 미만 또는 길이보다 큰 인덱스입니다.
|
| setItemAt | () | Methods |
public function setItemAt(item:Object , index:int ):Object 지정된 인덱스 위치에 아이템을 배치합니다. 아이템이 이미 그 인덱스 위치에 있는 경우는, 새로운 아이템으로 옮겨져 인덱스 위치에 있던 아이템이 돌려주어집니다.
Parametersitem:Object — 지정된 인덱스 위치에 배치되는 새로운 아이템입니다.
|
|
index:int — index 아이템을 배치하는 인덱스 위치입니다.
|
Object —
옮겨놓을 수 있었던 아이템으로, 아이템이 없는 경우는 null 입니다.
|
RangeError — 인덱스가 0 미만 또는 길이보다 큰 경우.
|
| toArray | () | Methods |
public function toArray():Array IList Implements과 같은 순서로 지정된 배열을 돌려줍니다. 이 Methods에서는, ItemPendingError 가 슬로우 되는 일이 있습니다.
반환값Array |
ItemPendingError — 리모트로부터의 데이터의 로드가 아직 완료하고 있지 않는 경우.
|
| collectionChange | event |
mx.events.CollectionEvent
mx.events.CollectionEvent.COLLECTION_CHANGE
IList 가 어떠한 방법으로 갱신되면 dispatch됩니다.
CollectionEvent.COLLECTION_CHANGE 정수는, 콜렉션이 변경될 때 dispatch되는 이벤트의 event object의 type property치를 정의합니다.
event object의 각 property에는 다음의 값이 설정되어 있습니다. 이벤트의 종류에 따라서는 무효인 property도 있습니다. 상세한 것에 대하여는, 각 property의 설명을 참조해 주세요.
| Property | Value |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 myButton.addEventListener() 를 사용하면,currentTarget 의 값은 "myButton" 가 됩니다. |
items | 이벤트의 영향을 받는 아이템의 정보를 가지는 object의 배열입니다. 이 필드의 내용은 이벤트의 종류에 응해 다릅니다. 상세한 것에 대하여는,items property를 참조해 주세요. |
kind | 이벤트의 종류입니다. 유효한 값이 정수로서 CollectionEventKind 클래스에 정의됩니다. |
location | items property로 지정된 아이템의 타겟 콜렉션내에 있어서의 위치입니다. |
oldLocation | items property로 지정된 아이템의 콜렉션내에 있어서의 이전의 위치입니다. |
target | 이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,currentTarget property를 사용해 주세요. |
type | CollectionEvent.COLLECTION_CHANGE |
코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트
현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/collections/IList.html