TransferHandler.TransferSupport (Java Platform SE 8 )

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

Enclosing class:

TransferHandler
```
public static final class TransferHandler.TransferSupport
extends Object
```
该类封装了剪贴板的所有相关细节或拖放传输，还允许自定义拖放体验的方面。
此类的主要目的是提供开发人员所需的信息，以确定转移的适用性或导入其中包含的数据。但是，它也可以在拖放过程中自定义属性的控制器，例如是否显示放置位置，以及要使用的放置操作。

开发人员通常不需要创建此类的实例。相反，它们是由DnD的实施提供了一定的方法的东西TransferHandler 。

从以下版本开始：

1.6

另请参见：

TransferHandler.canImport(TransferHandler.TransferSupport) ， TransferHandler.importData(TransferHandler.TransferSupport)

构造方法摘要

构造方法
Constructor and Description
`TransferSupport(Component component, Transferable transferable)` 创建一个 `TransferSupport`与 `isDrop()` `false`为给定的组件和 `Transferable` 。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Component`	`getComponent()` 返回此传输的目标组件。
`DataFlavor[]`	`getDataFlavors()` 返回此传输的数据风格。
`int`	`getDropAction()` 返回为下降选择的动作，当此 `TransferSupport`代表下降。
`TransferHandler.DropLocation`	`getDropLocation()` 返回当前（非 `null` ）为组件，当此放置位置 `TransferSupport`表示的下降。
`int`	`getSourceDropActions()` 当这个 `TransferSupport`代表一个下降时，返回拖动源支持的放置操作。
`Transferable`	`getTransferable()` 返回与此转移相关 `Transferable` Transferable。
`int`	`getUserDropAction()` 当这个 `TransferSupport`代表一个drop时，返回drop的用户drop操作。
`boolean`	`isDataFlavorSupported(DataFlavor df)` 返回是否支持给定的数据风格。
`boolean`	`isDrop()` 返回此 `TransferSupport`是否代表放置操作。
`void`	`setDropAction(int dropAction)` 将传输的放置操作设置为给定操作，而不是默认的用户放置操作。
`void`	`setShowDropLocation(boolean showDropLocation)` 设置丢弃位置是否应在视觉上指定用于传输 - 这必须代表一个丢弃。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - TransferSupport
```
public TransferSupport(Component component,
                       Transferable transferable)
