NativeDragEvent

패키지	flash.events
클래스	public class NativeDragEvent
상속	NativeDragEvent MouseEvent Event Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

기본 드래그 이벤트는 드래그 앤 드롭 작업과 관련된 대화형 객체에 의해 전달됩니다.

시작 객체는 다음을 전달합니다.

nativeDragStart - 드래그 작업이 시작될 때
nativeDragUpdate - 드래그 작업이 진행되는 동안
nativeDragComplete - 사용자가 드래그한 항목을 놓을 때(드롭이 허용되는지 여부와 관계 없음)

시작하는 객체는 드래그 작업을 시작한 NativeDragManager.doDrag()에 대한 호출에서 NativeDragManager 객체에 전달된 대화형 객체입니다.

잠재적 대상 객체는 다음을 전달합니다.

nativeDragEnter - 드래그 동작이 객체 경계 내 전달될 때
nativeDragOver - 드래그 동작이 객체 경계 내 유지되는 동안
nativeDragExit - 드래그 동작이 객체 경계를 벗어날 때
nativeDragDrop - 사용자가 객체에 드래그한 항목을 놓고 객체가 이전의 NativeDragManager.acceptDragDrop() 호출을 통해 드롭을 허용할 때

일반적으로 nativeDragEnter 또는 nativeDragOver 이벤트의 핸들러는 허용된 드래그 액션과 함께 드래그할 데이터를 평가하여 대화형 객체에서 드롭을 허용할지 여부를 결정합니다. 대화형 객체가 적합한 대상이 되도록 지정하려면 이벤트 핸들러에서 객체에 대한 참조를 전달하여 NativeDragManager.acceptDrop() 함수를 호출해야 합니다. 사용자가 지정한 객체 위에서 마우스 버튼을 놓으면 객체가 드롭 대상이 되고 nativeDragDrop 이벤트를 전달합니다.

InteractiveObject 유형의 모든 객체가 드래그 시작 객체 또는 드롭 대상이 될 수 있습니다.

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		allowedActions : NativeDragOptions 이 드래그 작업을 시작한 표시 객체에 의해 허용되는 액션을 지정하는 NativeDragOptions 객체입니다.	NativeDragEvent
		altKey : Boolean Alt 키가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다.	MouseEvent
		bubbles : Boolean [읽기 전용] 이벤트가 버블링 이벤트인지 여부를 나타냅니다.	Event
		buttonDown : Boolean 마우스 기본 버튼이 눌려 있는지(true) 눌려 있지 않은지(false)를 나타냅니다.	MouseEvent
		cancelable : Boolean [읽기 전용] 해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다.	Event
		clickCount : int [읽기 전용] 마우스 누름 이벤트가 다중 클릭 시퀀스의 일부인지 여부를 나타냅니다.	MouseEvent
		clipboard : Clipboard 이 드래그 작업 내의 데이터가 포함되어 있는 Clipboard 객체입니다.	NativeDragEvent
		commandKey : Boolean Command 키가 활성화되었는지 여부를 나타냅니다(Mac만 해당). commandKey 속성 값은 Mac의 ctrlKey 속성과 동일한 값을 가집니다.	MouseEvent
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		controlKey : Boolean Mac에서 Control 키가 활성화되었는지 여부 및 Windows 또는 Linux에서 Ctrl 키가 활성화되었는지 여부를 나타냅니다.	MouseEvent
		ctrlKey : Boolean Windows 또는 Linux에서 Ctrl 키가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다.	MouseEvent
		currentTarget : Object [읽기 전용] 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.	Event
		delta : int 마우스 휠을 한 단계 돌릴 때마다 몇 행씩 스크롤되는지를 나타냅니다.	MouseEvent
		dropAction : String 현재 액션입니다.	NativeDragEvent
		eventPhase : uint [읽기 전용] 이벤트 흐름에서 현재 단계입니다.	Event
		isRelatedObjectInaccessible : Boolean true이면 relatedObject 속성이 보안 샌드박스와 관련된 이유로 인해 null로 설정됩니다.	MouseEvent
		localX : Number 마우스 잠금이 비활성화된 경우 포함 Sprite와 관련된 이벤트가 발생한 지점의 수평 좌표입니다.	MouseEvent
		localY : Number 마우스 잠금이 비활성화된 경우 포함 Sprite와 관련된 이벤트가 발생한 지점의 수직 좌표입니다.	MouseEvent
		movementX : Number 마우스 잠금이 활성화된 경우 마지막 마우스 이벤트 이후 X 방향의 마우스 위치 변경 사항입니다.	MouseEvent
		movementY : Number 마우스 잠금이 활성화된 경우 마지막 마우스 이벤트 이후 Y 방향의 마우스 위치 변경 사항입니다.	MouseEvent
		relatedObject : InteractiveObject 이벤트와 관련된 표시 목록 객체에 대한 참조입니다.	MouseEvent
		shiftKey : Boolean Shift 키가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다.	MouseEvent
		stageX : Number [읽기 전용] 전역 스테이지 좌표에서 이벤트가 발생한 지점의 수평 좌표입니다.	MouseEvent
		stageY : Number [읽기 전용] 전역 스테이지 좌표에서 이벤트가 발생한 지점의 수직 좌표입니다.	MouseEvent
		target : Object [읽기 전용] 이벤트 대상입니다.	Event
		type : String [읽기 전용] 이벤트 유형입니다.	Event

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		NativeDragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, clipboard:Clipboard = null, allowedActions:NativeDragOptions = null, dropAction:String = null, controlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false) 기본 드래그 앤 드롭 이벤트와 관련된 특정 정보를 갖는 Event 객체를 만듭니다.	NativeDragEvent
		clone():Event [재정의] 이 NativeDragEvent 객체의 복사본을 만듭니다.	NativeDragEvent
		formatToString(className:String, ... arguments):String 사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다.	Event
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isDefaultPrevented():Boolean 이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다.	Event
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		preventDefault():void 이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다.	Event
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		stopImmediatePropagation():void 이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.	Event
		stopPropagation():void 이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.	Event
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String [재정의] 이 NativeDragEvent 객체의 속성을 문자열 형식으로 만듭니다.	NativeDragEvent
		updateAfterEvent():void 표시 목록이 수정된 경우, 이 이벤트의 처리가 완료된 뒤 렌더링하도록 Flash Player 또는 Adobe AIR에 지시합니다.	MouseEvent
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object

