1. 程式人生 > >Android Clipboard(複製/剪貼簿)

Android Clipboard(複製/剪貼簿)

Android提供的剪貼簿框架,複製和貼上不同型別的資料。資料可以是文字,影象,二進位制流資料或其它複雜的資料型別。

Android提供ClipboardManager、ClipData.Item和ClipData庫使用複製和貼上的框架。為了使用剪貼簿的框架,需要把資料轉化為剪輯物件,然後把該物件為全系統剪貼簿。

為了使用剪貼簿,需要通過呼叫getSystemService()方法來例項化ClipboardManager的物件。它的語法如下:

ClipboardManager myClipboard;
myClipboard = (ClipboardManager)getSystemService(CLIPBOARD_SERVICE);

複製資料

需要做的下一件事就是通過呼叫ClipData類的資料方法的相應型別來例項化ClipData物件。如果文字資料在newPlainText方法被呼叫。必須將資料設定為剪貼簿管理器物件的剪輯。它的語法如下:

ClipData myClip;
String text = "hello world";
myClip = ClipData.newPlainText("text", text);
myClipboard.setPrimaryClip(myClip);

ClipData物件可以採取這三種形式和下面的函式用於建立的那些形式。

Sr.NoClipData形式與方法
1 Text
newPlainText(label, text)
返回ClipData物件,其單個ClipData.Item物件包含一個文字字串
2 URI
newUri(resolver, label, URI)
返回ClipData物件,其單ClipData.Item物件包含一個URI
3 Intent
newIntent(label, intent)
返回ClipData物件,其單ClipData.Item物件包含意圖

貼上資料

為了貼上資料,先要通過呼叫getPrimaryClip()方法拿到剪輯。並從點選就可 ClipData.Item 物件的專案。從物件將得到資料。它的語法如下:

ClipData abc = myClipboard.getPrimaryClip();
ClipData.Item item = abc.getItemAt(0);
String text = item.getText().toString();

除了這些方法,也有用於管理剪貼簿框架提供 ClipboardManager類的其他方法。這些方法如下:

Sr.No方法及說明
1 getPrimaryClip()
這個方法只是返回剪貼簿上的當前主片段
2 getPrimaryClipDescription()
此方法返回剪貼簿上的當前主剪輯的說明,但不是它的資料的一個拷貝
3 hasPrimaryClip()
如果當前剪貼簿上的主要片段此方法返回true
4 setPrimaryClip(ClipData clip)
此方法將剪貼簿上的當前主片段
5 setText(CharSequence text)
這種方法可直接用於複製文字到剪貼簿
6 getText()
這種方法可直接用於獲取剪貼簿複製的文字

例子

這裡有一個例子演示如何使用ClipboardManager類。它建立了一個基本的複製貼上應用程式,可讓您複製的文字,然後通過剪貼簿貼上。

為了試驗這個例子,可以在實際裝置或模擬器執行此程式。

Steps描述
1 使用Android Studio建立Android應用程式,並將其命名為:Clipboard 。建立這個專案時確保目標SDK編譯在Android SDK中的最新版本或使用更高級別的API。
2 修改 src/MainActivity.java 檔案新增必要的程式碼
3 修改res/layout/activity_main.xml 新增相應的XML元件
4 修改 res/values/string. xml新增必要的字串組成部分
5 執行應用程式並選擇執行Android的裝置,並在其上安裝的應用和驗證結果

以下是修改後的主活動檔案的內容src/com.yiibai.clipboard/MainActivity.java.

package com.example.clipboard;

import android.annotation.SuppressLint;
import android.app.Activity;
import android.content.ClipData;
import android.content.ClipboardManager;
import android.os.Bundle;
import android.view.Menu;
import android.view.View;
import android.widget.EditText;
import android.widget.Toast;

public class MainActivity extends Activity {

   private ClipboardManager myClipboard;
   private ClipData myClip;
   private EditText copyField,pasteField;
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      myClipboard = (ClipboardManager)getSystemService(CLIPBOARD_SERVICE);
      copyField = (EditText)findViewById(R.id.editText1);
      pasteField = (EditText)findViewById(R.id.editText2);

   }

   @SuppressLint("NewApi")
   public void copy(View view){
      String text = copyField.getText().toString();
      myClip = ClipData.newPlainText("text", text);
      myClipboard.setPrimaryClip(myClip);
      Toast.makeText(getApplicationContext(), "Text Copied", 
      Toast.LENGTH_SHORT).show();
   }

   @SuppressLint("NewApi")