javax.swing
클래스 TransferHandler.TransferSupport

java.lang.Object 
  javax.swing.TransferHandler.TransferSupport

포함되어 있는 클래스:

TransferHandler

public static final class TransferHandler.TransferSupport
extends Object 

이 클래스에는, 클립보드에 의한 전송 또는 드래그＆드롭에 의한 전송에 관련하는 상세 정보를 모두 캡슐화하는 기능과 드래그＆드롭 조작을 커스터마이즈 하는 기능이 있습니다.

이 클래스의 주된 목적은, 개발자가, 캡슐화된 데이터의 전송 또는 임포트가 적절한가 어떤가를 판단하기 위해서(때문에) 필요한 정보를 제공하는 점에 있습니다. 또, 이 클래스는, 드래그＆드롭중에 프로퍼티 (드롭 위치를 표시할지 어떨지, 어느 드롭 액션을 사용할까 등)을 커스터마이즈 하는 콘트롤러라고 해도 기능합니다.

일반적으로, 개발자는, 이 클래스의 인스턴스를 작성할 필요는 없습니다. 대신에, DnD 구현에 의해,TransferHandler 내에 몇개의 메소드가 제공되고 있습니다.

도입된 버젼:

1.6

관련 항목:

TransferHandler.canImport(TransferHandler.TransferSupport) , TransferHandler.importData(TransferHandler.TransferSupport)

생성자 의 개요

TransferHandler.TransferSupport (Component component, Transferable transferable)
지정의 컴퍼넌트 및 Transferable 에 대해서,isDrop() 의 값을 false 로 설정해 TransferSupport 를 작성합니다.

메소드의 개요

Component	getComponent () 이 전송의 타겟 컴퍼넌트를 돌려줍니다.
DataFlavor []	getDataFlavors () 이 전송의 데이타후레이바를 돌려줍니다.
int	getDropAction () 이 TransferSupport 가 드롭을 나타낼 때, 그 드롭의 선택 액션을 돌려줍니다.
TransferHandler.DropLocation	getDropLocation () 이 TransferSupport 가 드롭을 나타낼 때, 컴퍼넌트의 현재의 드롭 위치 (null 이외)를 돌려줍니다.
int	getSourceDropActions () 이 TransferSupport 가 드롭을 나타낼 때, 드래그 소스의 지원되고 있는 드롭 액션을 돌려줍니다.
Transferable	getTransferable () 이 전송에 관련한 Transferable 를 돌려줍니다.
int	getUserDropAction () 이 TransferSupport 가 드롭을 나타낼 때, 그 드롭의 사용자 드롭 액션을 돌려줍니다.
boolean	isDataFlavorSupported (DataFlavor df) 지정의 데이타후레이바가 지원되고 있는지 어떤지를 돌려줍니다.
boolean	isDrop () 이 TransferSupport 가 드롭 조작을 나타내고 있는지 어떤지를 돌려줍니다.
void	setDropAction (int dropAction) 전송의 드롭 액션 (드롭을 나타낼 필요가 있다)으로서 디폴트의 사용자 드롭 액션은 아니고, 지정의 액션을 설정합니다.
void	setShowDropLocation (boolean showDropLocation) 드롭을 나타내는 전송에 대해서, 드롭 위치를 시각적으로 가리킬지 어떨지를 설정합니다.

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자 의 상세

TransferHandler.TransferSupport

public TransferHandler.TransferSupport(Component  component,
                                       Transferable  transferable)

지정의 컴퍼넌트 및 Transferable 에 대해서,isDrop() 의 값을 false 로 설정해 TransferSupport 를 작성합니다.

파라미터:

component - 타겟 컴퍼넌트

transferable - 전송 가능 객체

예외:

NullPointerException - 어느 쪽인가의 파라미터가 null 의 경우

메소드의 상세

isDrop

public boolean isDrop()

이 TransferSupport 가 드롭 조작을 나타내고 있는지 어떤지를 돌려줍니다.

반환값:

이것이 드롭 조작인 경우는 true, 그렇지 않은 경우는 false

getComponent

public Component  getComponent()

이 전송의 타겟 컴퍼넌트를 돌려줍니다.

반환값:

타겟 컴퍼넌트

getDropLocation

public TransferHandler.DropLocation  getDropLocation()

이 TransferSupport 가 드롭을 나타낼 때, 컴퍼넌트의 현재의 드롭 위치 (null 이외)를 돌려줍니다.

주:드롭 지원가 짜넣어지고 있는 컴퍼넌트의 경우, 이 정도치는 컴퍼넌트의 getDropLocation 메소드에 의해 반환되는 것과 같은 종류의 DropLocation 의 서브 클래스가 됩니다.

이 메소드는, 드래그＆드롭 전송으로 밖에 사용하지 않습니다. isDrop() 가 false 때에 호출하면(자),IllegalStateException 가 throw 됩니다.

반환값:

드롭 위치

예외:

IllegalStateException - 이것이 드롭이 아닌 경우

관련 항목:

isDrop

setShowDropLocation

public void setShowDropLocation(boolean showDropLocation)

드롭을 나타내는 전송에 대해서, 드롭 위치를 시각적으로 가리킬지 어떨지를 설정합니다. 이 설정은, 드래그＆드롭 조작중에, 적절하면 드롭 위치를 자동적으로 표시하는 컴퍼넌트에 적용됩니다. 디폴트에서는, 드롭 위치는,TransferHandler 가 이 TransferSupport 에 의해 나타내지는 임포트를 받아들일 수가 있는 경우에게만 표시됩니다. 이 메소드에 의해, 드롭 위치를 항상 표시 또는 항상 비표시로 할 수 있습니다.

