javax.swing

Class TransferHandler.TransferSupport

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与此相关的转让