[page:EventDispatcher] →

# [name]

해당 클래스는 드래그 앤 드롭 상호작용에 대해 사용 됩니다.

## 수입

[name] 는 애드온이며 명시적으로 가져와야 합니다. See [link:#manual/introduction/Installation Installation / Addons].

`import { DragControls } from 'three/addons/controls/DragControls.js';`

## 코드 예시

`const controls = new DragControls( objects, camera, renderer.domElement ); // 이벤트 리스너에 드래그 될 대상을 추가합니다. controls.addEventListener( 'dragstart', function ( event ) { event.object.material.emissive.set( 0xaaaaaa ); } ); controls.addEventListener( 'dragend', function ( event ) { event.object.material.emissive.set( 0x000000 ); } );`

## 예시

[example:misc_controls_drag misc / controls / drag ]

## 생성자

### [name]( [param:Array objects], [param:Camera camera], [param:HTMLDOMElement domElement] )

[page:Array objects]: 드래그 가능한 3D 객체의 배열 입니다.

[page:Camera camera]: 렌더링 된 장면의 카메라입니다.

[page:HTMLDOMElement domElement]: 이벤트 리스너에 사용되는 HTML 엘리먼트입니다.

새로운 [name] 객체를 생성합니다.

## 이벤트

### dragstart

사용자가 3D 객체를 첫번째로 드래그 할 경우 호출 됩니다.

### drag

사용자가 3D 객체를 드래그 할 경우 호출 됩니다.

### dragend

사용자가 3D 객체를 드래그를 완료하면 호출 됩니다.

### hoveron

마우스 포인터가 3D 객체 위에 오거나, 자식 객체 위에 올 경우 호출 됩니다.

### hoveroff

포인터가 3D 객체 밖으로 이동할 경우 호출 됩니다.

## 속성

### [property:Boolean enabled]

컨트롤의 활성화 여부를 지정합니다.

### [property:Boolean transformGroup]

해당 속성은 [page:DragControls.objects] 배열에 드래그 가능한 단일 그룹 객체가 포함된 경우에만 작동합니다. *true* 값으로 설정 되어있다면, [name]은 개별 객체가 아닌 전체 그룹은 드래그 합니다. 기본 값은 *false* 입니다.

### [property:String mode]

The current transformation mode. Possible values are `translate`, and `rotate`. Default is `translate`.

## 메소드

일반적인 메소드는 [page:EventDispatcher] 클래스를 참조하세요.

### [method:undefined activate] ()

컨트롤에 이벤트 리스너를 추가합니다.

### [method:undefined deactivate] ()

컨트롤에 추가된 이벤트 리스너를 제거합니다.

### [method:undefined dispose] ()

컨트롤이 더 이상 필요하지 않을 경우 호출해야 합니다.

### [method:Array getObjects] ()

드래그 가능한 객체 배열을 반환 합니다.

### [method:Raycaster getRaycaster] ()

Returns the internal [page:Raycaster] instance that is used for intersection tests.

### [method:undefined setObjects] ( [param:Array objects] )

Sets an array of draggable objects by overwriting the existing one.

## Source

[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/DragControls.js examples/jsm/controls/DragControls.js]