This page was saved using jaction on 2006-09-04 8:33:45.
Address: http://flexdocs.kr/docs/flex2/langref/mx/core/IChildList.html
Title: mx.core.IChildList (Flex™ 2 레퍼런스 가이드)  •  Size: 34173
Packagemx.core
인터페이스public interface IChildList
SubinterfacesISystemManager
인프리멘타SystemManager , UIComponent

IChildList 인터페이스는, DisplayObjectContainer 의 아이의 부분집합인 child 리스트에 액세스 해, 조작하기 위한 property와 Methods를 정의합니다.

예로서 Container 클래스에 도착해 검토합니다. 이것은,numChildren Methods나 getChildAt() Methods등의 DisplayObjectContainer API 를 재정의(override) 해, 안에 놓여진 컨트롤이나 그 외의 컨테이너인 「컨텐츠」의 아이에만 액세스 합니다. 다만, Container 는, 배경 또는 경계의 스킨이나 스크롤 바 등, 체제에 의해 자동적으로 작성되는 다른 아이를 가지는 일이 있습니다. 그 때문에, Container 는 IChildList 형의 rawChildren 로 불리는 property를 공개해, 컨텐츠의 child 뿐만이 아니라 모든 아이에게 액세스 할 수 있도록(듯이) 합니다.

이제(벌써) 1 개의 예로서 드는 SystemManager 클래스는, 아이가 다양한 layer에 분할되고 있는 DisplayObjectContainer 입니다. 최하층은 어플리케이션과 같은 통상의 아이, 게다가가 pop-up, 한층 더 게다가가 툴 힌트, 최상층이 커서가 됩니다. SystemManager 클래스에는,popUpChildren,toolTipChildren,cursorChildren 라는 이름의 property가 있어, 그것들을 사용해 각 layer에 액세스 할 수 있습니다. 각각의 property의 형태는 IChildList 입니다. 따라서,systemManager.popUpChildren.numChildren property를 사용해 pop-up의 수를 카운트 해,systemManager.toolTipChildren.addChild() Methods를 사용해 다른 DisplayObject 를 툴 힌트 layer에 삽입할 수가 있습니다.

See also

mx.core.Container.rawChildren
mx.managers.SystemManager.rawChildren
mx.managers.SystemManager.popUpChildren
mx.managers.SystemManager.toolTipChildren
mx.managers.SystemManager.cursorChildren


Public property
 property정의
  numChildren : int
[read-only] 이 child 리스트에 포함되는 아이의 수입니다.
IChildList
Public Methods
 Methods정의
  addChild (child:DisplayObject ):DisplayObject
이 child 리스트의 말미에 child DisplayObject 를 추가합니다.
IChildList
  addChildAt (child:DisplayObject , index:int ):DisplayObject
이 child 리스트의 지정된 인덱스에 child DisplayObject 를 추가합니다.
IChildList
  contains (child:DisplayObject ):Boolean
DisplayObject 가 이 child 리스트내에 있는지, 또는 이 child 리스트에 포함되는 아이의 자손인지를 지정합니다.
IChildList
  getChildAt (index:int ):DisplayObject
이 child 리스트내의 지정된 인덱스에 있는 child DisplayObject 를 취득합니다.
IChildList
  getChildByName (name:String ):DisplayObject
이 child 리스트내의 지정된 이름인 child DisplayObject 를 취득합니다.
IChildList
  getChildIndex (child:DisplayObject ):int
이 child 리스트내의 특정의 아이의 인덱스를 취득합니다.
IChildList
  getObjectsUnderPoint (point:Point ):Array
지정된 포인트아래에 있어, 이 child 리스트내에 있는 DisplayObject 의 배열을 돌려줍니다.
IChildList
  removeChild (child:DisplayObject ):DisplayObject
이 child 리스트로부터 지정된 child DisplayObject 를 삭제합니다.
IChildList
  removeChildAt (index:int ):DisplayObject
이 child 리스트내의 지정된 인덱스에 있는 child DisplayObject 를 삭제합니다.
IChildList
  setChildIndex (child:DisplayObject , newIndex:int ):void
이 child 리스트내의 특정의 아이의 인덱스를 변경합니다.
IChildList
property의 상세
numChildrenproperty
numChildren:int   [read-only]

이 child 리스트에 포함되는 아이의 수입니다.

Implements
    public function get numChildren():int
Methods의 상세
addChild()Methods
public function addChild(child:DisplayObject ):DisplayObject

이 child 리스트의 말미에 child DisplayObject 를 추가합니다.

childList.addChild(child) 의 호출은,childList.addChild(child, childList.numChildren) 의 호출과 같습니다. 추가한 후의 새로운 아이의 인덱스는,(child.numChildren - 1) 가 됩니다.

Parameters
child:DisplayObject — 자로서 추가하는 DisplayObject 입니다.

반환값
DisplayObject — 추가된 아이입니다. 이것은, 건네받은 인수와 같습니다.
addChildAt()Methods 
public function addChildAt(child:DisplayObject , index:int ):DisplayObject

이 child 리스트의 지정된 인덱스에 child DisplayObject 를 추가합니다. 인덱스 0 은 DisplayList 의 선두를, 인덱스 numChildren 는 최후를 나타냅니다.

아이 리스트의 최후 이외의 장소에 아이를 추가하면, 그것까지 그 인덱스 이상의 위치에 있던 아이의 인덱스는 1 개씩 늘려집니다.

Parameters
child:DisplayObject — 자로서 추가하는 DisplayObject 입니다.
 
