Java javax.swing 类 TransferHandler（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

javax.swing
类 TransferHandler

java.lang.Object
  javax.swing.TransferHandler

所有已实现的接口：

Serializable

---

public class TransferHandler
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
implements Serializable
   
   
   
   

此类用于处理往返于 Swing 组件的 Transferable 的传输。该 Transferable 用于表示通过往/返于剪贴板的剪切、复制或粘贴操作进行交换的数据。它还在拖放操作中使用，以表示对组件进行拖动和放置组件。Swing 提供自动支持剪切、复制和粘贴的键盘绑定的功能，该键盘绑定使用由此类的实现提供的功能。Swing 还提供自动支持拖放操作的功能，该拖放操作使用由此类的实现提供的功能。Swing 开发人员可以主要通过在 Swing 组件上设置 transferHandler 属性专门指定传输语义。

只通过指定构造方法中的属性名称即可实现此类，以提供传输某个组件属性的默认行为。例如，要通过剪贴板或拖放操作将前景色从一个组件传输到另一个组件，可以使用字符串 "foreground" 构造一个 TransferHandler。内置支持将把由 getForeground 返回的颜色用作该传输的源，把由 setForeground 返回的颜色用作传输的目标。

有关更多信息，请参阅《The Java Tutorial》中的 How to Use Drag and Drop and Data Transfer 一节。

从以下版本开始：

1.4

---

字段摘要
static int	COPY           表示“复制”传输操作的 int 值。
static int	COPY_OR_MOVE           表示“复制”或“移动”的源操作功能的 int 值。
static int	MOVE           表示“移动”传输操作的 int 值。
static int	NONE           表示无传输操作的 int 值。

 

构造方法摘要
protected	TransferHandler()           子类的便捷构造方法。
	TransferHandler(String property)           构造一个通过剪贴板或拖放操作可以将 Java Bean 属性从一个组件传输到另一个组件的传输处理程序。

 

方法摘要
boolean	canImport(JComponent comp, DataFlavor[] transferFlavors)           指示一个组件在实际尝试导入给定数据 flavor 的集合之前是否接受导入。
protected  Transferable	createTransferable(JComponent c)           创建一个要用作数据传输源的 Transferable。
void	exportAsDrag(JComponent comp, InputEvent e, int action)           导致 Swing 拖动支持的启用。
protected  void	exportDone(JComponent source, Transferable data, int action)           在导出数据之后调用。
void	exportToClipboard(JComponent comp, Clipboard clip, int action)           导致从给定组件到给定剪贴板的传输。
static Action	getCopyAction()           返回一个其行为类似“复制”操作的 Action。
static Action	getCutAction()           返回一个其行为类似“剪切”操作的 Action。
static Action	getPasteAction()           返回一个其行为类似“粘贴”操作的 Action。
int	getSourceActions(JComponent c)           返回源支持的传输操作的类型。
Icon	getVisualRepresentation(Transferable t)           返回一个建立传输外观的对象。
boolean	importData(JComponent comp, Transferable t)           导致从剪贴板或 DND 放置操作向组件的传输。

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

字段详细信息

NONE

public static final int NONE

表示无传输操作的 int 值。

另请参见：

常量字段值

---

COPY

public static final int COPY

表示“复制”传输操作的 int 值。将数据复制到剪贴板或复制到拖放操作中其他位置时使用此值。

另请参见：

常量字段值

---

MOVE

public static final int MOVE

表示“移动”传输操作的 int 值。将数据移动到剪贴板（如剪切）或移动到拖放操作中的其他位置时使用此值。

另请参见：

常量字段值

---

COPY_OR_MOVE

public static final int COPY_OR_MOVE

表示“复制”或“移动”的源操作功能的 int 值。

另请参见：

常量字段值

构造方法详细信息

TransferHandler

public TransferHandler(String property)

构造一个通过剪贴板或拖放操作可以将 Java Bean 属性从一个组件传输到另一个组件的传输处理程序。

参数：

property - 要传输的属性的名称；如果没有与该传输处理程序相关的属性（例如，执行其他某种传输的子类），则可以为 null

---

TransferHandler

protected TransferHandler()

子类的便捷构造方法。

方法详细信息

getCutAction

public static Action getCutAction()

返回一个其行为类似“剪切”操作的 Action。也就是说，将在与作为该 ActionEvent 的源 JComponent 相关的 TransferHandler 上调用具有 MOVE 参数的 exportToClipboard。

返回：

剪切操作

---

getCopyAction

public static Action getCopyAction()

返回一个其行为类似“复制”操作的 Action。也就是说，将在与作为该 ActionEvent 的源 JComponent 相关的 TransferHandler 上调用具有 COPY 参数的 exportToClipboard。

返回：

剪切操作

---

getPasteAction

public static Action getPasteAction()

返回一个其行为类似“粘贴”操作的 Action。也就是说，将在与作为该 ActionEvent 的源 JComponent 相关的 TransferHandler 上调用 importData。

返回：

剪切操作