JavaTM Platform
Standard Ed. 6

java.awt.dnd
클래스 DragSourceDragEvent

java.lang.Object 
  상위를 확장 java.util.EventObject 
      상위를 확장 java.awt.dnd.DragSourceEvent 
          상위를 확장 java.awt.dnd.DragSourceDragEvent
모든 구현된 인터페이스:
Serializable


public class DragSourceDragEvent
extends DragSourceEvent

DragSourceDragEvent 는,DragSourceContextPeer 로부터 DragSourceContext 를 개입시켜,DragSourceContext 및 거기에 관련하는 DragSource 로 등록된 DragSourceListener 에 보내집니다.  

DragSourceDragEvent 는, 드래그 조작의 현재 상태를 반영한 「타겟 드롭 액션」과「사용자 드롭 액션」을 통지합니다.  

「타겟 드롭 액션」은, 현재의 드롭 타겟으로 선택된 드롭 액션이 드래그 소스로 지원되고 있는 경우, 그 드롭 액션을 나타내는 DnDConstants 의 1 개입니다. 그 드롭 액션이 드래그 소스로 지원되어 있지 않은 경우는,DnDConstants.ACTION_NONE 입니다.  

「사용자 드롭 액션」은, 드래그 소스로 지원되는 드롭 액션과 사용자가 선택한 드롭 액션에 따라서 다릅니다. 사용자는, 드래그 조작중에 수식 키를 누르는 것으로, 드롭 액션을 선택할 수 있습니다.

   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE
 
사용자가 드롭 액션을 선택했을 경우, 「사용자 드롭 액션」은, 선택된 드롭 액션이 드래그 소스로 지원되고 있으면, 그 드롭 액션을 나타내는 DnDConstants 의 1 개입니다. 그 드롭 액션이 드래그 소스로 지원되어 있지 않으면,DnDConstants.ACTION_NONE 입니다.  

사용자가 드롭 액션을 선택하지 않는 경우는, 드래그 소스로 지원되고 있는 일련의 드롭 액션을 나타내는 DnDConstants 세트로 DnDConstants.ACTION_MOVE,DnDConstants.ACTION_COPY,DnDConstants.ACTION_LINK 가 순서에 검색되어 「사용자 드롭 액션」은 최초로 발견되는 정수가 됩니다. 정수가 발견되지 않는 경우, 「사용자 드롭 액션」은 DnDConstants.ACTION_NONE 가 됩니다.

도입된 버젼:
1.2
관련 항목:
직렬화 된 형식

필드의 개요
 
클래스 java.util. EventObject 로부터 상속된 필드
source
 
생성자 의 개요
DragSourceDragEvent (DragSourceContext  dsc, int dropAction, int action, int modifiers)
          DragSourceDragEvent 를 구축합니다.
DragSourceDragEvent (DragSourceContext  dsc, int dropAction, int action, int modifiers, int x, int y)
          DragSourceDragEvent 를 구축해, 지정된 DragSourceContext, 사용자 드롭 액션, 타겟 드롭 액션, 수식자, 및 좌표를 지정합니다.
 
메소드의 개요
 int getDropAction ()
          이 메소드는, 타겟 드롭 액션, 및 드래그 소스로 지원되는 일련의 드롭 액션의 논리적을 돌려줍니다.
 int getGestureModifiers ()
          이 메소드는, 사용자의 제스처(gesture)에 관련한 입력 디바이스 수식자의 현재 상태를 나타내는 int 를 돌려줍니다.
 int getGestureModifiersEx ()
          이 메소드는, 사용자의 제스처(gesture)에 관련한 입력 디바이스의 확장된 수식자의 현재 상태를 나타내는 int 를 돌려줍니다.
 int getTargetActions ()
          이 메소드는, 타겟 드롭 액션을 돌려줍니다.
 int getUserAction ()
          이 메소드는, 사용자 드롭 액션을 돌려줍니다.
 
클래스 java.awt.dnd. DragSourceEvent 로부터 상속된 메소드
getDragSourceContext , getLocation , getX , getY
 
클래스 java.util. EventObject 로부터 상속된 메소드
getSource , toString
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext  dsc,
                           int dropAction,
                           int action,
                           int modifiers)
DragSourceDragEvent 를 구축합니다. 이 클래스는, 일반적으로, 클라이언트의 코드로부터 직접은 아니고,DragSourceContextPeer 에 의해 인스턴스가 생성됩니다. 이 DragSourceDragEvent 의 좌표는 지정되지 않기 때문에,getLocation 는 이 이벤트에 대해서 null 를 돌려줍니다.  

