mx.managers.DragManager (Flex™ 2 레퍼런스 가이드)

Package	mx.managers
Class	public class DragManager
Inheritance	DragManager Object

DragManager 클래스는, Flex 어플리케이션으로 데이터를 이동할 때의 드러그 & 드롭 조작을 관리합니다. 예를 들어, List 컨트롤이나 Flex 컨트롤의 아이템, Image 컨트롤등의 object를 선택해 다른 컴퍼넌트까지 드러그 해, 그 컴퍼넌트에 추가할 수가 있습니다.

DragManager 의 Methods와 property는 모두 정적이어서, 그 인스턴스를 작성할 필요는 없습니다.

모든 Flex 컴퍼넌트는 드러그 & 드롭 조작을 지원(support)하고 있습니다. Flex 에서는, List, Tree, 및 DataGrid 의 각 컨트롤에의 드러그 & 드롭 조작도 지원(support)하고 있습니다.

유저가 마우스로 아이템을 선택했을 경우, 선택된 컴퍼넌트를 드러그 이니씨에이터라고 부릅니다. 드러그 조작중에 표시되는 이미지를 드러그 프록시라고 부릅니다.

유저가 드러그 프록시를 다른 컴퍼넌트상으로 이동하면,dragEnter 이벤트가 그 컴퍼넌트에 보내집니다. 드러그를 받아들인 컴퍼넌트는 드롭 타겟이 되어,dragOver,dragExit, 및 dragDrop 의 각 이벤트를 받습니다.

드러그가 완료하면,dragComplete 이벤트가 드러그 이니씨에이터에게 보내집니다.

	property	정의
		constructor : Object 특정의 object 인스턴스의 클래스 object 또는 constructor　　 함수에의 참조입니다.	Object
		isDragging : Boolean [static][read-only] 드러그가 실행중의 경우는 `true` 를 돌려주는, 읽기 전용(read-only) property입니다.	DragManager
		prototype : Object [static] 클래스 또는 함수 object의 prototype object에의 참조입니다.	Object

	Methods	정의
		acceptDragDrop (target:IUIComponent ):void [static] 드러그 또는 드롭 데이터를 받아들이는 경우,`dragEnter` event 핸들러로부터 이 Methods를 호출합니다.	DragManager
		doDrag (dragInitiator:IUIComponent , dragSource:DragSource , mouseEvent:MouseEvent , dragImage:IFlexDisplayObject = null, xOffset:Number = 0, yOffset:Number = 0, imageAlpha:Number = 0.5, allowMove:Boolean = true):void [static] 드러그 & 드롭 조작을 개시합니다.	DragManager
		getFeedback ():String [static] 현재의 드러그 & 드롭 피드백을 돌려줍니다.	DragManager
		hasOwnProperty (name:String ):Boolean object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.	Object
		isPrototypeOf (theClass:Object ):Boolean Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.	Object
		propertyIsEnumerable (name:String ):Boolean 지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.	Object
		setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void 루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.	Object
		showFeedback (feedback:String ):void [static] 드러그 & 드롭 조작의 피드백 인디케이터(indicator)를 설정합니다.	DragManager
		toString ():String 지정된 object의 string 표현을 돌려줍니다.	Object
		valueOf ():Object 지정된 object의 원시적치를 돌려줍니다.	Object

설명	정의
copyCursor	형태: Class CSS 의 Inheritance: no 복사 조작중에 표시되는 커서. 디폴트치`mx.skins.cursor.DragCopy`.	DragManager
defaultDragImageSkin	형태: Class CSS 의 Inheritance: no 디폴트 드러그 이미지의 묘화에 사용되는 스킨. 드러그 프록시라고도 불립니다. 디폴트치`mx.skins.halo.DefaultDragImage`.	DragManager
linkCursor	형태: Class CSS 의 Inheritance: no 링크 조작중에 표시되는 커서. 디폴트치`mx.skins.cursor.DragLink`.	DragManager
moveCursor	형태: Class CSS 의 Inheritance: no 이동 조작중에 표시되는 커서. 디폴트치`mx.skins.cursor.DragMove`.	DragManager
rejectCursor	형태: Class CSS 의 Inheritance: no 거부 조작의 경우에 표시되는 커서. 디폴트치`mx.skins.cursor.DragReject`.	DragManager

	정수	정의
		COPY : String = "copy" [static] 드러그 액션의 타입을 "copy" 로 지정하는 정수입니다.	DragManager
		LINK : String = "link" [static] 드러그 액션의 타입을 "link" 로 지정하는 정수입니다.	DragManager
		MOVE : String = "move" [static] 드러그 액션의 타입을 "move" 로 지정하는 정수입니다.	DragManager
		NONE : String = "none" [static] 드러그 액션의 타입을 "none" 로 지정하는 정수입니다.	DragManager

