패키지fl.events
클래스public class ListEvent
상속ListEvent Inheritance Event Inheritance Object
하위 클래스 DataGridEvent

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

ListEvent 클래스는 List, DataGrid, TileList 및 ComboBox 구성 요소 등 목록 기반 구성 요소의 이벤트를 정의합니다. 이러한 이벤트는 다음과 같습니다.

예제 보기

참고 사항

List
SelectableList


Public 속성
 속성다음에 의해 정의됨
 Inheritedbubbles : Boolean
[읽기 전용] 이벤트가 버블링 이벤트인지 여부를 나타냅니다.
Event
 Inheritedcancelable : Boolean
[읽기 전용] 해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다.
Event
  columnIndex : int
[읽기 전용] 이 이벤트와 연관된 항목의 열 인덱스를 가져옵니다.
ListEvent
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
 InheritedcurrentTarget : Object
[읽기 전용] 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
Event
 InheritedeventPhase : uint
[읽기 전용] 이벤트 흐름에서 현재 단계입니다.
Event
  index : int
[읽기 전용] 렌더러가 포함된 셀의 인덱스(0부터 시작)를 가져옵니다.
ListEvent
  item : Object
[읽기 전용] 현재 셀 렌더러에 속한 데이터를 가져옵니다.
ListEvent
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  rowIndex : Object
[읽기 전용] 이 이벤트와 연관된 항목의 행 인덱스를 가져옵니다.
ListEvent
 Inheritedtarget : Object
[읽기 전용] 이벤트 대상입니다.
Event
 Inheritedtype : String
[읽기 전용] 이벤트 유형입니다.
Event
Public 메서드
 메서드다음에 의해 정의됨
  
ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, index:int = -1, item:Object = null)
지정된 매개 변수를 사용하여 새 ListEvent 객체를 만듭니다.
ListEvent
  
ListEvent 객체의 복사본을 만들고 각 매개 변수의 값을 원본과 동일하게 설정합니다.
ListEvent
 Inherited
formatToString(className:String, ... arguments):String
사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다.
Event
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다.
Event
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다.
Event
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
Event
 Inherited
이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
Event
  
ListEvent 객체의 속성이 모두 포함된 문자열을 반환합니다.
ListEvent
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
Public 상수
 상수다음에 의해 정의됨
 InheritedACTIVATE : String = "activate"
[정적] ACTIVATE 상수는 activate 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedADDED : String = "added"
[정적] Event.ADDED 상수는 added 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[정적] Event.ADDED_TO_STAGE 상수는 addedToStage 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCANCEL : String = "cancel"
[정적] Event.CANCEL 상수는 cancel 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCHANGE : String = "change"
[정적] Event.CHANGE 상수는 change 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCLEAR : String = "clear"
[정적] Event.CLEAR 상수는 clear 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCLOSE : String = "close"
[정적] Event.CLOSE 상수는 close 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only CLOSING : String = "closing"
[정적] Event.CLOSING 상수는 closing 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCOMPLETE : String = "complete"
[정적] Event.COMPLETE 상수는 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCONNECT : String = "connect"
[정적] Event.CONNECT 상수는 connect 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCOPY : String = "copy"
[정적] copy 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCUT : String = "cut"
[정적] cut 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedDEACTIVATE : String = "deactivate"
[정적] Event.DEACTIVATE 상수는 deactivate 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedDISPLAYING : String = "displaying"
[정적] Event.DISPLAYING 상수는 displaying 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[정적] Event.ENTER_FRAME 상수는 enterFrame 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[정적] Event.EXIT_FRAME 상수는 exitFrame 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only EXITING : String = "exiting"
[정적] Event.EXITING 상수는 exiting 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[정적] Event.FRAME_CONSTRUCTED 상수는 frameConstructed 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[정적] Event.FULL_SCREEN 상수는 fullScreen 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[정적] Event.HTML_BOUNDS_CHANGE 상수는 htmlBoundsChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[정적] Event.HTML_DOM_INITIALIZE 상수는 htmlDOMInitialize 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[정적] Event.HTML_RENDER 상수는 htmlRender 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedID3 : String = "id3"
[정적] Event.ID3 상수는 id3 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedINIT : String = "init"
[정적] Event.INIT 상수는 init 이벤트 객체의 type 속성 값을 정의합니다.
Event
  ITEM_CLICK : String = "itemClick"
