Android 简明教程

Android - Clipboard

Android 提供了用于复制和粘贴不同类型数据的剪贴板框架。数据可以是文本、图像、二进制流数据或其他复杂的数据类型。

Android 提供了 ClipboardManager 库和 ClipData 和 ClipData.item 以便使用复制和粘贴框架。为了使用剪贴板框架,您需要将数据放入剪贴对象中,然后将该对象放入系统范围的剪贴板中。

为了使用剪贴板,您需要通过调用 getSystemService() 方法实例化 ClipboardManager 对象。它的语法如下所示 −

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

Copying data

接下来,您需要通过调用 ClipData 类的相应类型的数据方法来实例化 ClipData 对象。对于文本数据,将调用 newPlainText 方法。之后,您必须将该数据设置为剪贴板管理器对象的剪贴。它的语法如下所示 −

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

ClipData 对象可以采用这三种形式,并且以下函数用于创建这些形式。

Sr.No

ClipData Form & Method

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 对象包含一个 Intent。

Pasting data

为了粘贴数据,我们将首先通过调用 getPrimaryClip() 方法获取剪贴。然后从该点击,我们将获得 ClipData.Item 对象中的项目。然后从对象中获取数据。它的语法如下所示 −

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

除了这些方法之外,ClipboardManager 类还提供了其他方法来管理剪贴板框架。这些方法在下表中列出:

Sr.No

Method & description

1

getPrimaryClip() 该方法仅返回剪贴板上当前的主剪贴。

2

getPrimaryClipDescription() 该方法返回剪贴板上当前的主剪贴的描述,但不会将其数据的副本返回。

3

hasPrimaryClip() 如果剪贴板上当前有主剪贴,该方法会返回 true。

4

setPrimaryClip(ClipData clip) 该方法设置剪贴板上当前的主剪贴。

5

setText(CharSequence text) 此方法可直接用于将文本复制到剪贴板中。

6

getText() 此方法可直接用于从剪贴板获取复制的文本。

Example

下面是一个演示如何使用 ClipboardManager 类的示例。它创建一个基本的复制粘贴应用程序,允许您复制文本,然后通过剪贴板粘贴它。

要使用此示例,你可以在实际设备或模拟器上运行此示例。

Steps

Description

1

您将使用 Android Studio IDE 创建一个 Android 应用程序,位于包 com.example.sairamkrishna.myapplication 下。

2

修改 src/MainActivity.java 文件以添加必要的代码。

3

修改 res/layout/activity_main 以添加各自的 XML 组件

4

运行应用程序并选择正在运行的 Android 设备,并将应用程序安装在其上并验证结果

以下是修改的主活动文件 src/MainActivity.java 的内容。

package com.example.sairamkrishna.myapplication;

import android.content.ClipData;
import android.content.ClipboardManager;
import android.os.Bundle;

import android.support.v7.app.ActionBarActivity;
import android.view.View;

import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;


public class MainActivity extends ActionBarActivity {
   EditText ed1, ed2;
   Button b1, b2;

   private ClipboardManager myClipboard;
   private ClipData myClip;

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

      ed1 = (EditText) findViewById(R.id.editText);
      ed2 = (EditText) findViewById(R.id.editText2);

      b1 = (Button) findViewById(R.id.button);
      b2 = (Button) findViewById(R.id.button2);

      myClipboard = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);

      b1.setOnClickListener(new View.OnClickListener() {

         @Override
         public void onClick(View v) {
            String text;
            text = ed1.getText().toString();

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

            Toast.makeText(getApplicationContext(), "Text Copied",
               Toast.LENGTH_SHORT).show();
         }
      });

      b2.setOnClickListener(new View.OnClickListener() {

         @Override
         public void onClick(View v) {
            ClipData abc = myClipboard.getPrimaryClip();
            ClipData.Item item = abc.getItemAt(0);

            String text = item.getText().toString();
            ed2.setText(text);

            Toast.makeText(getApplicationContext(), "Text Pasted",
               Toast.LENGTH_SHORT).show();
         }
      });
   }

}

以下是修改后的 xml res/layout/activity_main.xml 内容。

<?xml version="1.0" encoding="utf-8"?>
<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:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   android:paddingBottom="@dimen/activity_vertical_margin"
   tools:context=".MainActivity">

   <TextView android:text="Example" android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textview"
      android:textSize="35dp"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true" />

   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorials point"
      android:id="@+id/textView"
      android:layout_below="@+id/textview"
      android:layout_centerHorizontal="true"
      android:textColor="#ff7aff24"
      android:textSize="35dp" />

   <ImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageView"
      android:src="@drawable/abc"
      android:layout_below="@+id/textView"
      android:layout_centerHorizontal="true" />

   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText"
      android:layout_alignParentRight="true"
      android:layout_alignParentEnd="true"
      android:hint="Copy text"
      android:layout_below="@+id/imageView"
      android:layout_alignLeft="@+id/imageView"
      android:layout_alignStart="@+id/imageView" />

   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText2"
      android:layout_alignLeft="@+id/editText"
      android:layout_alignStart="@+id/editText"
      android:hint="paste text"
      android:layout_below="@+id/editText"
      android:layout_alignRight="@+id/editText"
      android:layout_alignEnd="@+id/editText" />

   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Copy text"
      android:id="@+id/button"
      android:layout_below="@+id/editText2"
      android:layout_alignLeft="@+id/editText2"
      android:layout_alignStart="@+id/editText2" />

   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Paste text"
      android:id="@+id/button2"
      android:layout_below="@+id/editText2"
      android:layout_alignRight="@+id/editText2"
      android:layout_alignEnd="@+id/editText2" />

</RelativeLayout>

以下是 res/values/string.xml 的内容。

<resources>
   <string name="app_name">My Application</string>
</resources>

下面是 AndroidManifest.xml 文件的内容。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.sairamkrishna.myapplication" >

   <application
      android:allowBackup="true"
      android:icon="@drawable/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >

      <activity
         android:name="com.example.sairamkrishna.myapplication.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 。要在 Android Studio 中运行此应用,请打开项目的某个活动文件,然后从工具栏中单击 Run 图标。Android Studio 安装程序将显示以下图像:

clipboard

现在只需在 Text to copy 域中输入任意文本,然后选择 copy text 按钮。将显示以下通知,如下所示:

clipboard1

现在只需按下粘贴按钮,您将看到所复制的文本现已粘贴在 Copied Text 域中。如下所示:

clipboard2