이 메소드는, 드래그＆드롭 전송으로 밖에 사용하지 않습니다. isDrop() 가 false 때에 호출하면(자),IllegalStateException 가 throw 됩니다.

파라미터:

showDropLocation - 드롭 위치를 나타낼지 어떨지

예외:

IllegalStateException - 이것이 드롭이 아닌 경우

관련 항목:

isDrop

setDropAction

public void setDropAction(int dropAction)

전송의 드롭 액션 (드롭을 나타낼 필요가 있다)으로서 디폴트의 사용자 드롭 액션은 아니고, 지정의 액션을 설정합니다. 이 액션은, 소스의 드롭 액션으로 지원되고 있는 액션으로,COPY,MOVE, 또는 LINK 의 어떤 것인가 한데 합칠 필요가 있습니다.

이 메소드는, 드래그＆드롭 전송으로 밖에 사용하지 않습니다. isDrop() 가 false 때에 호출하면(자),IllegalStateException 가 throw 됩니다.

파라미터:

dropAction - 드롭 액션

예외:

IllegalStateException - 이것이 드롭이 아닌 경우

IllegalArgumentException - 무효인 액션이 지정되었을 경우

관련 항목:

getDropAction() , getUserDropAction() , getSourceDropActions() , isDrop

getDropAction

public int getDropAction()

이 TransferSupport 가 드롭을 나타낼 때, 그 드롭의 선택 액션을 돌려줍니다.

setDropAction 를 사용해 명시적으로 선택하지 않는 한,getUserDropAction 로 지정된 사용자 드롭 액션이 돌려주어집니다.

액션에 근거해 처리를 커스터마이즈 하려면 , TransferHandler 의 importData 메소드로 이것을 조회할 수가 있습니다.

이 메소드는, 드래그＆드롭 전송으로 밖에 사용하지 않습니다. isDrop() 가 false 때에 호출하면(자),IllegalStateException 가 throw 됩니다.

반환값:

드롭의 선택 액션

예외:

IllegalStateException - 이것이 드롭이 아닌 경우

관련 항목:

setDropAction(int) , getUserDropAction() , isDrop

getUserDropAction

public int getUserDropAction()

이 TransferSupport 가 드롭을 나타낼 때, 그 드롭의 사용자 드롭 액션을 돌려줍니다.

드롭에 대해서 사용자 드롭 액션을 선택하는 방법에 대해서는,DropTargetDragEvent 와 DropTargetDropEvent 의 문서를 참조해 주세요. setDropAction 메소드를 사용해, 다른 액션을 드롭 액션으로서 선택할 수도 있습니다.

드롭이 적절한가 어떤가를 판단할 때, 또는 드롭 액션을 명시적으로 선택할 때,TransferHandler 의 canImport 메소드로 이것을 조회할 수가 있습니다.

이 메소드는, 드래그＆드롭 전송으로 밖에 사용하지 않습니다. isDrop() 가 false 때에 호출하면(자),IllegalStateException 가 throw 됩니다.

반환값:

사용자 드롭 액션

예외:

IllegalStateException - 이것이 드롭이 아닌 경우

관련 항목:

setDropAction(int) , getDropAction() , isDrop

getSourceDropActions

public int getSourceDropActions()

이 TransferSupport 가 드롭을 나타낼 때, 드래그 소스의 지원되고 있는 드롭 액션을 돌려줍니다.

소스 액션은, 이 전송의 소스로 지원되고 있는 액션세트를 나타냅니다. 이것은,COPY,MOVE, 및 LINK 의 비트 단위의 논리합으로서 나타내집니다. 드롭이 적절한가 어떤가를 판단할 때, 또는 드롭 액션을 명시적으로 선택할 때,TransferHandler 의 canImport 메소드로 이것을 조회할 수가 있습니다. 소스가 특정의 액션을 지원할지 어떨지를 확인하려면 , 그 액션과 소스 드롭 액션의 비트 단위의 논리적을 요구해 그 결과를 원의 액션과 비교합니다. 다음에 예를 나타냅니다.

 boolean copySupported = (COPY & getSourceDropActions()) == COPY;
 

이 메소드는, 드래그＆드롭 전송으로 밖에 사용하지 않습니다. isDrop() 가 false 때에 호출하면(자),IllegalStateException 가 throw 됩니다.

반환값:

드래그 소스의 지원되고 있는 드롭 액션

예외:

IllegalStateException - 이것이 드롭이 아닌 경우

관련 항목:

isDrop

getDataFlavors

public DataFlavor [] getDataFlavors()

이 전송의 데이타후레이바를 돌려줍니다.

반환값:

이 전송의 데이타후레이바

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor  df)

지정의 데이타후레이바가 지원되고 있는지 어떤지를 돌려줍니다.

파라미터:

df - 판정 대상의 DataFlavor

반환값:

지정의 데이타후레이바가 지원되고 있는지 어떤지

getTransferable

public Transferable  getTransferable()

이 전송에 관련한 Transferable 를 돌려줍니다.

주:Transferable 를 직접 취득할 필요가 있는 경우 이외는, 이 클래스상에서 그 외의 메소드중1개(살)을 실행해, 전송에 관한 정보를 조회합니다. 이 방법 쪽이,Transferable 를 취득해 직접 요구하는 방법보다 퍼포먼스면에서 우수한 일이 있습니다.

반환값:

이 전송에 관련한 Transferable