[정적] itemClick 이벤트 객체의 type 속성 값을 정의합니다.
ListEvent
  ITEM_DOUBLE_CLICK : String = "itemDoubleClick"
[정적] itemDoubleClick 이벤트 객체의 type 속성 값을 정의합니다.
ListEvent
  ITEM_ROLL_OUT : String = "itemRollOut"
[정적] itemRollOut 이벤트 객체의 type 속성 값을 정의합니다.
ListEvent
  ITEM_ROLL_OVER : String = "itemRollOver"
[정적] itemRollOver 이벤트 객체의 type 속성 값을 정의합니다.
ListEvent
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[정적] Event.LOCATION_CHANGE 상수는 locationChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[정적] Event.MOUSE_LEAVE 상수는 mouseLeave 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[정적] Event.NETWORK_CHANGE 상수는 networkChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedOPEN : String = "open"
[정적] Event.OPEN 상수는 open 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedPASTE : String = "paste"
[정적] Event.PASTE 상수는 paste 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedREMOVED : String = "removed"
[정적] Event.REMOVED 상수는 removed 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[정적] Event.REMOVED_FROM_STAGE 상수는 removedFromStage 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedRENDER : String = "render"
[정적] Event.RENDER 상수는 render 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedRESIZE : String = "resize"
[정적] Event.RESIZE 상수는 resize 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedSCROLL : String = "scroll"
[정적] Event.SCROLL 상수는 scroll 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedSELECT : String = "select"
[정적] Event.SELECT 상수는 select 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedSELECT_ALL : String = "selectAll"
[정적] Event.SELECT_ALL 상수는 selectAll 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[정적] Event.SOUND_COMPLETE 상수는 soundComplete 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[정적] Event.TAB_CHILDREN_CHANGE 상수는 tabChildrenChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[정적] Event.TAB_ENABLED_CHANGE 상수는 tabEnabledChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[정적] Event.TAB_INDEX_CHANGE 상수는 tabIndexChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedUNLOAD : String = "unload"
[정적] Event.UNLOAD 상수는 unload 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[정적] Event.USER_IDLE 상수는 userIdle 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[정적] Event.USER_PRESENT 상수는 userPresent 이벤트 객체의 type 속성 값을 정의합니다.
Event
속성 정보
columnIndex속성
columnIndex:int  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

이 이벤트와 연관된 항목의 열 인덱스를 가져옵니다.



구현
    public function get columnIndex():int

참고 사항

index속성 
index:int  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

렌더러가 포함된 셀의 인덱스(0부터 시작)를 가져옵니다.



구현
    public function get index():int
item속성 
item:Object  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

현재 셀 렌더러에 속한 데이터를 가져옵니다.



구현
    public function get item():Object
rowIndex속성 
rowIndex:Object  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

이 이벤트와 연관된 항목의 행 인덱스를 가져옵니다.



구현
    public function get rowIndex():Object

참고 사항

생성자 정보
ListEvent()생성자
public function ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, index:int = -1, item:Object = null)

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

지정된 매개 변수를 사용하여 새 ListEvent 객체를 만듭니다.

매개 변수
type:String — 이벤트 유형으로, 이 값은 이 이벤트를 유발하는 액션을 확인합니다.
 
bubbles:Boolean (default = false) — 이벤트가 표시 목록 계층을 버블링할 수 있는지 여부를 나타냅니다.
 
cancelable:Boolean (default = false) — 해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다.
 
columnIndex:int (default = -1) — 렌더러가 포함된 열의 인덱스(0부터 시작), 또는 열에 있는 데이터의 시각적 표현입니다.
 
rowIndex:int (default = -1) — 렌더러가 포함된 행의 인덱스(0부터 시작), 또는 행에 있는 데이터의 시각적 표현입니다.
 
index:int (default = -1) — DataProvider에 있는 항목의 인덱스(0부터 시작)입니다.
 
item:Object (default = null) — 렌더러에 속한 데이터에 대한 참조입니다.
메서드 정보
clone()메서드
override public function clone():Event

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

ListEvent 객체의 복사본을 만들고 각 매개 변수의 값을 원본과 동일하게 설정합니다.

반환값
Event — 원본과 매개 변수 값이 동일한 새 ListEvent 객체입니다.
toString()메서드 
override public function toString():String

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

ListEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. 문자열의 형식은 다음과 같습니다.

