系統(tǒng)粘貼板的使用

Window系統(tǒng)一樣,Android也有剪切板。Android提供了一個強大的剪切板框架,SDK API 11 之后框架主要涉及到ClipboardManager、ClipData 和 ClipData.Item這三個類。

  • ClipboardManager: 表示一個剪貼板
  • ClipData: 剪貼板中保存的所有剪貼數(shù)據(jù)集(剪貼板可同時復(fù)制/保存多條多種數(shù)據(jù)條目)
  • ClipData.Item: 剪貼數(shù)據(jù)集中的一個數(shù)據(jù)條目

1. 主要API介紹

(1) 獲取剪貼板管理器

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

(2) 創(chuàng)建能夠存入剪貼板的ClipData對象

說明: 早期版本的Android剪切板只能復(fù)制文本(可以為復(fù)合文本)信息。在API 11后對ClipboardManager進行了升級,可以通過 ClipData 來復(fù)制文本(普通字符型)、Uri (URL 型)和 Intent(Intent 型)三種數(shù)據(jù)。

  • 普通字符:就是普通字符串的剪切,復(fù)制,粘貼。
  • URL:在復(fù)制的時候可以復(fù)制一個URL,這個URL可以是請求ContentProvider的URL,在粘貼的時候調(diào)用ContntProvider獲取數(shù)據(jù),并使用。
  • Intent:如在記事本應(yīng)用中長按某一個記錄本條目,這時會創(chuàng)建刪除這個記事本的Intent,并添加到剪貼板,當用戶將這個記事本條目拖到垃圾桶松開時,應(yīng)用會從剪貼板中獲取Intent并執(zhí)行,這個記事本條目就被刪除了。
  • 創(chuàng)建普通字符型ClipData:將一個字符串放到剪貼板上
ClipData clipData = ClipData.newPlainText(null, "需要copy的信息"); 
  • 創(chuàng)建URL型ClipData:將一個URL放到剪貼板上
ClipData clipData = ClipData.newRawUri(null,Uri.parse("http://www.baidu.com"));  
  • 創(chuàng)建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對象中創(chuàng)建了一個ClipData.Item對象;如果想向ClipData對象中添加多個Item,可通過ClipData對象的addItem()方法來添加。

(3) 將ClipData數(shù)據(jù)復(fù)制到剪貼板

cm.setPrimaryClip(clipData);  

(4) 從剪貼板中獲取ClipData數(shù)據(jù)

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

注意:在API 11版本之后,原來利用剪切板傳遞數(shù)據(jù)使用的setText()和getText()方法被棄用了,只能使用ClipData對象來代替。

2. 剪貼板的主要操作

  • 復(fù)制:復(fù)制信息到粘貼板
private void copyContentToClip(String content){
        ClipboardManager cm = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);// 獲取系統(tǒng)剪貼板
        ClipData clipData = ClipData.newPlainText(null,content);// 創(chuàng)建一個剪貼數(shù)據(jù)集:通過ClipData可創(chuàng)建普通字符型、Uri型和Intent型
        cm.setPrimaryClip(clipData);// 將ClipData數(shù)據(jù)復(fù)制到剪貼板
    }
  • 粘貼:從粘貼板獲取信息
private void getClipContent(){
        ClipboardManager cm = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);// 獲取系統(tǒng)剪貼板
        ClipData clipData = cm.getPrimaryClip();// 從剪貼板中獲取ClipData數(shù)據(jù)
        String content = clipData.getItemAt(0).getText().toString();// 從數(shù)據(jù)集中獲?。ㄕ迟N)文本數(shù)據(jù)
        Log.v("獲取剪貼板文本",content);
    }
  • 監(jiān)聽粘貼板數(shù)據(jù)變化
ClipboardManager cm = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);// 獲取系統(tǒng)剪貼板
cm.addPrimaryClipChangedListener(new ClipboardManager.OnPrimaryClipChangedListener() {
            @Override
            public void onPrimaryClipChanged() {
                Log.v("ClipboardManager","監(jiān)聽到粘貼板數(shù)據(jù)改變");
            }
        });
  • 清空粘貼板
