Window系統(tǒng)一樣例书,Android也有剪切板友多。Android提供了一個強大的剪切板框架昧捷,SDK API 11 之后框架主要涉及到ClipboardManager闲昭、ClipData 和 ClipData.Item這三個類。
- ClipboardManager: 表示一個剪貼板
- ClipData: 剪貼板中保存的所有剪貼數(shù)據(jù)集(剪貼板可同時復制/保存多條多種數(shù)據(jù)條目)
- ClipData.Item: 剪貼數(shù)據(jù)集中的一個數(shù)據(jù)條目
1. 主要API介紹
(1) 獲取剪貼板管理器
ClipboardManager cm = (ClipboardManager)getSystemService(Context.CLIPBOARD_SERVICE);
(2) 創(chuàng)建能夠存入剪貼板的ClipData對象
說明: 早期版本的Android剪切板只能復制文本(可以為復合文本)信息靡挥。在API 11后對ClipboardManager進行了升級序矩,可以通過 ClipData 來復制文本(普通字符型)、Uri (URL 型)和 Intent(Intent 型)三種數(shù)據(jù)跋破。
- 普通字符:就是普通字符串的剪切簸淀,復制瓶蝴,粘貼。
- URL:在復制的時候可以復制一個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ù)復制到剪貼板
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. 剪貼板的主要操作
- 復制:復制信息到粘貼板
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ù)復制到剪貼板
}
- 粘貼:從粘貼板獲取信息
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ù)集中獲鹊荨(粘貼)文本數(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ù)改變");
}
});
}
/**
* 粘貼板(復制):實現(xiàn)文本復制功能
*/
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ù)復制到剪貼板
}
/**
* 粘貼板(粘貼):獲取系統(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("需被復制到粘貼板的文本");
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ù)復制到粘貼板和從粘貼板中取出數(shù)據(jù)屈糊。
- 存數(shù)據(jù):Activity1 把數(shù)據(jù)復制到剪切板
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)用中復制文字琼了,就是將復制的信息放到了系統(tǒng)粘貼板逻锐,所以我們可以在自己的應(yīng)用內(nèi)直接讀取系統(tǒng)粘貼板上的信息。
如:復制百度或短信應(yīng)用中的一段文字雕薪,然后打開PasteActivity頁面昧诱,就能得到的你復制的內(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>
拓展:淘寶寶貝分享到微信所袁,在微信中復制鏈接(將一個URL放到剪貼板上)盏档,然后打開淘寶可跳轉(zhuǎn)到該寶貝(從粘貼板上讀取URL),該業(yè)務(wù)邏輯的實現(xiàn)可能就是使用了剪貼板來實現(xiàn)應(yīng)用間的數(shù)據(jù)共享纲熏。尚未深入研究妆丘,這里僅做猜想锄俄,如猜想有誤,還請多多指教勺拣。
(3) 實現(xiàn)自由復制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è)置文本可被選中進行復制*/
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="可以復制我哦"
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>