패키지 | fl.events |
클래스 | public class DataChangeEvent |
상속 | DataChangeEvent Event Object |
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
이 클래스는 다음과 같은 이벤트를 제공합니다.
-
DataChangeEvent.DATA_CHANGE
: 구성 요소 데이터가 변경되면 전달됩니다.
관련 API 요소
공용 속성
속성 | 정의 주체 | ||
---|---|---|---|
bubbles : Boolean [읽기 전용]
이벤트가 버블링 이벤트인지 여부를 나타냅니다. | Event | ||
cancelable : Boolean [읽기 전용]
해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다. | Event | ||
changeType : String [읽기 전용]
이벤트를 트리거한 변경 사항의 유형을 가져옵니다. | DataChangeEvent | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
currentTarget : Object [읽기 전용]
이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. | Event | ||
endIndex : uint [읽기 전용]
변경된 항목의 배열에서 마지막으로 변경된 항목의 인덱스를 가져옵니다. | DataChangeEvent | ||
eventPhase : uint [읽기 전용]
이벤트 흐름에서 현재 단계입니다. | Event | ||
items : Array [읽기 전용]
변경된 항목이 포함된 배열을 가져옵니다. | DataChangeEvent | ||
startIndex : uint [읽기 전용]
변경된 항목의 배열에서 첫 번째로 변경된 항목의 인덱스를 가져옵니다. | DataChangeEvent | ||
target : Object [읽기 전용]
이벤트 대상입니다. | Event | ||
type : String [읽기 전용]
이벤트 유형입니다. | Event |
공용 메서드
메서드 | 정의 주체 | ||
---|---|---|---|
DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)
지정된 매개 변수를 사용하여 새 DataChangeEvent 객체를 만듭니다. | DataChangeEvent | ||
[재정의]
DataEvent 객체의 복사본을 하나 만들고 각 매개 변수 값을 원본과 동일하게 설정합니다. | DataChangeEvent | ||
사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다. | Event | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다. | Event | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다. | Event | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다. | Event | ||
이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다. | Event | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
[재정의]
DataChangeEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. | DataChangeEvent | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object |
공용 상수
상수 | 정의 주체 | ||
---|---|---|---|
DATA_CHANGE : String = "dataChange" [정적]
dataChange 이벤트 객체의 type 속성 값을 정의합니다. | DataChangeEvent | ||
PRE_DATA_CHANGE : String = "preDataChange" [정적]
preDataChange 이벤트 객체의 type 속성 값을 정의합니다. | DataChangeEvent |
속성 세부 정보
changeType | 속성 |
endIndex | 속성 |
items | 속성 |
startIndex | 속성 |
생성자 세부 정보
DataChangeEvent | () | 생성자 |
public function DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
지정된 매개 변수를 사용하여 새 DataChangeEvent 객체를 만듭니다.
매개 변수eventType:String — change 이벤트 유형입니다.
| |
changeType:String — 적용된 변경 사항의 유형입니다. DataChangeType 클래스는 이 매개 변수에 사용할 수 있는 값을 정의합니다.
| |
items:Array — 변경된 항목의 목록입니다.
| |
startIndex:int (default = -1 ) — 첫 번째로 변경된 항목의 인덱스입니다.
| |
endIndex:int (default = -1 ) — 마지막으로 변경된 항목의 인덱스입니다.
|
메서드 세부 정보
clone | () | 메서드 |
toString | () | 메서드 |
override public function toString():String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
DataChangeEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. 문자열의 형식은 다음과 같습니다.
[ DataChangeEvent type= value changeType= value startIndex= value endIndex= value bubbles= value cancelable= value
]
String — DataChangeEvent 객체의 속성이 모두 포함된 문자열입니다.
|
상수 세부 정보
DATA_CHANGE | 상수 |
public static const DATA_CHANGE:String = "dataChange"
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
dataChange
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
changeType | 적용된 변경 사항의 유형을 확인합니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
endIndex | 마지막으로 변경된 항목의 인덱스를 확인합니다. |
items | 변경된 항목을 나열하는 배열입니다. |
startIndex | 첫 번째로 변경된 항목의 인덱스를 확인합니다. |
target | 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
관련 API 요소
PRE_DATA_CHANGE | 상수 |
public static const PRE_DATA_CHANGE:String = "preDataChange"
언어 버전: | ActionScript 3.0 |
제품 버전: | Flash CS3 |
런타임 버전: | Flash Player 9.0.28.0, AIR 1.0 |
preDataChange
이벤트 객체의 type
속성 값을 정의합니다. 이 이벤트 객체는 구성 요소 데이터를 변경하기 전에 전달됩니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
changeType | 적용할 변경 사항의 유형을 확인합니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
endIndex | 변경할 마지막 항목의 인덱스를 확인합니다. |
items | 변경할 항목을 나열하는 배열입니다. |
startIndex | 변경할 첫 번째 항목의 인덱스를 확인합니다. |
target | 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
관련 API 요소
예제 예제 사용 방법
DataChangeEventExample.as
이 예제에서는 DataProvider를 통해 DataChangeEvent 브로드캐스트를 수신하고 이 이벤트를 사용하여 DataGrid를 수동으로 채우는 방법을 보여 줍니다.
- DataGrid 및 Button 클래스를 라이브러리에 추가합니다.
- 이 코드를 FLA와 같은 디렉토리에 DataChangeEventExample.as로 저장합니다.
- FLA의 DocumentClass를 DataChangeEventExample로 설정합니다.
package { import flash.display.Sprite; import flash.events.MouseEvent; import fl.data.DataProvider; import fl.events.DataChangeEvent; import fl.controls.DataGrid; import fl.controls.Button; public class DataChangeEventExample extends Sprite { private var dg:DataGrid; private var dp:DataProvider; private var names:Array = [ "Mary", "Bob", "Sue", "Joe" ]; public function DataChangeEventExample() { dp = new DataProvider(); dp.addEventListener(DataChangeEvent.DATA_CHANGE,dataChanged); dg = new DataGrid(); dg.move(10,45); dg.setSize(300,250); dg.columns = [ "name", "phone", "email" ]; addChild(dg); var addContactBtn:Button = new Button(); addContactBtn.label = "Add Contact"; addContactBtn.move(10,10); addContactBtn.addEventListener(MouseEvent.CLICK, addContact); addChild(addContactBtn); } private function getRandomPhone():String { return randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+randomDigit(); } private function randomDigit():String { return String(Math.round(Math.random()*10)%10); } private function getRandomName():String { return names[Math.round(Math.random()*names.length)%names.length]; } private function addContact(e:MouseEvent):void { var randomName:String = getRandomName() dp.addItem( { name: randomName, phone: getRandomPhone(), email: randomName + "@fictitious.com" } ); } private function dataChanged(e:DataChangeEvent):void { var changedItems:Array = e.items; dg.addItem(changedItems[0]); } } }
Tue Jun 12 2018, 03:17 PM Z