系统粘贴板的使用

Window系统一样，Android也有剪切板。Android提供了一个强大的剪切板框架，SDK API 11 之后框架主要涉及到ClipboardManager、ClipData 和 ClipData.Item这三个类。

  • ClipboardManager： 表示一个剪贴板
  • ClipData： 剪贴板中保存的所有剪贴数据集（剪贴板可同时复制/保存多条多种数据条目）
  • ClipData.Item： 剪贴数据集中的一个数据条目

1. 主要API介绍

(1) 获取剪贴板管理器

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

(2) 创建能够存入剪贴板的ClipData对象

说明： 早期版本的Android剪切板只能复制文本（可以为复合文本）信息。在API 11后对ClipboardManager进行了升级，可以通过 ClipData 来复制文本（普通字符型）、Uri （URL 型）和 Intent（Intent 型）三种数据。

  • 普通字符：就是普通字符串的剪切，复制，粘贴。
  • URL：在复制的时候可以复制一个URL,这个URL可以是请求ContentProvider的URL，在粘贴的时候调用ContntProvider获取数据，并使用。
  • Intent：如在记事本应用中长按某一个记录本条目，这时会创建删除这个记事本的Intent，并添加到剪贴板，当用户将这个记事本条目拖到垃圾桶松开时，应用会从剪贴板中获取Intent并执行，这个记事本条目就被删除了。
  • 创建普通字符型ClipData：将一个字符串放到剪贴板上
ClipData clipData = ClipData.newPlainText(null, "需要copy的信息");
  • 创建URL型ClipData：将一个URL放到剪贴板上
ClipData clipData = ClipData.newRawUri(null,Uri.parse("http://www.baidu.com"));
  • 创建Intent型ClipData：将一个intent放到剪贴板上
ClipData clipData = ClipData.newIntent(null, intent);

存Intent：

//将一个intent放到剪贴板上
Intent intent = new Intent();
intent.setClass(this,HomeActivity.class);
ClipData clipData = ClipData.newIntent("Home",intent);
cm.setPrimaryClip(clipData );

取Intent：

ClipData clipData = cm.getPrimaryClip();
ClipData.Item item = clipData.getItemAt(0);
if(item.getIntent()!=null) {//剪贴板里是否为Intent对象
     startActivity(item.getIntent());
}else {
      Intent intent1 = new Intent();
      intent1.setClass(this,PasteActivity.class);//跳到文字接收页面
      startActivity(intent1);
}

注意：ClipData对象可包含一个或多个ClipData.Item对象。上面三种方法只在ClipData对象中创建了一个ClipData.Item对象；如果想向ClipData对象中添加多个Item，可通过ClipData对象的addItem()方法来添加。

(3) 将ClipData数据复制到剪贴板

cm.setPrimaryClip(clipData);

(4) 从剪贴板中获取ClipData数据

ClipData clipData = cm.getPrimaryClip();
String content = clipData.getItemAt(i).getText().toString();

注意：在API 11版本之后，原来利用剪切板传递数据使用的setText()和getText()方法被弃用了，只能使用ClipData对象来代替。

2. 剪贴板的主要操作

  • 复制：复制信息到粘贴板
private void copyContentToClip(String content){
        ClipboardManager cm = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);// 获取系统剪贴板
        ClipData clipData = ClipData.newPlainText(null,content);// 创建一个剪贴数据集：通过ClipData可创建普通字符型、Uri型和Intent型
        cm.setPrimaryClip(clipData);// 将ClipData数据复制到剪贴板
    }
  • 粘贴：从粘贴板获取信息
private void getClipContent(){
        ClipboardManager cm = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);// 获取系统剪贴板
        ClipData clipData = cm.getPrimaryClip();// 从剪贴板中获取ClipData数据
        String content = clipData.getItemAt(0).getText().toString();// 从数据集中获取（粘贴）文本数据
        Log.v("获取剪贴板文本",content);
    }
  • 监听粘贴板数据变化
ClipboardManager cm = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);// 获取系统剪贴板
cm.addPrimaryClipChangedListener(new ClipboardManager.OnPrimaryClipChangedListener() {
            @Override
            public void onPrimaryClipChanged() {
                Log.v("ClipboardManager","监听到粘贴板数据改变");
            }
        });
  • 清空粘贴板