공용 상수

상속되는 공용 상수 숨기기

상속되는 공용 상수 표시

	상수		정의 주체
		NATIVE_DRAG_COMPLETE : String = "nativeDragComplete" [정적] NativeDragEvent.NATIVE_DRAG_COMPLETE는 nativeDragComplete 이벤트 객체의 type 속성 값을 정의합니다.	NativeDragEvent
		NATIVE_DRAG_DROP : String = "nativeDragDrop" [정적] NativeDragEvent.NATIVE_DRAG_DROP은 nativeDragDrop 이벤트 객체의 type 속성 값을 정의합니다.	NativeDragEvent
		NATIVE_DRAG_ENTER : String = "nativeDragEnter" [정적] NativeDragEvent.NATIVE_DRAG_ENTER는 nativeDragEnter 이벤트 객체의 type 속성 값을 정의합니다.	NativeDragEvent
		NATIVE_DRAG_EXIT : String = "nativeDragExit" [정적] NativeDragEvent.NATIVE_DRAG_EXIT는 nativeDragExit 이벤트 객체의 type 속성 값을 정의합니다.	NativeDragEvent
		NATIVE_DRAG_OVER : String = "nativeDragOver" [정적] NativeDragEvent.NATIVE_DRAG_OVER는 nativeDragOver 이벤트 객체의 type 속성 값을 정의합니다.	NativeDragEvent
		NATIVE_DRAG_START : String = "nativeDragStart" [정적] NativeDragEvent.NATIVE_DRAG_START는 nativeDragStart 이벤트 객체의 type 속성 값을 정의합니다.	NativeDragEvent
		NATIVE_DRAG_UPDATE : String = "nativeDragUpdate" [정적] NativeDragEvent.NATIVE_DRAG_UPDATE는 nativeDragUpdate 이벤트 객체의 type 속성 값을 정의합니다.	NativeDragEvent

속성 세부 정보

allowedActions

속성

public var allowedActions:NativeDragOptions

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 드래그 작업을 시작한 표시 객체에 의해 허용되는 액션을 지정하는 NativeDragOptions 객체입니다.

관련 API 요소

flash.desktop.NativeDragOptions

clipboard

속성

