掌握Android开发中ClipboardManager的强大功能，高效管理剪贴板数据-51CTO.COM

ClipboardManager

ClipboardManager是Android提供的一个系统服务，负责管理系统全局的剪切板对象。允许您在应用程序之间复制和粘贴文本、链接、图像等数据。在Android开发中，通过context.getSystemService(Context.CLIPBOARD_SERVICE)可以获得ClipboardManager的实例。ClipboardManager的主要功能包括复制、粘贴、监听剪贴板数据的变化以及清空剪切板内容。

获取ClipboardManager实例

ClipboardManager clipboardManager = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);1.

ClipboardManager常用方法

「setPrimaryClip(ClipData clip)」

「说明」：用于将指定的ClipData对象设置为主要剪贴板内容。ClipData可以包含文本、链接、图像等数据。

「使用示例」：创建一个包含文本的ClipData对象，并将其设置为剪贴板的内容。

ClipData clipData = ClipData.newPlainText("label", "复制的文本");
clipboardManager.setPrimaryClip(clipData);1.
2.

「getPrimaryClip()」

「说明」：用于获取当前剪贴板上的主要内容。返回一个ClipData对象，包含剪贴板中的数据。

「使用示例」：通过调用此方法并检查返回的ClipData对象来获取剪贴板上的内容。

ClipData clipData = clipboardManager.getPrimaryClip();
if (clipData != null && clipData.getItemCount() > 0) {
    // 处理剪贴板内容
}1.
2.
3.
4.

「addPrimaryClipChangedListener(ClipData.OnPrimaryClipChangedListener listener)」

「说明」：用于为剪贴板的主要内容添加监听器。当剪贴板的内容发生变化时，注册的监听器会被触发。

「使用示例」：需要在剪贴板内容变化时执行某些操作（如更新UI），可以使用此方法添加监听器。

clipboardManager.addPrimaryClipChangedListener(new ClipboardManager.OnPrimaryClipChangedListener() {
    @Override
    public void onPrimaryClipChanged() {
        // 剪贴板内容发生变化时执行相关操作
    }
});1.
2.
3.
4.
5.
6.

「removePrimaryClipChangedListener(ClipData.OnPrimaryClipChangedListener listener)」

「说明」：用于移除之前添加的剪贴板内容变化监听器。

「使用示例」：当不需要监听剪贴板内容变化时，使用此方法移除监听器，以避免不必要的资源消耗。

private ClipboardManager.OnPrimaryClipChangedListener mOnPrimaryClipChangedListener = new ClipboardManager.OnPrimaryClipChangedListener() {
    @Override
    public void onPrimaryClipChanged() {
        // 剪贴板内容发生变化时执行相关操作
    }
}

clipboardManager.removePrimaryClipChangedListener(mOnPrimaryClipChangedListener);1.
2.
3.
4.
5.
6.
7.
8.

「hasPrimaryClip()」

「说明」：用于检查剪贴板上是否有内容。

「使用示例」：在尝试获取剪贴板内容之前，可以使用此方法检查剪贴板是否为空。

if (clipboardManager.hasPrimaryClip()) {
    ClipData clipData = clipboardManager.getPrimaryClip();
    if (clipData != null && clipData.getItemCount() > 0) {
        CharSequence text = clipData.getItemAt(0).getText();
        // 使用获取到的文本进行操作
    }
}1.
2.
3.
4.
5.
6.
7.

「clearPrimaryClip()」

「说明」：用于清空剪贴板的内容。

「使用示例」：需要清除剪贴板上的内容时使用。

clipboardManager.clearPrimaryClip();1.

ClipData

ClipData用于表示剪贴板数据，允许在应用程序之间复制和粘贴文本、链接、图像等数据。ClipData对象是一个不可变的数据容器，通常包含一个或多个ClipData.Item对象，每个Item对象代表剪贴板中的一项数据，可以是文本、Uri或Intent。

ClipData特点

「数据类型多样性」：ClipData可以包含多种类型的数据，如文本、图片、音频等。每个ClipData.Item对象都可以指定其数据类型，如文本、URI或Intent。
「剪贴板管理」：ClipData与ClipboardManager类协同工作，用于管理剪贴板的内容。通过ClipboardManager，可以将ClipData对象设置为剪贴板的内容，也可以从剪贴板中获取ClipData对象。
「灵活性和可扩展性」：ClipData的设计允许开发者根据需要自定义数据的格式和类型。开发者可以创建自定义的ClipData.Item对象，并指定其MIME类型和数据内容。

创建ClipData

创建ClipData对象涉及到要复制的数据类型以及设置适当的标签和MIME类型。

创建一个纯文本的ClipData对象，需要提供标签（label）和要复制到剪贴板的文本内容（text）。

ClipData clip = ClipData.newPlainText("label", "这里是文本内容");1.