private void clearClipboard() {
        ClipboardManager cm = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);// 获取系统剪贴板
        if (cm != null) {
            try {
                cm.setPrimaryClip(ClipData.newPlainText(null, ""));
            } catch (Exception e) {
                Log.e("异常",e.getMessage());
            }
        }
    }

示例代码：
(1) ClipboardActivity.java

package comi.example.liy.mytestdemo;

import android.content.ClipData;
import android.content.ClipboardManager;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.widget.Button;

/**
 * Created by liy on 2019-12-19 16:09
 */
public class ClipboardActivity extends AppCompatActivity implements View.OnClickListener {
    private ClipboardManager cm;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_clipboard);

        Button btnCopy = findViewById(R.id.clip_copy);
        Button btnPaste = findViewById(R.id.clip_paste);
        Button btnClear = findViewById(R.id.clip_clear);
        btnCopy.setOnClickListener(this);
        btnPaste.setOnClickListener(this);
        btnClear.setOnClickListener(this);

        cm = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);// 获取系统剪贴板
        cm.addPrimaryClipChangedListener(new ClipboardManager.OnPrimaryClipChangedListener() {
            @Override
            public void onPrimaryClipChanged() {
                Log.v("ClipboardManager","监听到粘贴板数据改变");
            }
        });
    }


    /**
     * 粘贴板(复制)：实现文本复制功能
     */
    private void copyContentToClip(String content){
        ClipData clipData = ClipData.newPlainText(null,content);// 创建一个剪贴数据集：通过ClipData可创建普通字符型、Uri型和Intent型
        for (int i = 0; i < 10; i++){
            ClipData.Item item = new ClipData.Item("文本" + (i+1));//ClipData对象中包含一个或多个ClipData.Item对象
            clipData.addItem(item);//添加多个Item
        }
        cm.setPrimaryClip(clipData);// 将ClipData数据复制到剪贴板
    }

    /**
     * 粘贴板(粘贴)：获取系统剪贴板内容
     */
    private void getClipContent(){
        ClipData clipData = cm.getPrimaryClip();// 从剪贴板中获取ClipData数据
        if (clipData != null && clipData.getItemCount() > 0) {
            for (int i = 0; i < clipData.getItemCount(); i++){
                String content = clipData.getItemAt(i).getText().toString();// 从数据集中获取（粘贴）文本数据
                Log.v("获取剪贴板第" + (i) + "条文本数据",content);
            }
        }
    }

    /**
     * 清空剪贴板内容
     */
    private void clearClipboard() {
        if (cm != null) {
            try {
                cm.setPrimaryClip(ClipData.newPlainText(null, ""));
            } catch (Exception e) {
                Log.e("异常",e.getMessage());
            }
        }
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.clip_copy:
                copyContentToClip("需被复制到粘贴板的文本");
                break;
            case R.id.clip_paste:
                getClipContent();
                break;
            case R.id.clip_clear:
                clearClipboard();
                break;
            default:
                break;
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 移除监听器
        //cm.removePrimaryClipChangedListener();
    }
}

(2) activity_clipboard.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <Button
        android:id="@+id/clip_copy"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="设置粘贴板内容"/>

    <Button
        android:id="@+id/clip_paste"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="获取粘贴板内容"/>
    <Button
        android:id="@+id/clip_clear"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="清空粘贴板内容"/>
</LinearLayout>

3. 剪贴板的简单应用示例

(1) 实现应用内的数据共享（应用内传递数据）

在Android开发中我们经常要遇到的一个问题就是数据在不同的Activity之间的共享。在Android开发中有很多种方法可以达到这个目地。这里介绍一种比较常见、又常用的一种方法就是使用剪切板来实现Activity间的数据传递，关键在于将数据复制到粘贴板和从粘贴板中取出数据。

  • 存数据：Activity1 把数据复制到剪切板
String content = "需要copy的信息";
ClipboarManager cm =(ClipboarManager)getSystemService(Context.CLIPBOARD_SERVICE);
ClipData mClipData = ClipData.newPlainText(null, content);  
cm.setPrimaryClip(mClipData);
  • 取数据：Activity2 从粘贴板中取出数据
ClipboarManager clipboarManager=(ClipboarManager)getSystemService(Context.CLIPBOARD_SERVICE);
String content = clipData.getItemAt(0).getText().toString();

(2) 实现应用间的数据共享（应用内传递数据）