public var clipboard:Clipboard

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 드래그 작업 내의 데이터가 포함되어 있는 Clipboard 객체입니다.

이벤트를 전달하는 객체가 시작하는 객체와 동일한 보안 도메인에 있지 않는 경우, nativeDragDrop 이벤트의 핸들러에서만 클립보드를 읽을 수 있습니다.

관련 API 요소

flash.desktop.Clipboard

dropAction

속성

public var dropAction:String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

현재 액션입니다. nativeDragComplete 이벤트에서 dropAction 속성은 최종 액션을 보고합니다.

생성자 세부 정보

()

생성자

public function NativeDragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, clipboard:Clipboard = null, allowedActions:NativeDragOptions = null, dropAction:String = null, controlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false)

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

기본 드래그 앤 드롭 이벤트와 관련된 특정 정보를 갖는 Event 객체를 만듭니다.

Event 객체는 매개 변수로 이벤트 리스너에 전달됩니다. 기본 드래그 이벤트를 전달해도 관련 비헤이비어가 트리거되지 않습니다.

매개 변수

	`type:String` — 이벤트 유형입니다. 사용할 수 있는 값에는 `NativeDragEvent.NATIVE_DRAG_START`, `NativeDragEvent.NATIVE_DRAG_UPDATE`, `NativeDragEvent.NATIVE_DRAG_ENTER`, `NativeDragEvent.NATIVE_DRAG_OVER`, `NativeDragEvent.NATIVE_DRAG_EXIT`, `NativeDragEvent.NATIVE_DRAG_DROP`, `NativeDragEvent.NATIVE_DRAG_COMPLETE`가 있습니다.

	`bubbles:Boolean` (default = `false`) — Event 객체가 이벤트 흐름의 버블링 단계에 참여하는지 여부를 나타냅니다.

	`cancelable:Boolean` (default = `true`) — Event 객체를 취소할 수 있는지 여부를 나타냅니다.

	`localX:Number` (default = `NaN`) — 포함 Sprite와 관련된 이벤트가 발생한 지점의 수평 좌표입니다.

	`localY:Number` (default = `NaN`) — 포함 Sprite와 관련된 이벤트가 발생한 지점의 수직 좌표입니다.

	`relatedObject:InteractiveObject` (default = `null`) — 관련된 대화형 표시 객체입니다.

	`clipboard:Clipboard` (default = `null`) — 전송될 데이터가 포함된 Clipboard 객체입니다.

	`allowedActions:NativeDragOptions` (default = `null`) — 허용되는 액션(이동, 복사 및 연결)을 정의하는 NativeDragOptions 객체입니다.

	`dropAction:String` (default = `null`) — 현재 액션입니다.

	`controlKey:Boolean` (default = `false`) — Control 키가 활성화되었는지 여부를 나타냅니다.

	`altKey:Boolean` (default = `false`) — Alt 키가 활성화되었는지 여부를 나타냅니다.

	`shiftKey:Boolean` (default = `false`) — Shift 키가 활성화되었는지 여부를 나타냅니다.

	`commandKey:Boolean` (default = `false`) — Command 키가 활성화되었는지 여부를 나타냅니다.

메서드 세부 정보

clone

()

메서드

override public function clone():Event

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 NativeDragEvent 객체의 복사본을 만듭니다.

반환값

Event — 원본과 동일한 속성 값을 갖는 새 NativeDragEvent 객체입니다.

toString

()

메서드

override public function toString():String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 NativeDragEvent 객체의 속성을 문자열 형식으로 만듭니다.

문자열의 형식은 다음과 같습니다.

[NativeDragEvent type=value bubbles=value cancelable=value ... commandKey=value]

반환값

String — 문자열로서의 이 NativeDragEvent의 속성입니다.

상수 세부 정보

NATIVE_DRAG_COMPLETE

상수

public static const NATIVE_DRAG_COMPLETE:String = "nativeDragComplete"

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_COMPLETE는 nativeDragComplete 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`allowedActions`	이 드래그 작업과 관련된 액션을 지정하는 NativeDragOptions 객체입니다.
`bubbles`	`true`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`clipboard`	드래그된 데이터가 포함되어 있는 Clipboard 객체입니다.
`dropAction`	드롭 대상에 의해 선택된 액션입니다(또는 설정된 액션이 없는 경우 `none`).

NATIVE_DRAG_DROP

상수