private void clearClipboard() {
        ClipboardManager cm = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);// 獲取系統(tǒng)剪貼板
        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);// 獲取系統(tǒng)剪貼板
        cm.addPrimaryClipChangedListener(new ClipboardManager.OnPrimaryClipChangedListener() {
            @Override
            public void onPrimaryClipChanged() {
                Log.v("ClipboardManager","監(jiān)聽到粘貼板數(shù)據(jù)改變");
            }
        });
    }


    /**
     * 粘貼板(復(fù)制):實現(xiàn)文本復(fù)制功能
     */
    private void copyContentToClip(String content){
        ClipData clipData = ClipData.newPlainText(null,content);// 創(chuàng)建一個剪貼數(shù)據(jù)集:通過ClipData可創(chuàng)建普通字符型、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數(shù)據(jù)復(fù)制到剪貼板
    }

    /**
     * 粘貼板(粘貼):獲取系統(tǒng)剪貼板內(nèi)容
     */
    private void getClipContent(){
        ClipData clipData = cm.getPrimaryClip();// 從剪貼板中獲取ClipData數(shù)據(jù)
        if (clipData != null && clipData.getItemCount() > 0) {
            for (int i = 0; i < clipData.getItemCount(); i++){
                String content = clipData.getItemAt(i).getText().toString();// 從數(shù)據(jù)集中獲取(粘貼)文本數(shù)據(jù)
                Log.v("獲取剪貼板第" + (i) + "條文本數(shù)據(jù)",content);
            }
        }
    }

    /**
     * 清空剪貼板內(nèi)容
     */
    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("需被復(fù)制到粘貼板的文本");
                break;
            case R.id.clip_paste:
                getClipContent();
                break;
            case R.id.clip_clear:
                clearClipboard();
                break;
            default:
                break;
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 移除監(jiān)聽器
        //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="設(shè)置粘貼板內(nèi)容"/>

    <Button
        android:id="@+id/clip_paste"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="獲取粘貼板內(nèi)容"/>
    <Button
        android:id="@+id/clip_clear"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="清空粘貼板內(nèi)容"/>
</LinearLayout>

3. 剪貼板的簡單應(yīng)用示例

(1) 實現(xiàn)應(yīng)用內(nèi)的數(shù)據(jù)共享(應(yīng)用內(nèi)傳遞數(shù)據(jù))

在Android開發(fā)中我們經(jīng)常要遇到的一個問題就是數(shù)據(jù)在不同的Activity之間的共享。在Android開發(fā)中有很多種方法可以達到這個目地。這里介紹一種比較常見、又常用的一種方法就是使用剪切板來實現(xiàn)Activity間的數(shù)據(jù)傳遞,關(guān)鍵在于將數(shù)據(jù)復(fù)制到粘貼板和從粘貼板中取出數(shù)據(jù)。

  • 存數(shù)據(jù):Activity1 把數(shù)據(jù)復(fù)制到剪切板
String content = "需要copy的信息";
ClipboarManager cm =(ClipboarManager)getSystemService(Context.CLIPBOARD_SERVICE);
ClipData mClipData = ClipData.newPlainText(null, content);  
cm.setPrimaryClip(mClipData);  
  • 取數(shù)據(jù):Activity2 從粘貼板中取出數(shù)據(jù)
ClipboarManager clipboarManager=(ClipboarManager)getSystemService(Context.CLIPBOARD_SERVICE);
String content = clipData.getItemAt(0).getText().toString();

(2) 實現(xiàn)應(yīng)用間的數(shù)據(jù)共享(應(yīng)用內(nèi)傳遞數(shù)據(jù))

原理:Android所用應(yīng)用公用一個粘貼板,在其他應(yīng)用中復(fù)制文字,就是將復(fù)制的信息放到了系統(tǒng)粘貼板,所以我們可以在自己的應(yīng)用內(nèi)直接讀取系統(tǒng)粘貼板上的信息。

如:復(fù)制百度或短信應(yīng)用中的一段文字,然后打開PasteActivity頁面,就能得到的你復(fù)制的內(nèi)容。

  • 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();

    }

    /**
     * 獲取粘貼板上存放的內(nèi)容并顯示
     */
    private void getClipContent() {
        if(mClipboardManager.hasPrimaryClip()) {//判斷當前剪貼板上存在Copy
            //獲取粘貼板上存放的內(nèi)容
            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="粘貼板上存放的內(nèi)容為:"/>
    <TextView
        android:id="@+id/tv_content"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textColor="#FF0000"/>

</LinearLayout>

拓展:淘寶寶貝分享到微信,在微信中復(fù)制鏈接(將一個URL放到剪貼板上),然后打開淘寶可跳轉(zhuǎn)到該寶貝(從粘貼板上讀取URL),該業(yè)務(wù)邏輯的實現(xiàn)可能就是使用了剪貼板來實現(xiàn)應(yīng)用間的數(shù)據(jù)共享。尚未深入研究,這里僅做猜想,如猜想有誤,還請多多指教。

(3) 實現(xiàn)自由復(fù)制TextView等控件的文字

只需在該控件上加上android:textIsSelectable="true",或者在java代碼加 setTextIsSelectable(true) 即可實現(xiàn)。

  • 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);//設(shè)置文本可被選中進行復(fù)制*/
        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;
        }
    }

    /**
     * 獲取粘貼板上存放的內(nèi)容并顯示
     */
    private void getClipContent() {
        if(mClipboardManager.hasPrimaryClip()) {//判斷當前剪貼板上存在Copy
            //獲取粘貼板上存放的內(nèi)容
            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="可以復(fù)制我哦"
        android:textSize="30sp"
        android:textIsSelectable="true"/>
    <Button
        android:id="@+id/get_content"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="點擊獲取粘貼板內(nèi)容"
        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>
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

友情鏈接更多精彩內(nèi)容