uTools-Manuals/docs/java/javax/swing/TransferHandler.html

903 lines
44 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.swing
</div>
<h2 class="title" title="Class TransferHandler">Class TransferHandler</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>javax.swing.TransferHandler</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../java/io/Serializable.html" title="java.io中的接口">Serializable</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">TransferHandler</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../java/io/Serializable.html" title="interface in java.io">Serializable</a></pre>
<div class="block">
<span>该类用于处理<code>Transferable</code>到Swing组件的传输。</span>
<span><code>Transferable</code>用于表示通过剪切,复制或粘贴到剪贴板进行交换的数据。</span>
<span>它也用于拖放操作以表示从组件拖动,并将其拖放到组件。</span>
<span>Swing提供了自动支持使用此类实现提供的功能的剪切复制和粘贴键盘绑定的功能。</span>
<span>Swing还提供了自动支持使用此类实现提供的功能的拖放功能。</span>
<span>Swing开发人员可以专注于通过在Swing组件上设置<code>transferHandler</code>属性来指定传输的语义。</span>
<p> <span>该类被实现为通过在构造函数中指定属性的名称来提供传递组件属性的默认行为。</span> <span>例如,要通过剪贴板或拖放操作将前景颜色从一个组件传输到另一个<code>TransferHandler</code> 可以使用字符串“foreground”构建TransferHandler。</span> <span>内置的支持将使用<code>getForeground</code>返回的<code>getForeground</code>作为转移的来源,而转移目标为<code>setForeground</code></span> </p>
<p> <span>有关详细<a href="http://docs.oracle.com/javase/tutorial/uiswing/dnd/index.html">信息</a> ,请参阅<em>Java教程</em>中的How to Use Drag and Drop and Data Transfer部分。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.4
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== NESTED CLASS SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="nested.class.summary">
<!-- --> </a> <h3>Nested Class Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Nested Class Summary table, listing nested classes, and an explanation">
<caption>
<span>Nested Classes</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Class and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static class </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.DropLocation.html" title="class in javax.swing">TransferHandler.DropLocation</a></span></code>
<div class="block">
表示应插入丢弃数据的位置。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static class </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.TransferSupport.html" title="class in javax.swing">TransferHandler.TransferSupport</a></span></code>
<div class="block">
该类封装了剪贴板的所有相关细节或拖放传输,还允许自定义拖放体验的方面。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#COPY">COPY</a></span></code>
<div class="block">
<code>int</code> “复制”转移动作的int。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#COPY_OR_MOVE">COPY_OR_MOVE</a></span></code>
<div class="block">
<code>int</code> “复制”或“移动”的源操作能力的int。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#LINK">LINK</a></span></code>
<div class="block">
一个
<code>int</code>代表一个“链接”转移动作。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#MOVE">MOVE</a></span></code>
<div class="block">
<code>int</code> “移动”转移动作的int。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#NONE">NONE</a></span></code>
<div class="block">
一个
<code>int</code>不表示转移动作。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier</th>
<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#TransferHandler--">TransferHandler</a></span>()</code>
<div class="block">
子类的便利构造函数。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#TransferHandler-java.lang.String-">TransferHandler</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> property)</code>
<div class="block">
构造一个可以通过剪贴板或拖放操作将Java Bean属性从一个组件传输到另一个组件的传输处理程序。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t1"><span><a href="javascript:show(1);">静态方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#canImport-javax.swing.JComponent-java.awt.datatransfer.DataFlavor:A-">canImport</a></span>(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> comp, <a href="../../java/awt/datatransfer/DataFlavor.html" title="class in java.awt.datatransfer">DataFlavor</a>[] transferFlavors)</code>
<div class="block">
指示组件是否将在实际尝试导入之前接受给定的一组数据风格的导入。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#canImport-javax.swing.TransferHandler.TransferSupport-">canImport</a></span>(<a href="../../javax/swing/TransferHandler.TransferSupport.html" title="class in javax.swing">TransferHandler.TransferSupport</a> support)</code>
<div class="block">
<span>这种方法在拖放操作期间重复调用,以允许开发人员配置属性并返回传输的可接受性;</span>
<span>具有一个返回值<code>true</code>表示由所述给定表示的转移<code>TransferSupport</code> (包含所有的传送的细节)是可以接受的,在当前时间,和的值<code>false</code>拒绝传输。</span>
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>protected <a href="../../java/awt/datatransfer/Transferable.html" title="interface in java.awt.datatransfer">Transferable</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#createTransferable-javax.swing.JComponent-">createTransferable</a></span>(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> c)</code>
<div class="block">
创建一个
<code>Transferable</code>作为数据传输的来源。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#exportAsDrag-javax.swing.JComponent-java.awt.event.InputEvent-int-">exportAsDrag</a></span>(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> comp, <a href="../../java/awt/event/InputEvent.html" title="class in java.awt.event">InputEvent</a> e, int action)</code>
<div class="block">
导致启动Swing拖动支持。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#exportDone-javax.swing.JComponent-java.awt.datatransfer.Transferable-int-">exportDone</a></span>(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> source, <a href="../../java/awt/datatransfer/Transferable.html" title="interface in java.awt.datatransfer">Transferable</a> data, int action)</code>
<div class="block">
数据导出后调用。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#exportToClipboard-javax.swing.JComponent-java.awt.datatransfer.Clipboard-int-">exportToClipboard</a></span>(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> comp, <a href="../../java/awt/datatransfer/Clipboard.html" title="class in java.awt.datatransfer">Clipboard</a> clip, int action)</code>
<div class="block">
导致从给定组件转移到给定的剪贴板。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>static <a href="../../javax/swing/Action.html" title="interface in javax.swing">Action</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#getCopyAction--">getCopyAction</a></span>()</code>
<div class="block">
返回一个
<code>Action</code>执行复制操作到剪贴板。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>static <a href="../../javax/swing/Action.html" title="interface in javax.swing">Action</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#getCutAction--">getCutAction</a></span>()</code>
<div class="block">
返回一个
<code>Action</code>其执行削减操作到剪贴板。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../java/awt/Image.html" title="class in java.awt">Image</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#getDragImage--">getDragImage</a></span>()</code>
<div class="block">
返回拖动图像。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../java/awt/Point.html" title="class in java.awt">Point</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#getDragImageOffset--">getDragImageOffset</a></span>()</code>
<div class="block">
返回要拖动的图像的锚点偏移量。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>static <a href="../../javax/swing/Action.html" title="interface in javax.swing">Action</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#getPasteAction--">getPasteAction</a></span>()</code>
<div class="block">
返回从
<code>Action</code>执行粘贴操作的Action。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#getSourceActions-javax.swing.JComponent-">getSourceActions</a></span>(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> c)</code>
<div class="block">
<span>返回源的支持类型;</span>
<span>任何按位或组合<code>COPY</code> <code>MOVE</code><code>LINK</code></span>
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code><a href="../../javax/swing/Icon.html" title="interface in javax.swing">Icon</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#getVisualRepresentation-java.awt.datatransfer.Transferable-">getVisualRepresentation</a></span>(<a href="../../java/awt/datatransfer/Transferable.html" title="interface in java.awt.datatransfer">Transferable</a> t)</code>
<div class="block">
返回一个建立传输外观的对象。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#importData-javax.swing.JComponent-java.awt.datatransfer.Transferable-">importData</a></span>(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> comp, <a href="../../java/awt/datatransfer/Transferable.html" title="interface in java.awt.datatransfer">Transferable</a> t)</code>
<div class="block">
导致从剪贴板或DND丢弃操作传输到组件。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#importData-javax.swing.TransferHandler.TransferSupport-">importData</a></span>(<a href="../../javax/swing/TransferHandler.TransferSupport.html" title="class in javax.swing">TransferHandler.TransferSupport</a> support)</code>
<div class="block">
导致从剪贴板或拖放操作发生转移。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#setDragImage-java.awt.Image-">setDragImage</a></span>(<a href="../../java/awt/Image.html" title="class in java.awt">Image</a> img)</code>
<div class="block">
设置拖动图像参数。
</div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/TransferHandler.html#setDragImageOffset-java.awt.Point-">setDragImageOffset</a></span>(<a href="../../java/awt/Point.html" title="class in java.awt">Point</a> p)</code>
<div class="block">
设置要拖动的图像的锚点偏移量。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../java/lang/Object.html#clone--">clone</a>, <a href="../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../java/lang/Object.html#notify--">notify</a>, <a href="../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../java/lang/Object.html#toString--">toString</a>, <a href="../../java/lang/Object.html#wait--">wait</a>, <a href="../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="NONE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>NONE</h4> <pre>public static final int NONE</pre>
<div class="block">
<code>int</code>代表无转移动作。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.swing.TransferHandler.NONE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="COPY">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>COPY</h4> <pre>public static final int COPY</pre>
<div class="block">
<span><code>int</code> “复制”转移动作的int。</span>
<span>当数据复制到剪贴板或在拖放操作中复制到别处时,将使用此值。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.swing.TransferHandler.COPY">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="MOVE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>MOVE</h4> <pre>public static final int MOVE</pre>
<div class="block">
<span><code>int</code> “移动”转移动作的int。</span>
<span>当数据移动到剪贴板(即剪切)或在拖放操作中移动到其他位置时,将使用此值。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.swing.TransferHandler.MOVE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="COPY_OR_MOVE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>COPY_OR_MOVE</h4> <pre>public static final int COPY_OR_MOVE</pre>
<div class="block">
<code>int</code> “复制”或“移动”的源操作能力的int。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../constant-values.html#javax.swing.TransferHandler.COPY_OR_MOVE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="LINK">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>LINK</h4> <pre>public static final int LINK</pre>
<div class="block">
<span><code>int</code> “链接”转移动作的int。</span>
<span>该值用于指定数据应该在拖放操作中链接。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.6
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../java/awt/dnd/DnDConstants.html#ACTION_LINK"><code>DnDConstants.ACTION_LINK</code></a>
<a href="../../constant-values.html#javax.swing.TransferHandler.LINK">Constant Field Values</a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="TransferHandler-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>TransferHandler</h4> <pre>public TransferHandler(<a href="../../java/lang/String.html" title="class in java.lang">String</a> property)</pre>
<div class="block">
构造一个可以通过剪贴板或拖放操作将Java Bean属性从一个组件传输到另一个组件的传输处理程序。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>property</code> - 要转让的财产的名称;</span>
<span>这可以是<code>null</code>如果没有与传输处理程序相关联的属性(例如执行某种其他类型的传输的子类)</span>
</dd>
</dl> </li>
</ul> <a name="TransferHandler--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>TransferHandler</h4> <pre>protected TransferHandler()</pre>
<div class="block">
子类的便利构造函数。
</div> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getCutAction--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCutAction</h4> <pre>public static <a href="../../javax/swing/Action.html" title="interface in javax.swing">Action</a> getCutAction()</pre>
<div class="block">
<span>返回一个<code>Action</code>其执行削减操作到剪贴板。</span>
<span>当执行时,这个动作在操作<code>JComponent</code>所述的源<code>ActionEvent</code>通过调用<code>exportToClipboard</code> ,具有<code>MOVE</code>动作,对组件的<code>TransferHandler</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>Action</code>进行削减到剪贴板
</dd>
</dl> </li>
</ul> <a name="getCopyAction--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCopyAction</h4> <pre>public static <a href="../../javax/swing/Action.html" title="interface in javax.swing">Action</a> getCopyAction()</pre>
<div class="block">
<span>返回一个<code>Action</code>执行复制操作到剪贴板。</span>
<span>当执行时,这个动作在操作<code>JComponent</code>所述的源<code>ActionEvent</code>通过调用<code>exportToClipboard</code> ,具有<code>COPY</code>动作,对组件的<code>TransferHandler</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>Action</code>用于执行副本到剪贴板
</dd>
</dl> </li>
</ul> <a name="getPasteAction--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPasteAction</h4> <pre>public static <a href="../../javax/swing/Action.html" title="interface in javax.swing">Action</a> getPasteAction()</pre>
<div class="block">
<span>返回从<code>Action</code>执行粘贴操作的Action。</span>
<span>当执行时,这个动作在操作<code>JComponent</code>的来源<code>ActionEvent</code>通过调用<code>importData</code> ,与剪贴板中的内容,对组件的<code>TransferHandler</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>Action</code>从剪贴板执行糊剂
</dd>
</dl> </li>
</ul> <a name="setDragImage-java.awt.Image-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDragImage</h4> <pre>public void setDragImage(<a href="../../java/awt/Image.html" title="class in java.awt">Image</a> img)</pre>
<div class="block">
<span>设置拖动图像参数。</span>
<span>该图像必须准备好在通话时刻渲染。</span>
<span>由于某些性能原因,图像由参考存储。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>img</code> - 要拖动的图像
</dd>
</dl> </li>
</ul> <a name="getDragImage--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDragImage</h4> <pre>public <a href="../../java/awt/Image.html" title="class in java.awt">Image</a> getDragImage()</pre>
<div class="block">
<span>返回拖动图像。</span>
<span>如果没有图像拖动,返回值为<code>null</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
引用拖动图像
</dd>
</dl> </li>
</ul> <a name="setDragImageOffset-java.awt.Point-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDragImageOffset</h4> <pre>public void setDragImageOffset(<a href="../../java/awt/Point.html" title="class in java.awt">Point</a> p)</pre>
<div class="block">
<span>设置要拖动的图像的锚点偏移量。</span>
<span>不能<code>null</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>p</code> - 对应于图像相对于图像的左上角的锚定偏移的坐标的
<code>Point</code>对象
</dd>
</dl> </li>
</ul> <a name="getDragImageOffset--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDragImageOffset</h4> <pre>public <a href="../../java/awt/Point.html" title="class in java.awt">Point</a> getDragImageOffset()</pre>
<div class="block">
返回要拖动的图像的锚点偏移量。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>对应于图像相对于图像的左上角的锚定偏移的坐标的<code>Point</code>对象。</span>
<span><code>(0,0)</code>默认返回。</span>
</dd>
</dl> </li>
</ul> <a name="exportAsDrag-javax.swing.JComponent-java.awt.event.InputEvent-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>exportAsDrag</h4> <pre>public void exportAsDrag(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> comp,
<a href="../../java/awt/event/InputEvent.html" title="class in java.awt.event">InputEvent</a> e,
int action)</pre>
<div class="block">
<span>导致启动Swing拖动支持。</span>
<span>如果在组件上设置了dragEnabled属性 <code>javax.swing.plaf.basic</code>包中的各种UI实现调用。</span>
<span>这可以通过自定义UI实现来使用Swing拖动支持。</span>
<span>这个方法也可以被一个Swing扩展名称为JComponent的子类来<code>JComponent</code> 以利用Swing的拖动支持。</span>
<p> <span>转让<em>不一定会</em>一直在这个调用(即调用不会阻塞等待降)的回归完成。</span> <span>转移将通过Swing实现<code>java.awt.dnd</code>机制进行,不需要开发人员的进一步努力。</span> <span>当传输完成时,将调用<code>exportDone</code>方法。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>comp</code> - 保存要传输的数据的组件;</span>
<span>提供共享<code>TransferHandler</code> s</span>
</dd>
<dd>
<code>e</code> - 触发转移的事件
</dd>
<dd>
<span><code>action</code> - 最初要求的转移行动;</span>
<span>任一<code>COPY</code> <code>MOVE</code><code>LINK</code> ;</span>
<span>DnD系统可以改变在拖动操作过程中使用的动作</span>
</dd>
</dl> </li>
</ul> <a name="exportToClipboard-javax.swing.JComponent-java.awt.datatransfer.Clipboard-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>exportToClipboard</h4> <pre>public void exportToClipboard(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> comp,
<a href="../../java/awt/datatransfer/Clipboard.html" title="class in java.awt.datatransfer">Clipboard</a> clip,
int action)
throws <a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></pre>
<div class="block">
<span>导致从给定组件转移到给定的剪贴板。</span>
<span>该方法由组件操作映射中注册的默认剪切和复制操作调用。</span>
<p> <span>转移将使用<code>java.awt.datatransfer</code>机制进行,不需要开发人员进一步的努力。</span> <span>任何数据传输<em></em>将完成,并且在此方法返回之前,将使用发生的操作调用<code>exportDone</code>方法。</span> <span>如果尝试将数据放在剪贴板上,则<code>IllegalStateException</code>投掷的<a href="../../java/awt/datatransfer/Clipboard.html#setContents-java.awt.datatransfer.Transferable-java.awt.datatransfer.ClipboardOwner-">IllegalStateException</a>将通过此方法传播。</span> <span>但是, <code>exportDone</code>将首先调用<code>NONE</code>的一致性。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>comp</code> - 保存要传输的数据的组件;</span>
<span>提供共享<code>TransferHandler</code> s</span>
</dd>
<dd>
<code>clip</code> - 将数据传输到的剪贴板
</dd>
<dd>
<span><code>action</code> - 请求转移行动;</span>
<span>这应该是<code>COPY</code><code>MOVE</code>的值;</span>
<span>所执行的操作是由getSourceActions提供的传输能力和所请求的操作的交集;</span>
<span>交点可能导致的动作<code>NONE</code>如果不支持所请求的动作</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果剪贴板当前不可用
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../java/awt/datatransfer/Clipboard.html#setContents-java.awt.datatransfer.Transferable-java.awt.datatransfer.ClipboardOwner-"><code>Clipboard.setContents(Transferable, ClipboardOwner)</code></a>
</dd>
</dl> </li>
</ul> <a name="importData-javax.swing.TransferHandler.TransferSupport-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>importData</h4> <pre>public boolean importData(<a href="../../javax/swing/TransferHandler.TransferSupport.html" title="class in javax.swing">TransferHandler.TransferSupport</a> support)</pre>
<div class="block">
<span>导致从剪贴板或拖放操作发生转移。</span>
<span><code>Transferable</code>要导入和组分转移到被包含在内<code>TransferSupport</code></span>
<p> <span>虽然拖放实现调用<code>canImport</code>以确定在调用此方法之前转接的适用性,但是粘贴的实现不会。</span> <span>因此,不能假设在调用该方法进行粘贴时可以接受转移。</span> <span>建议明确地要求<code>canImport</code>来处理这种情况。</span> </p>
<p> <span>注意:传递给此方法的<code>TransferSupport</code>对象仅对方法调用的持续时间有效。</span> <span>该方法返回后可能包含什么值是未定义的。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>support</code> - 该对象包含传输的细节,而不是
<code>null</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果数据被插入到组件中则为true否则为false
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果
<code>support</code>
<code>null</code>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.6
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/TransferHandler.html#canImport-javax.swing.TransferHandler.TransferSupport-"><code>canImport(TransferHandler.TransferSupport)</code></a>
</dd>
</dl> </li>
</ul> <a name="importData-javax.swing.JComponent-java.awt.datatransfer.Transferable-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>importData</h4> <pre>public boolean importData(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> comp,
<a href="../../java/awt/datatransfer/Transferable.html" title="interface in java.awt.datatransfer">Transferable</a> t)</pre>
<div class="block">
<span>导致从剪贴板或DND丢弃操作传输到组件。</span>
<span><code>Transferable</code>表示要导入到组件的数据。</span>
<p> <span>注意Swing现在调用较新版本的<code>importData</code> ,它需要一个<code>TransferSupport</code> 后者又称此方法如果TransferSupport中的<code>TransferSupport</code><code>JComponent</code> )。</span> <span>鼓励开发者调用并覆盖较新版本,因为它提供更多信息(并且是唯一支持使用<code>TransferHandler</code>直接在<code>JFrame</code>或其他非<code>JComponent</code>上使用的版本)。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>comp</code> - 接收转移的组件;</span>
<span>提供共享<code>TransferHandler</code> s</span>
</dd>
<dd>
<code>t</code> - 要导入的数据
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果数据被插入到组件中则为true否则为false
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/TransferHandler.html#importData-javax.swing.TransferHandler.TransferSupport-"><code>importData(TransferHandler.TransferSupport)</code></a>
</dd>
</dl> </li>
</ul> <a name="canImport-javax.swing.TransferHandler.TransferSupport-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canImport</h4> <pre>public boolean canImport(<a href="../../javax/swing/TransferHandler.TransferSupport.html" title="class in javax.swing">TransferHandler.TransferSupport</a> support)</pre>
<div class="block">
<span>这种方法在拖放操作期间重复调用,以允许开发人员配置属性并返回传输的可接受性;</span>
<span>具有一个返回值<code>true</code>表示由所述给定表示的转移<code>TransferSupport</code> (包含所有的传送的细节)是可以接受的,在当前时间,和的值<code>false</code>拒绝传输。</span>
<p> <span>对于那些在拖放期间自动显示放置位置的组件,默认情况下接受传输,可以让他们显示放置位置。</span> <span>这可以通过致电<code>setShowDropLocation</code><code>setShowDropLocation</code><code>TransferSupport</code></span> </p>
<p> <span>默认情况下,当传输被接受时,所选择的放置操作是用户通过其拖动手势选择的放置操作。</span> <span>开发人员可以重写此选择不同的动作,从支持的源动作,通过调用<code>setDropAction</code><code>TransferSupport</code></span> </p>
<p> <span>每次调用<code>canImport</code> ,该<code>TransferSupport</code>含有新鲜的状态。</span> <span>因此,必须在每次调用时设置其上设置的任何属性。</span> <span>一下跌, <code>canImport</code>被称为最后一次,然后调用<code>importData</code></span> <span><code>TransferSupport</code>在上次通话期间设置的任何状态将在importData中<code>importData</code></span> </p>
<p> <span>这种方法在内部不被调用以响应粘贴操作。</span> <span>因此建议importData的<code>importData</code>在这种情况下<code>importData</code>式调用此方法,并且该方法也准备返回粘贴操作的适用性。</span> </p>
<p> <span>注意:传递给此方法的<code>TransferSupport</code>对象仅对方法调用的持续时间有效。</span> <span>该方法返回后可能包含什么值是未定义的。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>support</code> - 该对象包含转移的细节,而不是
<code>null</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果导入可以发生,
<code>false</code> false
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果
<code>support</code>
<code>null</code>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.6
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/TransferHandler.html#importData-javax.swing.TransferHandler.TransferSupport-"><code>importData(TransferHandler.TransferSupport)</code></a>
<a href="../../javax/swing/TransferHandler.TransferSupport.html#setShowDropLocation-boolean-"><code>TransferHandler.TransferSupport.setShowDropLocation(boolean)</code></a>
<a href="../../javax/swing/TransferHandler.TransferSupport.html#setDropAction-int-"><code>TransferHandler.TransferSupport.setDropAction(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="canImport-javax.swing.JComponent-java.awt.datatransfer.DataFlavor:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canImport</h4> <pre>public boolean canImport(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> comp,
<a href="../../java/awt/datatransfer/DataFlavor.html" title="class in java.awt.datatransfer">DataFlavor</a>[] transferFlavors)</pre>
<div class="block">
<span>指示组件是否将在实际尝试导入之前接受给定的一组数据风格的导入。</span>
<p> <span>注意Swing现在调用较新版本的<code>canImport</code> ,它需要一个<code>TransferSupport</code> 后者又调用此方法只有TransferSupport中的<code>TransferSupport</code><code>JComponent</code> )。</span> <span>鼓励开发人员呼叫并覆盖较新版本,因为它提供更多信息(并且是唯一支持使用<code>TransferHandler</code>直接在<code>JFrame</code>或其他非<code>JComponent</code>上使用的版本)。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>comp</code> - 接收转移的组件;</span>
<span>提供共享<code>TransferHandler</code> s</span>
</dd>
<dd>
<code>transferFlavors</code> -
<code>transferFlavors</code>的数据格式
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果数据可以插入到组件中则为true否则为false
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/TransferHandler.html#canImport-javax.swing.TransferHandler.TransferSupport-"><code>canImport(TransferHandler.TransferSupport)</code></a>
</dd>
</dl> </li>
</ul> <a name="getSourceActions-javax.swing.JComponent-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSourceActions</h4> <pre>public int getSourceActions(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> c)</pre>
<div class="block">
<span>返回源的支持类型;</span>
<span>任何按位或组合<code>COPY</code> <code>MOVE</code><code>LINK</code></span>
<p> <span>有些模型是不可变的,所以传输操作<code>MOVE</code>不应该在这种情况下公开。</span> <span>返回<code>NONE</code>禁用组件传输。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>c</code> - 保存要传输的数据的组件;</span>
<span>提供共享<code>TransferHandler</code> s</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>COPY</code>如果传输属性可以找到,否则返回
<code>NONE</code>
</dd>
</dl> </li>
</ul> <a name="getVisualRepresentation-java.awt.datatransfer.Transferable-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getVisualRepresentation</h4> <pre>public <a href="../../javax/swing/Icon.html" title="interface in javax.swing">Icon</a> getVisualRepresentation(<a href="../../java/awt/datatransfer/Transferable.html" title="interface in java.awt.datatransfer">Transferable</a> t)</pre>
<div class="block">
<span>返回一个建立传输外观的对象。</span>
<span>这对于在执行拖动操作时提供反馈并且在具有视觉外观的剪贴板实现中表示传送时是有用的。</span>
<span>在实施<code>Icon</code>接口不应改变图形剪辑或α水平。</span>
<span>图标实现不需要是矩形或绘制所有的边界矩形和逻辑调用图标paint方法不应该假定所有的位都被绘制。</span>
<span><code>null</code>是此方法的有效返回值,表示没有提供视觉表示。</span>
<span>在这种情况下,调用逻辑可以自由地表示可转移的。</span>
<p> <span>如果返回值为<code>null</code> 默认的Swing逻辑将不会进行alpha混合拖动<code>null</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>t</code> - 要传输的数据;</span>
<span>该值预计由<code>createTransferable</code>创建</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>null</code> ,表示没有默认的视觉表示
</dd>
</dl> </li>
</ul> <a name="createTransferable-javax.swing.JComponent-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createTransferable</h4> <pre>protected <a href="../../java/awt/datatransfer/Transferable.html" title="interface in java.awt.datatransfer">Transferable</a> createTransferable(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> c)</pre>
<div class="block">
<span>创建一个<code>Transferable</code>作为数据传输的来源。</span>
<span>返回到要传送的数据的表示,或<code>null</code>如果组件的属性是<code>null</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>c</code> - 保存要传输的数据的组件;</span>
<span>提供共享<code>TransferHandler</code> s</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
要转让的数据的表示,或
<code>null</code>如果与c相关
<code>c</code>的属性是
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="exportDone-javax.swing.JComponent-java.awt.datatransfer.Transferable-int-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>exportDone</h4> <pre>protected void exportDone(<a href="../../javax/swing/JComponent.html" title="class in javax.swing">JComponent</a> source,
<a href="../../java/awt/datatransfer/Transferable.html" title="interface in java.awt.datatransfer">Transferable</a> data,
int action)</pre>
<div class="block">
<span>数据导出后调用。</span>
<span>如果操作为<code>MOVE</code> ,则此方法应删除传输的数据。</span>
<p> <span>这种方法被执行,因为<code>MOVE</code>不是这个实现的支持的操作( <code>getSourceActions</code>不包括<code>MOVE</code> )。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> - 作为数据源的组件
</dd>
<dd>
<code>data</code> - 如果操作为
<code>NONE</code> ,则传输的数据或可能为空。
</dd>
<dd>
<code>action</code> - 执行的实际操作
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>