public static const NATIVE_DRAG_DROP:String = "nativeDragDrop"

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_DROP은 nativeDragDrop 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`allowedActions`	이 드래그 작업과 관련된 액션을 지정하는 NativeDragOptions 객체입니다.
`bubbles`	`true`
`cancelable`	`true`. 이 이벤트를 취소하면 드래그 작업이 취소됩니다.
`clipboard`	드래그된 데이터가 포함되어 있는 Clipboard 객체입니다. 클립보드는 이 이벤트를 전달하는 객체가 시작 객체와 동일한 보안 도메인에 있지 않는 경우에 읽을 수 있습니다.
`dropAction`	드롭 대상에 의해 선택된 액션입니다(또는 설정된 액션이 없는 경우 `none`).

NATIVE_DRAG_ENTER

상수

public static const NATIVE_DRAG_ENTER:String = "nativeDragEnter"

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_ENTER는 nativeDragEnter 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`allowedActions`	이 드래그 작업과 관련된 액션을 지정하는 NativeDragOptions 객체입니다.
`bubbles`	`true`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`clipboard`	드래그된 데이터가 포함되어 있는 Clipboard 객체입니다. 클립보드는 이 이벤트를 전달하는 객체가 시작 객체와 동일한 보안 도메인에 있는 경우에만 읽을 수 있습니다.
`dropAction`	드롭 대상에 의해 선택된 액션입니다(또는 설정된 액션이 없는 경우 `none`).

NATIVE_DRAG_EXIT

상수

public static const NATIVE_DRAG_EXIT:String = "nativeDragExit"

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_EXIT는 nativeDragExit 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`allowedActions`	이 드래그 작업과 관련된 액션을 지정하는 NativeDragOptions 객체입니다.
`bubbles`	`true`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`clipboard`	드래그된 데이터가 포함되어 있는 Clipboard 객체입니다. 클립보드는 이 이벤트를 전달하는 객체가 시작 객체와 동일한 보안 도메인에 있는 경우에만 읽을 수 있습니다.
`dropAction`	드롭 대상에 의해 선택된 액션입니다(또는 설정된 액션이 없는 경우 `none`).

NATIVE_DRAG_OVER

상수

public static const NATIVE_DRAG_OVER:String = "nativeDragOver"

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_OVER는 nativeDragOver 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`allowedActions`	이 드래그 작업과 관련된 액션을 지정하는 NativeDragOptions 객체입니다.
`bubbles`	`true`
`cancelable`	`true`. 이 이벤트를 취소하면 드래그 작업이 취소됩니다.
`clipboard`	드래그된 데이터가 포함되어 있는 Clipboard 객체입니다. 클립보드는 이 이벤트를 전달하는 객체가 시작 객체와 동일한 보안 도메인에 있는 경우에만 읽을 수 있습니다.
`dropAction`	드롭 대상에 의해 선택된 액션입니다(또는 설정된 액션이 없는 경우 `none`).

NATIVE_DRAG_START

상수

public static const NATIVE_DRAG_START:String = "nativeDragStart"

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_START는 nativeDragStart 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`allowedActions`	이 드래그 작업과 관련된 액션을 지정하는 NativeDragOptions 객체입니다.
`bubbles`	`true`
`cancelable`	`true`. 이 이벤트를 취소하면 드래그 작업이 취소됩니다.
`clipboard`	드래그된 데이터가 포함되어 있는 Clipboard 객체입니다.
`dropAction`	드롭 대상에 의해 선택된 액션입니다(또는 설정된 액션이 없는 경우 `none`).

NATIVE_DRAG_UPDATE

상수

public static const NATIVE_DRAG_UPDATE:String = "nativeDragUpdate"

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_UPDATE는 nativeDragUpdate 이벤트 객체의 type 속성 값을 정의합니다.

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

속성	값
`allowedActions`	이 드래그 작업과 관련된 액션을 지정하는 NativeDragOptions 객체입니다.
`bubbles`	`true`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`clipboard`	드래그된 데이터가 포함되어 있는 Clipboard 객체입니다.
`dropAction`	드롭 대상에 의해 선택된 액션입니다(또는 설정된 액션이 없는 경우 `none`).

법적 고지 사항 | 온라인 개인 정보 보호 정책

NativeDragEvent - AS3

클래스 x

allowedActions

clipboard

dropAction