인수 dropActionaction 는 단일의 액션을 나타내는 DnDConstants 의 어떤 것인가로 할 필요가 있습니다. 인수 modifiers 는 낡은 java.awt.event.InputEvent. *_MASK 정수의 비트 단위의 마스크인가, 확장된 java.awt.event.InputEvent. *_DOWN_MASK 정수의 비트 단위의 마스크의 어딘가에 할 필요가 있습니다. 이 생성자 은 무효인 dropAction,action, 및 modifiers 에 대해서, 예외를 throw 하지 않습니다.

파라미터:
dsc - 이 이벤트에 대한 통지를 관리하기 위한 DragSourceContext
dropAction - 사용자 드롭 액션
action - 타겟 드롭 액션
modifiers - 이벤트 발생시에 밀린 수식 키 (Shift, Ctrl, Alt, 메타 등). 확장된 _DOWN_MASK 또는 이전의 _MASK 수식자의 어느쪽이든을 사용할 필요가 있다. 다만, 양쪽 모두의 모델을 1 개의 이벤트에 혼합해서는 안 된다. 확장 수식자의 사용이 바람직하다
예외:
IllegalArgumentException - dscnull 의 경우
관련 항목:
InputEvent , DragSourceEvent.getLocation()

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext  dsc,
                           int dropAction,
                           int action,
                           int modifiers,
                           int x,
                           int y)
DragSourceDragEvent 를 구축해, 지정된 DragSourceContext, 사용자 드롭 액션, 타겟 드롭 액션, 수식자, 및 좌표를 지정합니다.  

인수 dropActionaction 는 단일의 액션을 나타내는 DnDConstants 의 어떤 것인가로 할 필요가 있습니다. 인수 modifiers 는 낡은 java.awt.event.InputEvent. *_MASK 정수의 비트 단위의 마스크인가, 확장된 java.awt.event.InputEvent. *_DOWN_MASK 정수의 비트 단위의 마스크의 어딘가에 할 필요가 있습니다. 이 생성자 은 무효인 dropAction,action, 및 modifiers 에 대해서, 예외를 throw 하지 않습니다.

파라미터:
dsc - 이 이벤트에 관련했다 DragSourceContext
dropAction - 사용자 드롭 액션
action - 타겟 드롭 액션
modifiers - 이벤트 발생시에 밀린 수식 키 (Shift, Ctrl, Alt, 메타 등). 확장된 _DOWN_MASK 또는 이전의 _MASK 수식자의 어느쪽이든을 사용할 필요가 있다. 다만, 양쪽 모두의 모델을 1 개의 이벤트에 혼합해서는 안 된다. 확장 수식자의 사용이 바람직한
x - 커서 위치의 수평 좌표
y - 커서 위치의 수직 좌표
예외:
IllegalArgumentException - dscnull 의 경우
도입된 버젼:
1.4
관련 항목:
InputEvent
메소드의 상세

getTargetActions

public int getTargetActions()
이 메소드는, 타겟 드롭 액션을 돌려줍니다.

반환값:
타겟 드롭 액션

getGestureModifiers

public int getGestureModifiers()
이 메소드는, 사용자의 제스처(gesture)에 관련한 입력 디바이스 수식자의 현재 상태를 나타내는 int 를 돌려줍니다. 일반적으로, 이것들은 mouse button 또는 키보드 수식자가 됩니다.  

생성자 에게 건네진 modifiers 가 무효인 경우, 이 메소드는 그것들을 변경하지 않고 돌려줍니다.

반환값:
입력 디바이스 수식자의 현재 상태

getGestureModifiersEx

public int getGestureModifiersEx()
이 메소드는, 사용자의 제스처(gesture)에 관련한 입력 디바이스의 확장된 수식자의 현재 상태를 나타내는 int 를 돌려줍니다. InputEvent.getModifiersEx() 를 참조해 주세요.  

생성자 에게 건네진 modifiers 가 무효인 경우, 이 메소드는 그것들을 변경하지 않고 돌려줍니다.

반환값:
입력 디바이스의 확장된 수식자의 현재 상태
도입된 버젼:
1.4

getUserAction

public int getUserAction()
이 메소드는, 사용자 드롭 액션을 돌려줍니다.

반환값:
사용자 드롭 액션

getDropAction

public int getDropAction()
이 메소드는, 타겟 드롭 액션, 및 드래그 소스로 지원되는 일련의 드롭 액션의 논리적을 돌려줍니다.

반환값:
타겟 드롭 액션, 및 드래그 소스로 지원되는 일련의 드롭 액션의 논리적

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.