property의 상세

isDragging

property

isDragging:Boolean [read-only]

드러그가 실행중의 경우는 true 를 돌려주는, 읽기 전용(read-only) property입니다.

Implements
public static function get isDragging():Boolean

Methods의 상세

acceptDragDrop

()

Methods

public static function acceptDragDrop(target:IUIComponent ):void

드러그 또는 드롭 데이터를 받아들이는 경우,dragEnter event 핸들러로부터 이 Methods를 호출합니다. 다음에 예를 나타냅니다.

DragManager.acceptDragDrop(event.target);

Parameters

target:IUIComponent — 드러그를 받아들이는 드롭 타겟.

doDrag

()

Methods

public static function doDrag(dragInitiator:IUIComponent , dragSource:DragSource , mouseEvent:MouseEvent , dragImage:IFlexDisplayObject  = null, xOffset:Number  = 0, yOffset:Number  = 0, imageAlpha:Number  = 0.5, allowMove:Boolean  = true):void

드러그 & 드롭 조작을 개시합니다.

Parameters

	`dragInitiator:IUIComponent` — 드러그를 개시하는 컴퍼넌트를 지정하는 IUIComponent 입니다.

	`dragSource:DragSource` — 드러그 되고 있는 데이터를 포함한 DragSource object입니다.

	`mouseEvent:MouseEvent` — 드러그를 개시하기 위한 마우스 정보를 포함한 MouseEvent 입니다.

	`dragImage:IFlexDisplayObject` (default = `null`) — 드러그 하는 이미지. 이 인수는 옵션입니다. 생략 했을 경우, 드러그 & 드롭 조작시에는 표준적인 드러그 직사각형이 사용됩니다. 이미지를 지정하는 경우는, 이미지의 높이와 폭을 명시적으로 설정하지 않으면 이미지가 표시되지 않습니다.

	`xOffset:Number` (default = `0`) — `dragImage` 의 x 오프셋(offset)를 픽셀 단위로 지정하는 수치입니다. 이 인수는 옵션입니다. 이것을 생략 하면, 드러그 프록시는 드러그 이니씨에이터의 좌상구석에 표시됩니다. 이 오프셋(offset)는, 드러그 프록시의 좌단으로부터 드러그 이니씨에이터의 좌단까지의 픽셀 수라고 해 나타내져 통상은 부의 수치가 됩니다.

	`yOffset:Number` (default = `0`) — `dragImage` 의 y 오프셋(offset)를 픽셀 단위로 지정하는 수치입니다. 이 인수는 옵션입니다. 이것을 생략 하면, 드러그 프록시는 드러그 이니씨에이터의 좌상구석에 표시됩니다. 이 오프셋(offset)는, 드러그 프록시의 상단으로부터 드러그 이니씨에이터의 상단까지의 픽셀 수라고 해 나타내져 통상은 부의 수치가 됩니다.

	`imageAlpha:Number` (default = `0.5`) — dragImage 에 사용되는 알파치를 지정하는 수치입니다. 이 인수는 옵션입니다. 생략 했을 경우의 디폴트의 알파치는 0.5 입니다. 값이 0.0 의 경우, 이미지는 투명한 것을 나타냅니다. 값이 1.0 의 경우, 이미지는 완전한 불투명한 것을 나타냅니다.

	`allowMove:Boolean` (default = `true`)

getFeedback

()

Methods

public static function getFeedback():String

현재의 드러그 & 드롭 피드백을 돌려줍니다.

반환값

String — 유효한 반환값은 DragManager.COPY,DragManager.MOVE,DragManager.LINK, 또는 DragManager.NONE 입니다.

showFeedback

()

Methods

public static function showFeedback(feedback:String ):void

드러그 & 드롭 조작의 피드백 인디케이터(indicator)를 설정합니다. 유효한 값은 DragManager.COPY,DragManager.MOVE,DragManager.LINK, 또는 DragManager.NONE 입니다.

Parameters

feedback:String — 표시하는 피드백 인디케이터(indicator)의 타입.

정수의 상세

COPY

정수

public static const COPY:String = "copy"

드러그 액션의 타입을 "copy" 로 지정하는 정수입니다.

LINK

정수

public static const LINK:String = "link"

드러그 액션의 타입을 "link" 로 지정하는 정수입니다.

MOVE

정수

public static const MOVE:String = "move"

드러그 액션의 타입을 "move" 로 지정하는 정수입니다.

NONE

정수

public static const NONE:String = "none"

드러그 액션의 타입을 "none" 로 지정하는 정수입니다.

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Class DragManager	property \| Methods \| 스타일 \| 정수