Android 剪切板 ClipboardManager 基本操作

前言

在 Android 应用中复制某一段文本，可以在另外一个应用中进行粘贴。其内部是通过 ClipboardManager 来实现的。下面就来看看如何通过 ClipboardManager 来操作剪切板。

初始化

ClipboardManager 对应了一个系统服务，可通过下面代码来获取它的实例对象，

mClipboardManager = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);

获取剪切板内容

拿到 ClipboardManager 对象后，通过 ClipboardManager#getPrimaryClip() 方法即可获取到剪切板上的数据对象 ClipData，

ClipData clipData = mClipboardManager.getPrimaryClip();
if (mClipboardManager.hasPrimaryClip() && clipData != null && clipData.getItemCount() > 0) {
    ClipData.Item item = clipData.getItemAt(0);
    String text = String.valueOf(item.getText());
    Log.i(TAG, "text: " + text);
}

上面代码中的局部变量 text 就是剪切板的内容。

更新剪切板内容

首先需要基于待更新的文本，创建一个 ClipData 对象，然后通过 ClipboardManager#setPrimaryClip(ClipData) 方法将更新剪切板，相关代码如下，

void updatePrimaryClip(String newText) {
    ClipData clip = ClipData.newPlainText(null, newText);
    mClipboardManager.setPrimaryClip(clip);
    Log.i(TAG, "updatePrimaryClip: newText=" + newText);
}

剪切板内容监听

通过向 ClipboardManager 添加一个监听器，可以实现剪切板的变化监听，相关代码如下，

ClipboardManager.OnPrimaryClipChangedListener mOnPrimaryClipChangedListener = new ClipboardManager.OnPrimaryClipChangedListener() {
    @Override
    public void onPrimaryClipChanged() {
        Log.i(TAG, "onPrimaryClipChanged: changed!!”);
        ...
    }
};
mClipboardManager.addPrimaryClipChangedListener(mOnPrimaryClipChangedListener);

在收到 onPrimaryClipChanged() 方法的回调后，表示剪切版本的内容发生了变化，接下来可根据你自己的需求去实现相关逻辑，比如获取剪切板的内容等等。

清空剪切板内容

void clearClipboard() {
    ClipboardManager manager = mClipboardManager;
    if (manager != null) {
        try {
            manager.setPrimaryClip(ClipData.newPlainText(null, null));
        } catch (Exception e) {
            Log.i(TAG, "clearClipboard: exception>>" + e.getMessage());
        }
    }
}