原理：Android所用应用公用一个粘贴板，在其他应用中复制文字，就是将复制的信息放到了系统粘贴板，所以我们可以在自己的应用内直接读取系统粘贴板上的信息。

如：复制百度或短信应用中的一段文字，然后打开PasteActivity页面，就能得到的你复制的内容。

  • PasteActivity.java
package comi.example.liy.mytestdemo;

import android.content.ClipData;
import android.content.ClipboardManager;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.TextView;

/**
 * Created by liy on 2019-12-20 13:59
 */
public class PasteActivity extends AppCompatActivity{

    private TextView tvContent;

    private ClipboardManager mClipboardManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_paste);

        tvContent = (TextView)findViewById(R.id.tv_content);
        mClipboardManager = (ClipboardManager)getSystemService(CLIPBOARD_SERVICE);

        getClipContent();

    }

    /**
     * 获取粘贴板上存放的内容并显示
     */
    private void getClipContent() {
        if(mClipboardManager.hasPrimaryClip()) {//判断当前剪贴板上存在Copy
            //获取粘贴板上存放的内容
            ClipData mClipData = mClipboardManager.getPrimaryClip();
            ClipData.Item item = mClipData.getItemAt(0);
            String content = item.getText().toString();
            //将剪贴板上的文字信息取出来放到文本框中
            tvContent.setText(content);
        }
    }

}
  • activity_paste.java
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="horizontal">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="粘贴板上存放的内容为："/>
    <TextView
        android:id="@+id/tv_content"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textColor="#FF0000"/>

</LinearLayout>

拓展：淘宝宝贝分享到微信，在微信中复制链接（将一个URL放到剪贴板上），然后打开淘宝可跳转到该宝贝（从粘贴板上读取URL），该业务逻辑的实现可能就是使用了剪贴板来实现应用间的数据共享。尚未深入研究，这里仅做猜想，如猜想有误，还请多多指教。

(3) 实现自由复制TextView等控件的文字

只需在该控件上加上android:textIsSelectable="true"，或者在java代码加 setTextIsSelectable(true) 即可实现。

  • PasteActivity.java
package comi.example.liy.mytestdemo;

import android.content.ClipData;
import android.content.ClipboardManager;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;

/**
 * Created by liy on 2019-12-20 13:59
 */
public class PasteActivity extends AppCompatActivity implements View.OnClickListener {

    private Button btnGetContent;
    private TextView tvContent;

    private ClipboardManager mClipboardManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_paste);

        initViews();

        mClipboardManager = (ClipboardManager)getSystemService(CLIPBOARD_SERVICE);

    }

    private void initViews(){
        /*TextView tvCopy = findViewById(R.id.tv_copy);
        tvCopy.setTextIsSelectable(true);//设置文本可被选中进行复制*/
        btnGetContent = findViewById(R.id.get_content);
        btnGetContent.setOnClickListener(this);
        tvContent = (TextView)findViewById(R.id.tv_content);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.get_content:
                getClipContent();
                break;
            default:
                break;
        }
    }

    /**
     * 获取粘贴板上存放的内容并显示
     */
    private void getClipContent() {
        if(mClipboardManager.hasPrimaryClip()) {//判断当前剪贴板上存在Copy
            //获取粘贴板上存放的内容
            ClipData mClipData = mClipboardManager.getPrimaryClip();
            ClipData.Item item = mClipData.getItemAt(0);
            String content = item.getText().toString();
            //将剪贴板上的文字信息取出来放到文本框中
            tvContent.setText(content);
        }
    }



}
  • activity_paste.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:layout_margin="10dp">

    <TextView
        android:id="@+id/tv_copy"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="可以复制我哦"
        android:textSize="30sp"
        android:textIsSelectable="true"/>
    <Button
        android:id="@+id/get_content"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="点击获取粘贴板内容"
        android:layout_marginTop="20dp"
        android:layout_marginBottom="20dp"/>
    <TextView
        android:id="@+id/tv_content"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textColor="#FF0000"/>

</LinearLayout>
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 204,053评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,527评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 150,779评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,685评论 1赞 276
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,699评论 5赞 366
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,609评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,989评论 3赞 396
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,654评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,890评论 1赞 298
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,634评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,716评论 1赞 330
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,394评论 4赞 319
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,976评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,950评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,191评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 44,849评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,458评论 2赞 342