newPlainText(CharSequence label, CharSequence text)方法用于创建一个只包含纯文本的ClipData对象。第一个参数是标签，用于描述剪贴板中的数据，第二个参数是要复制的文本内容。

创建包含URI的ClipData对象。需要提供标签（label）、内容解析器（ContentResolver）以及要复制到剪贴板的URI。

Uri imageUri = Uri.parse("content://media/external/images/media/123456"); // URI
ClipData clip = ClipData.newUri(getContentResolver(), "label", imageUri);1.
2.

newUri(ContentResolver resolver, CharSequence label, Uri uri)方法用于创建一个包含URI的ClipData对象。用于复制图片或其他文件类型的URI。第一个参数是ContentResolver对象，用于访问内容提供者中的数据，第二个参数是标签，第三个参数是要复制的URI。

创建包含多个项的ClipData对象

ClipData.Item item1 = new ClipData.Item("文本1");
ClipData.Item item2 = new ClipData.Item("文本2");
ClipData clip = new ClipData("label", new String[]{"text/plain"}, item1, item2);1.
2.
3.

手动创建了ClipData.Item对象，并构造一个包含多个项的ClipData对象。在剪贴板中保存多种类型的数据或多项数据。

使用Intent的ClipData对象将Intent作为剪贴板数据的一部分。不常见，但可以通过以下方式实现：

Intent intent = new Intent();
// 设置Intent的数据和动作等...
ClipData.Item item = new ClipData.Item(intent);
ClipData clip = new ClipData("label", new String[]{intent.getType()}, item);1.
2.
3.
4.

创建一个包含Intent的ClipData.Item来构造ClipData对象。通常用于在剪贴板中传递可以在另一个应用或组件中解析的复杂数据或动作。

获取ClipData数据

从ClipboardManager中获取剪贴板上的当前内容，并解析其中的数据。使用getPrimaryClip方法来获取剪贴板上的当前ClipData对象。

ClipData clipData = clipboardManager.getPrimaryClip();1.

如果clipData不为空，调用相应方法来获取数据。具体的方法取决于ClipData对象包含的数据类型。

获取纯文本数据如果ClipData对象包含纯文本，使用getItemAt(0)来获取第一个ClipData.Item对象，调用getText()方法获取文本数据。

if (clipData != null && clipData.getItemCount() > 0) {
    ClipData.Item item = clipData.getItemAt(0);
    if (item.getText() != null) {
        CharSequence text = item.getText().toString();
        // 使用text变量，包含剪贴板上的文本内容
    }
}1.
2.
3.
4.
5.
6.
7.

获取URI数据如果ClipData对象包含URI数据，获取ClipData.Item对象，调用getUri()方法获取URI数据。

if (clipData != null && clipData.getItemCount() > 0) {
    ClipData.Item item = clipData.getItemAt(0);
    Uri uri = item.getUri();
    // 使用uri变量，包含剪贴板上的文件或资源的URI
}1.
2.
3.
4.
5.

获取Intent数据不常见，如果ClipData对象包含Intent数据，获取ClipData.Item对象，调用getIntent()方法获取Intent数据。

if (clipData != null && clipData.getItemCount() > 0) {
    ClipData.Item item = clipData.getItemAt(0);
    Intent intent = item.getIntent();
    // 使用intent变量，包含剪贴板上的Intent数据
}1.
2.
3.
4.
5.

遍历多个数据项如果ClipData对象包含多个项，可以遍历获取每个项的数据：

if (clipData != null) {
    for (int i = 0; i < clipData.getItemCount(); i++) {
        ClipData.Item item = clipData.getItemAt(i);
        // 根据item的类型调用相应的方法来获取数据
    }
}1.
2.
3.
4.
5.
6.

代码示例

package com.reathin.sample;
 
import android.content.ClipData;
import android.content.ClipboardManager;
import android.content.Context;
 
public class ClipboardHelper {
 
    /**
     * 将文本复制到剪贴板
     *
     * @param text 要复制的文本
     */
    public void copyText(Context context, String text) {
        ClipboardManager clipboardManager = (ClipboardManager) context.getSystemService(Context.CLIPBOARD_SERVICE);
        ClipData clipData = ClipData.newPlainText("text", text);
        clipboardManager.setPrimaryClip(clipData);
    }
 
    /**
     * 从剪贴板获取文本
     *
     * @return 剪贴板中的文本
     */
    public String getCopiedText(Context context) {
        ClipboardManager clipboardManager = (ClipboardManager) context.getSystemService(Context.CLIPBOARD_SERVICE);
        if (clipboardManager.hasPrimaryClip()) {
            ClipData clipData = clipboardManager.getPrimaryClip();
            if (clipData != null && clipData.getItemCount() > 0) {
                CharSequence text = clipData.getItemAt(0).getText();
                return text.toString();
            }
        }
        return null;
    }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.