```
    创建 TransferSupport与 isDrop() false给定组件和 Transferable 。
    
    参数
    
    component - 目标组件
    
    transferable - 可转让
    
    异常
    
    NullPointerException - 如果任一参数是 null
- 方法详细信息
  - isDrop
```
public boolean isDrop()
```
    返回此 TransferSupport是否代表放置操作。
    
    结果
    
    true如果这是一个drop操作， false否则。
  - getComponent
```
public Component getComponent()
```
    返回此传输的目标组件。
    
    结果
    
    目标组件
  - getDropLocation
```
public TransferHandler.DropLocation getDropLocation()
```
    返回当前（非null ）为组件，当此放置位置TransferSupport表示的下降。
    注意：对于具有内置drop支持的DropLocation ，该位置将是该组件的getDropLocation方法返回的同一类型的DropLocation的子类。
    
    此方法仅适用于拖放传输。当isDrop()是false时调用它，结果是一个IllegalStateException 。
    
    结果
    
    下降位置
    
    异常
    
    IllegalStateException - 如果这不是一个下降
    
    另请参见：
    
    isDrop()
  - setShowDropLocation
```
public void setShowDropLocation(boolean showDropLocation)
```
    设置丢弃位置是否应在视觉上指定用于传输 - 这必须代表一个丢弃。这适用于在拖放操作期间适当时自动显示放置位置的组件）。默认情况下，只有当TransferHandler表示可以接受此TransferSupport表示的导入时， TransferHandler显示该放置位置。使用此方法，您可以强制放置位置始终显示，或始终不显示。
    此方法仅适用于拖放传输。当isDrop()是false结果是IllegalStateException 。
    
    参数
    
    showDropLocation - 是否指示放置位置
    
    异常
    
    IllegalStateException - 如果这不是一滴
    
    另请参见：
    
    isDrop()
  - setDropAction
```
public void setDropAction(int dropAction)
```
    将传输的放置操作设置为给定操作，而不是默认的用户放置操作。该行动必须由源的放置动作的支持，并且必须是一个COPY ， MOVE或LINK 。
    此方法仅适用于拖放传输。当isDrop() false于isDrop()时，结果是IllegalStateException 。
    
    参数
    
    dropAction - 放行动
    
    异常
    
    IllegalStateException - 如果这不是下降
    
    IllegalArgumentException - 如果指定了无效操作
    
    另请参见：
    
    getDropAction() ， getUserDropAction() ， getSourceDropActions() ， isDrop()
  - getDropAction
```
public int getDropAction()
```
    返回为drop所选择的操作，当此TransferSupport代表一个下降。
    除非明确的方式选择setDropAction ，这将返回所提供的用户放置动作getUserDropAction 。
    
    您可以在TransferHandler的importData方法中查询，以根据操作自定义处理。
    
    此方法仅适用于拖放传输。当isDrop()为false时， isDrop() IllegalStateException 。
    
    结果
    
    为下降选择的动作
    
    异常
    
    IllegalStateException - 如果这不是一滴
    
    另请参见：
    
    setDropAction(int) ， getUserDropAction() ， isDrop()
  - getUserDropAction
```
public int getUserDropAction()
```
    当这个TransferSupport代表一个下降时，返回drop的用户drop操作。
    按照DropTargetDragEvent和DropTargetDropEvent的说明文件所述，删除用户删除操作。可以通过setDropAction方法选择不同的动作作为放置动作。
    
    您可能希望在TransferHandler的canImport方法中查询这一点，当确定一个drop的适用性或者在决定一个drop action来明确选择时。
    
    此方法仅适用于拖放传输。调用它时isDrop()是false导致一个IllegalStateException 。
    
    结果
    
    用户放下动作
    
    异常
    
    IllegalStateException - 如果这不是一滴
    
    另请参见：
    
    setDropAction(int) ， getDropAction() ， isDrop()
  - getSourceDropActions
```
public int getSourceDropActions()
```
    当这个TransferSupport代表一个下降时，返回拖动源支持的放置操作。
    源操作表示该集合由该传送源支持的动作，和被表示为一些按位或组合的COPY ， MOVE和LINK 。您可能希望在TransferHandler的canImport方法中查询这一点，以TransferHandler掉落的适用性或决定明确选择的放置操作时。要确定源是否支持特定操作，按位和与源放置操作的操作，然后将结果与原始操作进行比较。例如：
```
  boolean copySupported = (COPY & getSourceDropActions()) == COPY; 
```
    此方法仅适用于拖放传输。当isDrop()是false结果是IllegalStateException 。
    结果
    
    拖动源支持的放置操作
    
    异常
    
    IllegalStateException - 如果这不是下降
    
    另请参见：
    
    isDrop()
  - getDataFlavors
```
public DataFlavor[] getDataFlavors()
```
    返回此传输的数据风格。
    
    结果
    
    这种传输的数据风格
  - isDataFlavorSupported
```
public boolean isDataFlavorSupported(DataFlavor df)
```
    返回是否支持给定的数据风格。
    
    参数
    
    df - DataFlavor要测试
    
    结果
    
    是否支持给定的味道。
  - getTransferable
```
public Transferable getTransferable()
```
    返回与此转移相关Transferable Transferable。
    注意：除非有Transferable直接提取Transferable ，否则请使用本课程中的其他方法之一查询转移。这可能会比获取Transferable并直接询问更好。
    
    结果
    
    该 Transferable与此相关的转让

Class TransferHandler.TransferSupport

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

TransferSupport

方法详细信息

isDrop

getComponent

getDropLocation

setShowDropLocation

setDropAction

getDropAction

getUserDropAction

getSourceDropActions

getDataFlavors

isDataFlavorSupported

getTransferable