index:int — 자를 추가하는 인덱스입니다.

반환값
DisplayObject — 추가된 아이입니다. 이것은, 건네받은 child 인수와 같습니다.
contains()Methods 
public function contains(child:DisplayObject ):Boolean

DisplayObject 가 이 child 리스트내에 있는지, 또는 이 child 리스트에 포함되는 아이의 자손인지를 지정합니다.

Parameters
child:DisplayObject — 테스트하는 DisplayObject 입니다.

반환값
Boolean — DisplayObject 가 이 child 리스트에 있는지, 또는 이 child 리스트내의 아이의 자손인 경우는 true, 그 이외의 경우는 false 가 됩니다.
getChildAt()Methods 
public function getChildAt(index:int ):DisplayObject

이 child 리스트내의 지정된 인덱스에 있는 child DisplayObject 를 취득합니다.

Parameters
index:int — 이 child 리스트내의 아이의 인덱스를 지정하는 0 ~ (numChildren - 1) 의 정수입니다.

반환값
DisplayObject — 지정된 인덱스 위치에 있는 아이입니다.
getChildByName()Methods 
public function getChildByName(name:String ):DisplayObject

이 child 리스트내의 지정된 이름인 child DisplayObject 를 취득합니다.

Parameters
name:String — 돌려주어지는 아이의 이름.

반환값
DisplayObject — 지정된 이름을 가지는 아이.
getChildIndex()Methods 
public function getChildIndex(child:DisplayObject ):int

이 child 리스트내의 특정의 아이의 인덱스를 취득합니다.

아이 리스트의 최초의 아이는 인덱스 0, 2 번째의 아이는 인덱스 1, 마지막 아이는 인덱스 (numChildren - 1) 가 됩니다.

getChildIndex(myChild) 가 5 를 돌려주었을 경우,myView.getChildAt(5)myChild 를 돌려줍니다.

addChild() Methods를 호출하는 것에 의해 아이를 추가하면, 새로운 아이의 인덱스는, 기존의 아이중에서 최대의 인덱스에 1 을 더한 값에 동일해집니다.

addChildAt() Methods를 사용해, 지정한 인덱스 위치에 아이를 삽입할 수 있습니다. 그 경우, 그 인덱스 이상의 위치에 있던 아이는 인덱스가 1 두개 늘려져 모든 아이가 0 ~ (numChildren - 1) 의 값으로 인덱스 붙이고 됩니다.

removeChild() 또는 removeChildAt() Methods를 호출해 아이를 삭제하면, 그것보다 큰 인덱스를 가지는 아이는 인덱스가 1 두개 줄여져 모든 아이가 0 ~ (numChildren - 1) 의 값으로 인덱스 붙이고 됩니다.

setChildIndex() Methods를 호출해 아이의 인덱스를 변경하면, 모든 아이가 0 ~ (numChildren - 1) 의 값으로 인덱스 붙이고 되도록(듯이), 낡은 인덱스와 새로운 인덱스의 사이에 있는 아이의 인덱스가 조정됩니다.

Parameters
child:DisplayObject — 인덱스를 취득하는 아이입니다.

반환값
int — 아이의 인덱스. 0 ~ (numChildren - 1) 의 정수입니다.
getObjectsUnderPoint()Methods 
public function getObjectsUnderPoint(point:Point ):Array

지정된 포인트아래에 있어, 이 child 리스트내에 있는 DisplayObject 의 배열을 돌려줍니다.

Parameters
point:Point — 주목하는 포인트입니다.

반환값
Array — 지정된 포인트아래에 있어, 이 컨테이너의 아이인 object의 배열입니다.
removeChild()Methods 
public function removeChild(child:DisplayObject ):DisplayObject

이 child 리스트로부터 지정된 child DisplayObject 를 삭제합니다.

아이 리스트의 최후 이외의 장소로부터 아이를 삭제하면, 그것까지 그 인덱스를 넘는 위치에 있던 아이의 인덱스는 1 개씩 줄여집니다.

삭제된 아이는, 부모가 null 로 설정되어 그 밖에 참조가 없는 경우는 가베지 콜렉션의 대상이 됩니다.

Parameters
child:DisplayObject — 삭제하는 DisplayObject 입니다.

반환값
DisplayObject — 삭제된 아이입니다. 이것은, 건네받은 인수와 같습니다.
removeChildAt()Methods 
public function removeChildAt(index:int ):DisplayObject

이 child 리스트내의 지정된 인덱스에 있는 child DisplayObject 를 삭제합니다.

아이 리스트의 최후 이외의 장소로부터 아이를 삭제하면, 그것까지 그 인덱스를 넘는 위치에 있던 아이의 인덱스는 1 개씩 줄여집니다.

삭제된 아이는, 부모가 null 로 설정되어 그 밖에 참조가 없는 경우는 가베지 콜렉션의 대상이 됩니다.

Parameters
index:int — 삭제하는 DisplayObject 의 child 인덱스입니다.

반환값
DisplayObject — 삭제된 아이입니다.
setChildIndex()Methods 
public function setChildIndex(child:DisplayObject , newIndex:int ):void

이 child 리스트내의 특정의 아이의 인덱스를 변경합니다. 아이의 인덱스의 상세한 것에 대하여는,getChildIndex() Methods를 참조해 주세요.

Parameters
child:DisplayObject — 인덱스를 설정하는 아이입니다.
 
newIndex:int — 지정된 아이의 새로운 인덱스입니다. 0 ~ (numChildren - 1) 의 정수인 것이 필요합니다.






 

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

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