| 패키지 | 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
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시