패키지 | fl.controls |
클래스 | public class List |
상속 | List SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
구현 | IFocusManagerComponent |
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
List 구성 요소는 항목, 행 및 데이터 공급자로 구성되며, 각 요소에 대한 설명은 다음과 같습니다.
- 항목: 일반적으로 설명이 포함된
label
속성 및 해당 항목과 연결된 데이터가 저장된data
속성이 들어 있는 ActionScript 객체 - 행: 항목을 표시하는 데 사용되는 구성 요소
- 데이터 공급자: List 구성 요소가 표시하는 항목을 모델링하는 구성 요소
기본적으로 List 구성 요소는 CellRenderer 클래스를 사용하여 목록 항목이 표시되는 행을 제공합니다. 이러한 행은 프로그래밍 방식으로 만들 수 있습니다. 이 작업은 보통 CellRenderer 클래스를 하위 클래스로 분류하여 수행합니다. CellRenderer 클래스는 ICellRenderer 인터페이스를 구현하며, 이 인터페이스에서는 List 구성 요소가 해당 행을 조작하고 표시할 데이터 및 상태 정보를 각 행에 보내는 데 사용하는 속성 및 메서드 세트를 제공합니다. 여기에는 데이터 크기 조절 및 선택 관련 정보가 포함됩니다.
List 구성 요소에서는 해당 데이터 공급자에 대해 실행되는 메서드(예: addItem()
및 removeItem()
메서드)를 제공합니다. 이러한 메서드와 다른 메서드를 사용하여 List 구성 요소와 같은 프레임에 있는 모든 배열의 데이터를 조작한 다음 변경 내용을 여러 보기로 브로드캐스트할 수 있습니다. 외부 데이터 공급자에서 List 구성 요소가 제공되지 않는 경우 이러한 메서드는 자동으로 데이터 공급자 인스턴스를 만들어 List.dataProvider
속성을 통해 표시합니다. List 구성 요소는 ICellRenderer 인터페이스를 구현하는 Sprite를 사용하여 각 행을 렌더링합니다. 이 렌더러를 지정하려면 List.cellRenderer
속성을 사용합니다. Array 인스턴스를 만들거나 서버에서 가져와 여러 목록, 콤보 상자, 데이터 격자 등에 대한 데이터 모델로 사용할 수도 있습니다.
속성 | 정의 주체 | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
이 InteractiveObject 인스턴스에 대한 현재 액세스 가능성 구현(AccessibilityImplementation)입니다. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
이 표시 객체의 현재 액세스 가능성 옵션입니다. | DisplayObject | ||
allowMultipleSelection : Boolean
여러 목록 항목을 한 번에 선택할 수 있는지 여부를 나타내는 부울 값을 가져옵니다. | SelectableList | ||
alpha : Number
지정된 객체의 알파 투명도 값을 나타냅니다. | DisplayObject | ||
blendMode : String
사용할 블렌드 모드를 지정하는 BlendMode 클래스 값입니다. | DisplayObject | ||
blendShader : Shader [쓰기 전용]
전경 및 배경을 블렌딩하는 데 사용되는 셰이더를 설정합니다. | DisplayObject | ||
buttonMode : Boolean
이 Sprite의 버튼 모드를 지정합니다. | Sprite | ||
cacheAsBitmap : Boolean
true로 설정된 경우 Flash 런타임은 표시 객체의 내부 비트맵 표현을 캐시합니다. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
null이 아닌 경우 이 Matrix 객체는 cacheAsBitmap이 true로 설정될 때 표시 객체가 렌더링되는 방법을 정의합니다. | DisplayObject | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
contextMenu : NativeMenu
이 객체에 연결된 컨텍스트 메뉴를 지정합니다. | InteractiveObject | ||
dataProvider : DataProvider
보려는 항목 목록의 데이터 모델을 가져오거나 설정합니다. | SelectableList | ||
doubleClickEnabled : Boolean
이 객체에서 doubleClick 이벤트를 받을지 여부를 지정합니다. | InteractiveObject | ||
dropTarget : DisplayObject [읽기 전용]
드래그하는 Sprite 아래의 표시 객체 또는 Sprite를 드래그해 놓은 표시 객체를 지정합니다. | Sprite | ||
enabled : Boolean
구성 요소가 사용자 상호 작용을 인식할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. | UIComponent | ||
filters : Array
현재 표시 객체와 연관된 각 필터 객체가 들어 있는 인덱싱된 배열입니다. | DisplayObject | ||
focusEnabled : Boolean
사용자가 클릭한 후 구성 요소에서 포커스를 받을 수 있는지 여부를 나타내는 부울 값을 가져오거나 설정합니다. | UIComponent | ||
focusManager : IFocusManager
이 구성 요소와 해당 피어에 대한 포커스를 제어하는 FocusManager를 가져오거나 설정합니다. | UIComponent | ||
focusRect : Object
이 객체에서 포커스 사각형을 표시할지 여부를 지정합니다. | InteractiveObject | ||
graphics : Graphics [읽기 전용]
벡터 드로잉 명령을 내릴 수 있는 이 Sprite에 속한 Graphics 객체를 지정합니다. | Sprite | ||
height : Number [재정의]
구성 요소의 높이(픽셀 단위)를 가져오거나 설정합니다. | UIComponent | ||
hitArea : Sprite
Sprite의 히트 영역으로 사용할 다른 Sprite를 지정합니다. | Sprite | ||
horizontalLineScrollSize : Number
스크롤 화살표를 클릭했을 때 가로로 스크롤할 내용의 양을 나타내는 값을 가져오거나 설정합니다. | BaseScrollPane | ||
horizontalPageScrollSize : Number
스크롤 막대 트랙을 누를 때 가로 스크롤 막대의 스크롤 썸 이동 거리를 픽셀 수로 가져오거나 설정합니다. | BaseScrollPane | ||
horizontalScrollBar : ScrollBar [읽기 전용]
가로 스크롤 막대에 대한 참조를 가져옵니다. | BaseScrollPane | ||
horizontalScrollPolicy : String
가로 스크롤 막대의 상태를 나타내는 값을 가져오거나 설정합니다. | BaseScrollPane | ||
horizontalScrollPosition : Number
스크롤 창에서 가로 스크롤 막대의 가로 위치를 나타내는 값(픽셀 단위)을 가져오거나 설정합니다. | BaseScrollPane | ||
iconField : String
항목의 아이콘을 제공하는 항목 필드를 가져오거나 설정합니다. | List | ||
iconFunction : Function
항목의 아이콘을 가져오는 데 사용할 함수를 가져오거나 설정합니다. | List | ||
labelField : String
TextInput 필드와 드롭다운 목록의 레이블로 표시할 dataProvider 객체의 필드 이름을 가져오거나 설정합니다. | List | ||
labelFunction : Function
항목의 레이블을 가져오는 데 사용할 함수를 가져오거나 설정합니다. | List | ||
length : uint [읽기 전용]
데이터 공급자의 항목 수를 가져옵니다. | SelectableList | ||
loaderInfo : LoaderInfo [읽기 전용]
이 표시 객체가 속한 파일의 로딩 정보가 포함된 LoaderInfo 객체를 반환합니다. | DisplayObject | ||
mask : DisplayObject
호출하는 표시 객체는 지정된 mask 객체에 의해 마스크 처리됩니다. | DisplayObject | ||
maxHorizontalScrollPosition : Number [재정의]
horizontalScrollPolicy 속성이 ScrollPolicy.ON으로 설정되어 있는 경우 목록에서 오른쪽으로 스크롤할 수 있는 픽셀 수를 가져오거나 설정합니다. | SelectableList | ||
maxVerticalScrollPosition : Number [읽기 전용]
현재 내용의 최대 세로 스크롤 위치를 픽셀 단위로 가져옵니다. | BaseScrollPane | ||
metaData : Object
PlaceObject4 태그를 통해 SWF 파일에 해당 DisplayObject의 인스턴스와 함께 메타데이터가 저장된 경우 DisplayObject 인스턴스의 메타데이터 객체를 가져옵니다. | DisplayObject | ||
mouseChildren : Boolean
해당 객체의 자식에서 마우스 또는 사용자 입력 장치가 사용하도록 설정되어 있는지 여부를 결정합니다. | DisplayObjectContainer | ||
mouseEnabled : Boolean
이 객체가 마우스 또는 기타 사용자 입력, 메시지를 수신할지 여부를 지정합니다. | InteractiveObject | ||
mouseFocusEnabled : Boolean
사용자가 클릭한 후 구성 요소에서 포커스를 받을 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. | UIComponent | ||
mouseX : Number [읽기 전용]
마우스 또는 사용자 입력 장치 위치의 x 좌표를 픽셀로 나타냅니다. | DisplayObject | ||
mouseY : Number [읽기 전용]
마우스 또는 사용자 입력 장치 위치의 y 좌표를 픽셀로 나타냅니다. | DisplayObject | ||
name : String
DisplayObject의 인스턴스 이름을 나타냅니다. | DisplayObject | ||
needsSoftKeyboard : Boolean
이 InteractiveObject 인스턴스가 포커스를 받을 때 가상 키보드(화면의 소프트웨어 키보드)를 표시할지 여부를 지정합니다. | InteractiveObject | ||
numChildren : int [읽기 전용]
이 객체의 자식 수를 반환합니다. | DisplayObjectContainer | ||
opaqueBackground : Object
표시 객체를 특정 배경색으로 불투명하게 처리할지 여부를 지정합니다. | DisplayObject | ||
parent : DisplayObjectContainer [읽기 전용]
이 표시 객체가 포함된 DisplayObjectContainer 객체를 나타냅니다. | DisplayObject | ||
root : DisplayObject [읽기 전용]
로드된 SWF 파일에 있는 표시 객체의 경우, 해당 SWF 파일이 나타내는 표시 목록의 트리 구조 부분에서 맨 위에 위치하는 표시 객체가 루트 속성이 됩니다. | DisplayObject | ||
rotation : Number
DisplayObject 인스턴스가 원점으로부터 회전한 각도입니다. | DisplayObject | ||
rotationX : Number
DisplayObject 인스턴스가 3D parent 컨테이너를 기준으로 원점으로부터 x축 회전한 각도를 나타냅니다. | DisplayObject | ||
rotationY : Number
DisplayObject 인스턴스가 3D parent 컨테이너를 기준으로 원점으로부터 y축 회전한 각도를 나타냅니다. | DisplayObject | ||
rotationZ : Number
DisplayObject 인스턴스가 3D parent 컨테이너를 기준으로 원점으로부터 z축 회전한 각도를 나타냅니다. | DisplayObject | ||
rowCount : uint [재정의]
목록에 일부라도 표시되는 행 수를 가져오거나 설정합니다. | List | ||
rowHeight : Number
목록에 있는 각 행의 높이(픽셀 단위)를 가져오거나 설정합니다. | List | ||
scale9Grid : Rectangle
현재 적용 중인 크기 조절 격자입니다. | DisplayObject | ||
scaleX : Number [재정의]
구성 요소의 현재 폭에 배율 인수를 곱합니다. | UIComponent | ||
scaleY : Number [재정의]
구성 요소의 현재 높이에 배율 인수를 곱합니다. | UIComponent | ||
scaleZ : Number
객체의 등록 포인트에서 적용된 객체의 깊이 크기(백분율)를 나타냅니다. | DisplayObject | ||
scrollRect : Rectangle
표시 객체의 스크롤 사각형 경계입니다. | DisplayObject | ||
selectable : Boolean
목록의 항목을 선택할 수 있는지 여부를 나타내는 부울 값을 가져오거나 설정합니다. | SelectableList | ||
selectedIndex : int
한 항목만 선택할 수 있는 목록에서 선택된 항목의 인덱스를 가져오거나 설정합니다. | SelectableList | ||
selectedIndices : Array
여러 항목을 선택할 수 있는 목록에서 선택된 항목을 포함하는 배열을 가져오거나 설정합니다. | SelectableList | ||
selectedItem : Object
한 항목만 선택할 수 있는 목록에서 선택된 항목을 가져오거나 설정합니다. | SelectableList | ||
selectedItems : Array
여러 항목을 선택할 수 있는 목록에서 선택된 항목에 대한 객체를 포함하는 배열을 가져오거나 설정합니다. | SelectableList | ||
softKeyboard : String
소프트 키보드의 모양을 제어합니다. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
소프트 키보드가 표시될 때 화면에서 그대로 유지되는 영역을 정의합니다(iOS에서는 사용할 수 없음). | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
이 Sprite 내에서 사운드를 제어합니다. | Sprite | ||
stage : Stage [읽기 전용]
표시 객체의 Stage입니다. | DisplayObject | ||
tabChildren : Boolean
객체의 자식에서 탭 기능을 사용할 수 있는지 여부를 결정합니다. | DisplayObjectContainer | ||
tabEnabled : Boolean
이 객체가 탭 순서에 있는지 여부를 지정합니다. | InteractiveObject | ||
tabIndex : int
SWF 파일에서 객체의 탭 순서를 지정합니다. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [읽기 전용]
이 DisplayObjectContainer 인스턴스에 대한 TextSnapshot 객체를 반환합니다. | DisplayObjectContainer | ||
transform : flash.geom:Transform
표시 객체의 행렬, 색상 변환 및 픽셀 경계와 관련된 속성을 가진 객체입니다. | DisplayObject | ||
useBitmapScrolling : Boolean
true로 설정하면 스크롤하는 내용의 cacheAsBitmap 속성이 true로 설정되고, false로 설정하면 이 값이 해제됩니다. | BaseScrollPane | ||
useHandCursor : Boolean
buttonMode 속성이 true로 설정된 스프라이트 위로 포인터를 움직일 때 손 모양(손 모양 커서)을 표시할지 여부를 나타내는 부울 값입니다. | Sprite | ||
verticalLineScrollSize : Number
스크롤 화살표를 클릭했을 때 세로로 스크롤할 픽셀 수를 나타내는 값을 가져오거나 설정합니다. | BaseScrollPane | ||
verticalPageScrollSize : Number
스크롤 막대 트랙을 누를 때 세로 스크롤 막대의 스크롤 썸 이동 거리를 픽셀 수로 가져오거나 설정합니다. | BaseScrollPane | ||
verticalScrollBar : ScrollBar [읽기 전용]
세로 스크롤 막대에 대한 참조를 가져옵니다. | BaseScrollPane | ||
verticalScrollPolicy : String
세로 스크롤 막대의 상태를 나타내는 값을 가져오거나 설정합니다. | BaseScrollPane | ||
verticalScrollPosition : Number
스크롤 창에서 세로 스크롤 막대의 세로 위치를 나타내는 값을 픽셀 단위로 가져오거나 설정합니다. | BaseScrollPane | ||
visible : Boolean [재정의]
현재 구성 요소 인스턴스의 표시 여부를 나타내는 값을 가져오거나 설정합니다. | UIComponent | ||
width : Number [재정의]
구성 요소의 폭(픽셀 단위)을 가져오거나 설정합니다. | UIComponent | ||
x : Number [재정의]
부모 컨테이너 내의 X축을 따라 구성 요소의 위치를 나타내는 X 좌표를 가져오거나 설정합니다. | UIComponent | ||
y : Number [재정의]
부모 컨테이너 내의 Y축을 따라 구성 요소의 위치를 나타내는 Y 좌표를 가져오거나 설정합니다. | UIComponent | ||
z : Number
3D parent 컨테이너를 기준으로 DisplayObject 인스턴스의 z축에 있는 z 좌표 위치를 나타냅니다. | DisplayObject |
메서드 | 정의 주체 | ||
---|---|---|---|
List()
새 List 구성 요소 인스턴스를 만듭니다. | List | ||
이 DisplayObjectContainer 인스턴스에 자식 DisplayObject 인스턴스를 추가합니다. | DisplayObjectContainer | ||
이 DisplayObjectContainer 인스턴스에 자식 DisplayObject 인스턴스를 추가합니다. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | ||
항목 목록의 끝에 항목을 하나 추가합니다. | SelectableList | ||
지정된 인덱스 위치에 있는 항목을 목록에 삽입합니다. | SelectableList | ||
지정된 point 점으로 DisplayObjectContainer.getObjectsUnderPoint() 메서드를 호출하여 반환된 목록에서 임의의 표시 객체가 보안 제한 사항으로 인해 생략되는지 여부를 나타냅니다. | DisplayObjectContainer | ||
목록의 렌더러에 대해 설정되는 스타일을 지웁니다. | SelectableList | ||
목록에서 현재 선택된 항목의 선택을 취소하고 selectedIndex 속성을 -1로 설정합니다. | SelectableList | ||
이 구성 요소 인스턴스에서 스타일 속성을 삭제합니다. | UIComponent | ||
지정된 표시 객체가 DisplayObjectContainer 인스턴스의 자식인지 아니면 인스턴스 자체인지를 확인합니다. | DisplayObjectContainer | ||
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | ||
이 구성 요소에 포커스 표시기를 표시하거나 숨깁니다. | UIComponent | ||
모든 항목을 무효화하는 invalidateNow와 달리 즉시 그리기 작업을 초기화합니다. | UIComponent | ||
targetCoordinateSpace 객체의 좌표계를 기준으로 표시 객체의 영역을 정의하는 사각형을 반환합니다. | DisplayObject | ||
지정된 인덱스에 존재하는 자식 표시 객체 인스턴스를 반환합니다. | DisplayObjectContainer | ||
지정된 이름을 가진 자식 표시 객체를 반환합니다. | DisplayObjectContainer | ||
자식 DisplayObject 인스턴스의 인덱스 위치를 반환합니다. | DisplayObjectContainer | ||
현재 포커스가 있는 객체를 가져옵니다. | UIComponent | ||
지정한 인덱스 위치의 항목을 검색합니다. | SelectableList | ||
dataProvider에서 레이블의 첫 문자가 지정된 문자와 일치하는 다음 항목의 인덱스를 반환합니다. | SelectableList | ||
이 DisplayObjectContainer 인스턴스의 자식(또는 손자 등)으로서 지정된 점 아래에 있는 객체의 배열을 반환합니다. | DisplayObjectContainer | ||
대상 좌표 공간 매개 변수에 의해 정의되는 좌표계를 기준으로 모양의 획을 제외하고 표시 객체의 경계를 정의하는 사각형을 반환합니다. | DisplayObject | ||
목록의 렌더러에 대해 설정되는 스타일을 검색합니다. | SelectableList | ||
구성 요소의 스타일 조회 체인에 설정되어 있는 스타일 속성을 가져옵니다. | UIComponent | ||
[정적]
현재 구성 요소에 대한 기본 스타일 맵을 가져옵니다. | List | ||
Point 객체를 Stage 전역 좌표에서 표시 객체의 로컬 좌표로 변환합니다. | DisplayObject | ||
Stage(전역) 좌표의 2차원 점을 3차원 표시 객체(로컬) 좌표로 변환합니다. | DisplayObject | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
표시 객체의 경계 상자를 평가하여 obj 표시 객체의 경계 상자와 겹치거나 교차하는지 확인합니다. | DisplayObject | ||
표시 객체를 평가하여 x 및 y 매개 변수에 의해 지정된 점과 겹치거나 교차하는지 확인합니다. | DisplayObject | ||
속성을 유효하지 않은 속성으로 표시하고 따로 지정되지 않은 경우 다음 프레임에 구성 요소를 다시 그립니다. | UIComponent | ||
특정 항목의 렌더러를 무효화합니다. | SelectableList | ||
지정한 인덱스 위치에 있는 항목의 렌더러를 무효화합니다. | SelectableList | ||
전체 목록을 무효화하고 목록 항목을 다시 그립니다. | SelectableList | ||
지정한 항목이 목록에서 선택되어 있는지 여부를 확인합니다. | SelectableList | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
지정한 항목 객체의 ICellRenderer가 있는 경우 검색합니다. | SelectableList | ||
[재정의]
labelField 및 labelFunction 속성을 사용하여 지정된 데이터 객체에 대해 렌더러가 표시할 문자열을 검색합니다. | List | ||
3차원 표시 객체의 로컬 좌표에 있는 3차원 점을 Stage 전역 좌표의 2차원 점으로 변환합니다. | DisplayObject | ||
Point 객체를 표시 객체의 로컬 좌표에서 Stage 전역 좌표로 변환합니다. | DisplayObject | ||
[정적]
여러 클래스의 스타일을 하나의 객체로 병합합니다. | UIComponent | ||
구성 요소를 부모 내의 지정된 위치로 이동합니다. | UIComponent | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
목록에서 항목을 모두 제거합니다. | SelectableList | ||
지정된 자식 DisplayObject 인스턴스를 DisplayObjectContainer 인스턴스의 자식 목록에서 제거합니다. | DisplayObjectContainer | ||
DisplayObjectContainer 자식 목록에서 지정된 인덱스 위치에 있는 자식 DisplayObject를 제거합니다. | DisplayObjectContainer | ||
모든 자식 DisplayObject 인스턴스를 DisplayObjectContainer 인스턴스의 자식 목록에서 제거합니다. | DisplayObjectContainer | ||
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | ||
목록에서 지정된 항목을 제거합니다. | SelectableList | ||
지정한 인덱스 위치의 항목을 제거합니다. | SelectableList | ||
지정한 인덱스 위치에 있는 항목을 다른 항목으로 대체합니다. | SelectableList | ||
가상 키보드를 표시합니다. | InteractiveObject | ||
[재정의]
지정된 인덱스에 있는 항목으로 목록을 스크롤합니다. | List | ||
selectedIndex 속성의 현재 값이 나타내는 위치에 있는 항목으로 목록을 스크롤합니다. | SelectableList | ||
표시 객체 컨테이너에서 기존 자식의 위치를 변경합니다. | DisplayObjectContainer | ||
이 구성 요소에 포커스를 설정합니다. | UIComponent | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
목록의 렌더러에 대해 스타일을 설정합니다. | SelectableList | ||
구성 요소를 지정된 폭과 높이로 설정합니다. | UIComponent | ||
이 구성 요소 인스턴스에 스타일 속성을 설정합니다. | UIComponent | ||
현재 데이터 공급자의 요소를 정렬합니다. | SelectableList | ||
하나 이상의 필드를 사용하여 현재 데이터 공급자의 요소를 정렬합니다. | SelectableList | ||
지정된 Sprite를 드래그할 수 있도록 합니다. | Sprite | ||
터치 지원 장치에서 지정된 스프라이트를 드래그할 수 있도록 합니다. | Sprite | ||
이 객체가 루트로 지정된 모든 MovieClip의 타임라인 실행을 재귀적으로 중지합니다. | DisplayObjectContainer | ||
startDrag() 메서드를 종료합니다. | Sprite | ||
startTouchDrag() 메서드를 종료합니다. 터치 지원 장치에서 사용합니다. | Sprite | ||
지정된 두 개의 자식 객체의 z 순서(전후 순서)를 맞바꿉니다. | DisplayObjectContainer | ||
자식 목록에서 지정된 두 곳의 인덱스 위치에 있는 자식 객체의 z 순서(전후 순서)를 맞바꿉니다. | DisplayObjectContainer | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
이 객체의 속성 및 레이아웃의 유효성을 검사하고 업데이트한 다음 필요한 경우 다시 그립니다. | UIComponent | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
스타일은 일반적이거나 특정 테마와 연결되어 있을 수 있습니다. 일반적인 스타일인 경우 모든 테마와 함께 사용할 수 있지만, 특정 테마와 연결된 스타일인 경우 응용 프로그램이 해당 테마를 사용하는 경우에만 스타일을 사용할 수 있습니다.
iconField | 속성 |
iconField:String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
항목의 아이콘을 제공하는 항목 필드를 가져오거나 설정합니다.
참고: iconFunction
속성이 콜백 함수로 설정되어 있으면 iconField
는 사용되지 않습니다.
기본값: "icon".
구현
public function get iconField():String
public function set iconField(value:String):void
예제 ( 예제 사용 방법 )
RedBox
라는 심볼이 라이브러리에 있어야 하며, 해당 심볼 속성에서 [ActionScript에 내보내기]가 전환되어 있어야 합니다.
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { iconSource:RedBox, label:"Item 1" } ); dp.addItem( { iconSource:RedBox, label:"Item 2" } ); dp.addItem( { iconSource:RedBox, label:"Item 3" } ); var list:List = new List(); list.iconField = "iconSource"; list.dataProvider = dp; addChild(list);
iconFunction | 속성 |
iconFunction:Function
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
항목의 아이콘을 가져오는 데 사용할 함수를 가져오거나 설정합니다.
참고: iconFunction
속성이 콜백 함수로 설정되어 있으면 iconField
는 사용되지 않습니다.
기본값: null.
구현
public function get iconFunction():Function
public function set iconFunction(value:Function):void
예제 ( 예제 사용 방법 )
iconFunction
속성을 사용하여 목록에 있는 제한된 수의 항목에 아이콘을 제공합니다. 이 예제가 제대로 작동하려면 RedBox
라는 심볼이 라이브러리에 있어야 하며, 해당 심볼 속성에서 [ActionScript에 내보내기]가 전환되어 있어야 합니다.
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { label:"Item 1" } ); dp.addItem( { label:"Item 2" } ); dp.addItem( { label:"Item 3" } ); var list:List = new List(); list.iconFunction = determineIcon; list.dataProvider = dp; addChild(list); function determineIcon(item:Object):String { if(item.label == "Item 2") { return "RedBox"; } else { return null; } }
labelField | 속성 |
labelField:String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
TextInput 필드와 드롭다운 목록의 레이블로 표시할 dataProvider
객체의 필드 이름을 가져오거나 설정합니다.
기본적으로 구성 요소는 각 dataProvider
항목의 label
속성을 표시합니다. dataProvider
항목에 label
속성이 없으면 다른 속성을 사용하도록 labelField
속성을 설정할 수 있습니다.
참고: labelFunction
속성이 콜백 함수로 설정되어 있으면 labelField
는 사용되지 않습니다.
기본값: "label".
구현
public function get labelField():String
public function set labelField(value:String):void
관련 API 요소
예제 ( 예제 사용 방법 )
label
속성이 아니라 abbreviatedLabel
속성을 사용하여 목록의 각 항목을 표시합니다.
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { abbreviatedLabel:"NY", label:"New York" } ); dp.addItem( { abbreviatedLabel:"CA", label:"California" } ); dp.addItem( { abbreviatedLabel:"WA", label:"Washington" } ); dp.addItem( { abbreviatedLabel:"CT", label:"Connecticut" } ); dp.addItem( { abbreviatedLabel:"VT", label:"Vermont" } ); var list:List = new List(); list.setSize(40,100); list.labelField = "abbreviatedLabel" list.dataProvider = dp; addChild(list);
labelFunction | 속성 |
labelFunction:Function
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
항목의 레이블을 가져오는 데 사용할 함수를 가져오거나 설정합니다.
기본적으로 구성 요소는 각 dataProvider
항목의 label
속성을 표시합니다. 그러나 일부 데이터 세트에는 label
필드가 없거나 해당 값을 수정하지 않고 레이블로 사용할 수 있는 필드가 없을 수 있습니다. 예를 들어 특정 데이터 세트에 전체 이름이 저장되지만 이름이 lastName
및 firstName
필드에 유지되는 경우가 있습니다. 이러한 경우 이 속성을 사용하여 lastName
및 firstName
필드의 값을 전체 이름 문자열로 연결하여 표시하는 콜백 함수를 설정할 수 있습니다.
참고: labelFunction
속성이 콜백 함수로 설정되어 있으면 labelField
는 사용되지 않습니다.
기본값: null.
구현
public function get labelFunction():Function
public function set labelFunction(value:Function):void
예제 ( 예제 사용 방법 )
labelFunction
속성을 각 셀에 표시할 문자열의 형식을 지정하는 함수로 설정합니다.
import fl.data.DataProvider; import fl.controls.List; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({name:"User A", price:0.43}); myDataProvider.addItem({name:"User B", price:0.34}); var users:List = new List(); users.dataProvider = myDataProvider; users.labelFunction = myLabelFunction; addChild(users); function myLabelFunction(item:Object):String { return item.name + " ($" + item.price.toFixed(2) + ")"; }
rowCount | 속성 |
rowCount:uint
[재정의] 언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
목록에 일부라도 표시되는 행 수를 가져오거나 설정합니다.
구현
override public function get rowCount():uint
override public function set rowCount(value:uint):void
예제 ( 예제 사용 방법 )
rowCount
속성을 추적하여 표시할 수 있는 행 수를 확인합니다.
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); var i:uint; for(i=0; i<100; i++) { dp.addItem( { label: "Item " + i } ); } var list:List = new List(); list.setSize(100,300); list.dataProvider = dp; addChild(list); trace(list.rowCount); // 15
rowCount
를 사용하여 List 구성 요소의 크기를 설정합니다.
import fl.controls.Slider; import fl.controls.List; import fl.data.DataProvider; import fl.events.SliderEvent; var dp:DataProvider = new DataProvider(); var i:int; for (i=0; i<8; i++) { dp.addItem({label:"Item " + i}); } var mySlider:Slider = new Slider(); mySlider.move(10, 10); mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 2; mySlider.maximum = 9; mySlider.liveDragging = true; mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myList:List = new List(); myList.dataProvider = dp; myList.move(mySlider.x, mySlider.y + 20); myList.setSize(100, 50); addChild(myList); function changeHandler(event:SliderEvent):void { myList.rowCount = event.value; }
rowHeight | 속성 |
List | () | 생성자 |
public function List()
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
새 List 구성 요소 인스턴스를 만듭니다.
getStyleDefinition | () | 메서드 |
public static function getStyleDefinition():Object
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
현재 구성 요소에 대한 기본 스타일 맵을 가져옵니다. 스타일 맵에는 구성 요소에서 사용하는 스타일에 따라 구성 요소에 적합한 유형이 포함됩니다. 예를 들어 disabledTextFormat
스타일에는 null
값 또는 TextFormat 객체가 포함되어 있습니다. 이러한 스타일을 사용하여 현재 구성 요소에서 setStyle()
을 호출할 수 있습니다. 다음 코드는 지정된 구성 요소에서 기본 disabledTextFormat
스타일을 무시합니다.
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — 기본 스타일 객체입니다.
|
관련 API 요소
예제 ( 예제 사용 방법 )
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
itemToLabel | () | 메서드 |
override public function itemToLabel(item:Object):String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
labelField
및 labelFunction
속성을 기준으로 지정한 데이터 객체에 렌더러가 표시할 문자열을 검색합니다.
참고: labelFunction
속성이 콜백 함수로 설정되어 있으면 labelField
는 사용되지 않습니다.
매개 변수
item:Object — 렌더링할 객체입니다.
|
String — 데이터에 따라 표시할 문자열입니다.
|
예제 ( 예제 사용 방법 )
import fl.controls.List; import fl.data.DataProvider; import fl.events.ListEvent; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({label:"Carrot", price:0.43}); myDataProvider.addItem({label:"Tomato", price:0.34}); myDataProvider.addItem({label:"Blueberry", price:0.72}); myDataProvider.addItem({label:"Turnip", price:0.24}); var myList:List = new List(); myList.setSize(300,80); myList.dataProvider = myDataProvider; myList.labelFunction = myLabelFunction; myList.addEventListener(ListEvent.ITEM_ROLL_OVER, announceLabel); addChild(myList); function myLabelFunction(item:Object):String { return item.label + " - Current price: ($" + item.price.toFixed(2) + ")"; } function announceLabel(e:ListEvent):void { var list:List = e.target as List; var item:Object = e.item; trace("Label: " + item.label); trace("Label displayed: " + list.itemToLabel(item)); }
scrollToIndex | () | 메서드 |
- 라이브러리에 List, Button 및 Label 클래스를 추가합니다.
- 이 코드를 FLA와 같은 디렉토리에 ListExample.as로 저장합니다.
- FLA의 DocumentClass를 ListExample로 설정합니다.
package { import flash.display.Sprite public class ListExample extends Sprite { import flash.events.*; import fl.data.DataProvider; import fl.controls.List import fl.controls.Label import fl.controls.Button private var clearButton:Button; private var availableItems:List; private var selectedItemList:List; private var selectedItemsList:List; public function ListExample() { createComponents(); setupComponents(); } private function setupComponents():void { var dp:Array = new Array(); var i:uint; var count:uint = availableItems.rowCount * 2; for (i = 0; i < count; i++) { dp.push({label:"Item " + i}); } availableItems.allowMultipleSelection = true; availableItems.dataProvider = new DataProvider(dp); availableItems.addEventListener(Event.CHANGE, updateLists); clearButton.addEventListener(MouseEvent.CLICK, clearHandler); } private function clearHandler(event:MouseEvent):void { availableItems.clearSelection(); // clear data providers selectedItemList.dataProvider = new DataProvider(); selectedItemsList.dataProvider = new DataProvider(); } private function updateLists(e:Event):void { selectedItemList.dataProvider = availableItems.selectedItem ? new DataProvider([availableItems.selectedItem]) : new DataProvider(); selectedItemsList.dataProvider = new DataProvider(availableItems.selectedItems); } private function createComponents():void { clearButton = new Button(); availableItems = new List(); selectedItemList = new List(); selectedItemsList = new List(); var availableItemsLabel:Label = new Label(); var selectedItemListLabel:Label = new Label(); var selectedItemsListLabel:Label = new Label(); clearButton.move(10,142); availableItems.move(10,32); selectedItemList.move(120,32); selectedItemsList.move(230,32); availableItemsLabel.move(10,10); selectedItemListLabel.move(120,10); selectedItemsListLabel.move(230,10); clearButton.label = "Clear Selection" availableItemsLabel.text = "Available Items"; selectedItemListLabel.text = "Selected Item"; selectedItemsListLabel.text = "All Selected Items"; addChild(clearButton); addChild(availableItems); addChild(selectedItemList); addChild(selectedItemsList); addChild(availableItemsLabel); addChild(selectedItemListLabel); addChild(selectedItemsListLabel); } } }
Tue Jun 12 2018, 03:17 PM Z