[ ListEvent type= value bubbles= value cancelable= value columnIndex= value rowIndex= value ]

반환값
String — ListEvent 객체의 문자열 표현입니다.
상수 정보
ITEM_CLICK상수
public static const ITEM_CLICK:String = "itemClick"

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

itemClick 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable true
columnIndex 렌더러가 포함된 열의 인덱스(0부터 시작)입니다.
currentTarget 이벤트 리스너를 통해 이벤트 객체를 처리하고 있는 객체입니다.
index 렌더러가 포함된 DataProvider의 인덱스(0부터 시작)입니다.
item 렌더러에 속한 데이터에 대한 참조입니다.
rowIndex 렌더러가 포함된 행의 인덱스(0부터 시작)입니다.
target 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 액세스하려면 currentTarget 속성을 사용합니다.

ITEM_DOUBLE_CLICK상수 
public static const ITEM_DOUBLE_CLICK:String = "itemDoubleClick"

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

itemDoubleClick 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable true
columnIndex 렌더러가 포함된 열의 인덱스(0부터 시작)입니다.
currentTarget 이벤트 리스너를 통해 이벤트 객체를 처리하고 있는 객체입니다.
index 렌더러가 포함된 DataProvider의 인덱스(0부터 시작)입니다.
item 렌더러에 속한 데이터에 대한 참조입니다.
rowIndex 렌더러가 포함된 행의 인덱스(0부터 시작)입니다.
target 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 액세스하려면 currentTarget 속성을 사용합니다.

ITEM_ROLL_OUT상수 
public static const ITEM_ROLL_OUT:String = "itemRollOut"

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

itemRollOut 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
columnIndex 렌더러가 포함된 열의 인덱스(0부터 시작)입니다.
currentTarget 이벤트 리스너를 통해 이벤트 객체를 처리하고 있는 객체입니다.
index 렌더러가 포함된 DataProvider의 인덱스(0부터 시작)입니다.
item 렌더러에 속한 데이터에 대한 참조입니다.
rowIndex 렌더러가 포함된 행의 인덱스(0부터 시작)입니다.
target 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 액세스하려면 currentTarget 속성을 사용합니다.

참고 사항

ITEM_ROLL_OVER상수 
public static const ITEM_ROLL_OVER:String = "itemRollOver"

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.28.0

itemRollOver 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
columnIndex 렌더러가 포함된 열의 인덱스(0부터 시작)입니다.
currentTarget 이벤트 리스너를 통해 이벤트 객체를 처리하고 있는 객체입니다.
index 렌더러가 포함된 DataProvider의 인덱스(0부터 시작)입니다.
item 렌더러에 속한 데이터에 대한 참조입니다.
rowIndex 렌더러가 포함된 행의 인덱스(0부터 시작)입니다.
target 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 액세스하려면 currentTarget 속성을 사용합니다.

참고 사항

예제 예제 사용 방법
ListEventExample.as

이 예제에서는 ListEvent 클래스를 사용하여 데이터 격자 안에 있는 항목의 행과 열을 결정하는 방법을 보여 줍니다.
  1. DataGrid 구성 요소를 라이브러리에 추가합니다.
  2. 이 코드를 FLA와 같은 디렉토리에 ListEventExample.as로 저장합니다.
  3. FLA의 DocumentClass를 ListEventExample로 설정합니다.
package
{
    import flash.display.Sprite;
    import fl.data.DataProvider;
    import fl.controls.DataGrid;
    import fl.events.ListEvent;
    
    public class ListEventExample extends Sprite
    {
        private var dg:DataGrid;
        
        public function ListEventExample() {
            createDataGrid();
        }
        private function createDataGrid():void {
            dg = new DataGrid();
            addChild(dg);
            dg.setSize(200,300);
            
            var dp:DataProvider = new DataProvider();
            var i:uint;
            var totalRows:uint = 42;
            for(i=0; i<totalRows; i++) {
                dp.addItem( {     col1:getRandomNumber(),
                                   col2:getRandomNumber(),
                                col3:getRandomNumber() } );
            }
            dg.dataProvider = dp;
            dg.addEventListener(ListEvent.ITEM_ROLL_OVER, declarePosition);
        }
        private function declarePosition(e:ListEvent):void {
            trace("You are above row: " + e.rowIndex + " column: " + e.columnIndex);    
        }
        private function getRandomNumber():uint {
            return Math.round(Math.random()*100);
        }
    }
}