11.9.2 传递文本

传递文本是最简单的情形，因为AWT已经提供了一个StringSelection用于传输文本字符串。

将文本放入剪贴板

将一段文本内容（字符串对象）放进剪贴板中的步骤如下。

1. 创建一个Clipboard实例

既可以创建系统剪贴板，也可以创建本地剪贴板。

创建系统剪贴板通过如下代码：

Clipboard clipboard= Toolkit.getDefaultToolkit().getSystemClipboard();

创建本地剪贴板通过如下代码：

Clipboard clipboard =new Clipboard("cb");

2. 将需要放入剪贴板中的字符串封装成StringSelection对象

如下代码所示：

StringSelection st =new StringSelection(targetStr);

3. 调用setContents方法

调用剪贴板对象的setContents()方法将StringSelection放进剪贴板中，该方法需要两个参数，

• 第一个参数是Transferable对象，代表放进剪贴板中的对象；
• 第二个参数是ClipboardOwner对象，代表剪贴板数据的持有者，通常无须关心剪贴板数据的持有者，所以把第二个参数设为null。

clipboard.setContents(st,null);

从剪贴板中取出数据

从剪贴板中取出数据则比较简单，调用Clipboard对象的getData(DataFlavor flavor);方法即可取出剪贴板中指定格式的内容，如果指定flavor的数据不存在，该方法将引发UnsupportedFlavorException异常。为了避免出现异常，可以先调用Clipboard对象的isDataFlavorAvailable(DataFlavor flavor);方法来判断指定flavor的数据是否存在。如下代码所示：

if (clipboard.isDataFlavorAvailable(DataFlavor.stringFlavor))
{
    String content =(String)clipboard.getData(DataFlavor.stringFlavor));
}

实例

下面程序是一个利用系统剪贴板进行复制、粘贴的简单程序。

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import java.awt.datatransfer.*;
public class SimpleClipboard
{
    private Frame f = new Frame("简单的剪贴板程序");
    // 获取系统剪贴板
    private Clipboard clipboard = Toolkit
        .getDefaultToolkit().getSystemClipboard();
    // 下面是创建本地剪贴板的代码
    // Clipboard clipboard = new Clipboard("cb");   // ①
    // 用于复制文本的文本框
    private TextArea jtaCopyTo = new TextArea(5,20);
    // 用于粘贴文本的文本框
    private TextArea jtaPaste = new TextArea(5,20);
    private Button btCopy = new Button("复制"); // 复制按钮
    private Button btPaste = new Button("粘贴"); // 粘贴按钮
    public void init()
    {
        Panel p = new Panel();
        p.add(btCopy);
        p.add(btPaste);
        btCopy.addActionListener(event ->
        {
            // 将一个多行文本域里的字符串封装成StringSelection对象
            StringSelection contents = new
                StringSelection(jtaCopyTo.getText());
            // 将StringSelection对象放入剪贴板
            clipboard.setContents(contents, null);
        });
        btPaste.addActionListener(event ->
        {
            // 如果剪贴板中包含stringFlavor内容
            if (clipboard.isDataFlavorAvailable(DataFlavor.stringFlavor))
            {
                try
                {
                    // 取出剪贴板中stringFlavor内容
                    String content = (String)clipboard
                        .getData(DataFlavor.stringFlavor);
                    jtaPaste.append(content);
                }
                catch (Exception e)
                {
                    e.printStackTrace();
                }
            }
        });
        // 创建一个水平排列的Box容器
        Box box = new Box(BoxLayout.X_AXIS);
        // 将两个多行文本域放在Box容器中
        box.add(jtaCopyTo);
        box.add(jtaPaste);
        // 将按钮所在Panel、Box容器添加到Frame窗口中
        f.add(p,BorderLayout.SOUTH);
        f.add(box,BorderLayout.CENTER);
        f.pack();
        f.setVisible(true);
    }
    public static void main(String[] args)
    {
        new SimpleClipboard().init();
    }
}

上面程序中“复制”按钮的事件监听器负责将第一个文本域的内容复制到系统剪贴板中，“粘贴”按钮的事件监听器则负责取出系统剪贴板中的stringFlavor内容，并将其添加到第二个文本域内。运行上面程序，将看到如图11.32所示的结果。

因为程序使用的是系统剪贴板，因此可以通过Windows的剪贴簿查看器来查看程序放入剪贴板中的内容。在Windows的“开始”菜单中运行“clipbrd”程序，将可以看到如图11.33所示的窗口。

提示：
Windows7系统已经删除了默认的剪贴板查看器，因此读者可以到WindowsXP的C:\windows\system32\目录下将clipbrd.exe文件复制过来。