位置:首頁 > 手機開發 > Android開發教學 > 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.No ClipData形式與方法
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")
   public void paste(View view){
      ClipData abc = myClipboard.getPrimaryClip();
      ClipData.Item item = abc.getItemAt(0);
      String text = item.getText().toString();
      pasteField.setText(text);
      Toast.makeText(getApplicationContext(), "Text Pasted", 
      Toast.LENGTH_SHORT).show();
   }

   @Override
   public boolean onCreateOptionsMenu(Menu menu) {
      // Inflate the menu; this adds items to the action bar if it is present.
      getMenuInflater().inflate(R.menu.main, menu);
      return true;
   }

}

以下是經修改res/layout/activity_main.xml 的內容

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:paddingBottom="@dimen/activity_vertical_margin"
   android:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   tools:context=".MainActivity" >

   <TextView
      android:id="@+id/textView1"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignParentLeft="true"
      android:layout_alignParentTop="true"
      android:layout_marginLeft="25dp"
      android:layout_marginTop="19dp"
      android:text="@string/copytext"
      android:textAppearance="?android:attr/textAppearanceLarge" />

   <EditText
      android:id="@+id/editText1"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignLeft="@+id/textView1"
      android:layout_below="@+id/textView1"
      android:layout_marginTop="20dp"
      android:ems="10" >

      <requestFocus />
   </EditText>

   <TextView
      android:id="@+id/textView2"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignLeft="@+id/editText1"
      android:layout_centerVertical="true"
      android:text="@string/pastetext"
      android:textAppearance="?android:attr/textAppearanceLarge" />

   <Button
      android:id="@+id/button1"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignLeft="@+id/editText1"
      android:layout_below="@+id/editText1"
      android:layout_marginLeft="65dp"
      android:layout_marginTop="20dp"
      android:onClick="copy"
      android:text="@string/copy" />

   <EditText
      android:id="@+id/editText2"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignLeft="@+id/textView2"
      android:layout_below="@+id/textView2"
      android:layout_marginTop="39dp"
      android:ems="10" />

   <Button
      android:id="@+id/button2"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignLeft="@+id/button1"
      android:layout_below="@+id/editText2"
      android:layout_marginTop="34dp"
      android:onClick="paste"
      android:text="@string/paste" />

</RelativeLayout>

以下是 res/values/string.xml 的內容

<?xml version="1.0" encoding="utf-8"?>
<resources>

   <string name="app_name">Clipboard</string>
   <string name="action_settings">Settings</string>
   <string name="hello_world">Hello world!</string>
   <string name="copy">Copy Text</string>
   <string name="paste">Paste Text</string>
   <string name="copytext">Text to copy</string>
   <string name="pastetext">Copied Text</string>
</resources>

以下是 AndroidManifest.xml 文件的內容:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.yiibai.clipboard"
   android:versionCode="1"
   android:versionName="1.0" >

   <uses-sdk
      android:minSdkVersion="8"
      android:targetSdkVersion="17" />

   <application
      android:allowBackup="true"
      android:icon="@drawable/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      <activity
         android:name="com.yiibai.clipboard.MainActivity"
         android:label="@string/app_name" >
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />

            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
      </activity>
   </application>

</manifest>

讓我們試著來運行修改剪貼板應用程序。安裝AVD並啟動程序,如果一切設置和應用程序都冇有問題,它會顯示以下仿真器窗口:

Anroid clipboard Tutorial

現在隻是在文本輸入任何文字複製字段,然後選擇複製文本按鈕。下麵的通知將顯示其顯示如下:

Android Clipboard(複製/剪貼板)

現在,隻要按下按鈕,粘貼,會看到它被複製,現在粘貼複製的文本的字段中的文本。它如下所示:

Android Clipboard(複製/剪貼板)
以上代碼下載:http://pan.baidu.com/s/1kTiiZVh