目录
一、介绍
(一)ClipboardManager介绍
1、ClipboardManager常用方法:
2、获取ClipboardManager实例
(二)、ClipData介绍
1、创建ClipData对象:
2、获取ClipData的信息:
3、ClipData.Item对象:
二、 例子
复制粘贴的辅助类ClipboardHelper :
MainActivity:
activity_main:
运行结果:
一、介绍
(一)ClipboardManager介绍
ClipboardManager
是Android提供的一个系统服务,用于管理剪贴板内容。它允许您在应用程序之间复制和粘贴文本、链接、图像等数据。
1、ClipboardManager
常用方法:
setPrimaryClip(ClipData clip)
:将指定的ClipData
对象设置为主要剪贴板内容。这可以用于复制文本、链接、图像等到剪贴板。ClipData clipData = ClipData.newPlainText("label", "要复制的文本");clipboardManager.setPrimaryClip(clipData);
getPrimaryClip()
:获取主要剪贴板的内容。返回一个ClipData
对象,其中包含主要剪贴板中的数据。
ClipData clipData = clipboardManager.getPrimaryClip();if (clipData != null && clipData.getItemCount() > 0) {// 处理剪贴板内容}
hasPrimaryClip()
:检查主要剪贴板是否有内容。如果剪贴板包含了数据,则返回true
,否则返回false
。
if (clipboardManager.hasPrimaryClip()) {ClipData clipData = clipboardManager.getPrimaryClip();if (clipData != null && clipData.getItemCount() > 0) {CharSequence text = clipData.getItemAt(0).getText();// 使用获取到的文本进行操作}}
addPrimaryClipChangedListener(OnPrimaryClipChangedListener listener)
:注册一个剪贴板变化的监听器,以便在剪贴板内容发生变化时接收通知。
clipboardManager.addPrimaryClipChangedListener(new ClipboardManager.OnPrimaryClipChangedListener() {@Overridepublic void onPrimaryClipChanged() {// 剪贴板内容发生变化时执行相关操作}});
2、获取ClipboardManager实例
ClipboardManager clipboardManager = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
(二)、ClipData介绍
ClipData
是Android中用于在剪贴板中存储数据的类。它是一个不可变的数据容器,可以包含一个或多个ClipData.Item
对象,每个对象代表一项剪贴板内容。
1、创建ClipData
对象:
可以使用ClipData
类的静态方法newPlainText()
或newUri()
来创建一个新的ClipData
对象。
newPlainText(CharSequence label, CharSequence text)
:创建一个纯文本的ClipData
对象。需要提供标签(label)和要复制到剪贴板的文本内容(text)。
CharSequence label = "Label";CharSequence text = "要复制的文本";ClipData clipData = ClipData.newPlainText(label, text);
newUri(ContentResolver resolver, CharSequence label, Uri uri)
:创建一个包含URI的ClipData
对象。需要提供标签(label)、内容解析器(ContentResolver)以及要复制到剪贴板的URI。
CharSequence label = "Label";Uri uri = Uri.parse("");ClipData clipData = ClipData.newUri(getContentResolver(), label, uri);
2、获取ClipData
的信息:
ClipData
对象包含了剪贴板中的数据。您可以使用以下方法来访问和操作ClipData
的内容:
getItemCount()
:获取ClipData
中包含的项(ClipData.Item
)的数量。
int itemCount = clipData.getItemCount();
getItemAt(int index)
:获取在指定索引处的ClipData.Item
。
ClipData.Item item = clipData.getItemAt(index);
3、ClipData.Item
对象:
ClipData.Item
表示剪贴板中的一个项,可以是文本、链接或其他数据。通过ClipData
的方法,您可以访问和操作每个Item
对象:
getText()
:获取ClipData.Item
中的文本内容。
CharSequence text = item.getText();
getUri()
:获取ClipData.Item
中的URI。
Uri uri = item.getUri();
二、 例子
复制粘贴的辅助类ClipboardHelper :
package com.example.stardemo;import android.content.ClipData;import android.content.ClipboardManager;import android.content.Context;public class ClipboardHelper {private Context context;private ClipboardManager clipboardManager;public ClipboardHelper(Context context) {this.context = context;clipboardManager = (ClipboardManager) context.getSystemService(Context.CLIPBOARD_SERVICE);}/*** 将文本复制到剪贴板** @param text 要复制的文本*/public void copyText(String text) {ClipData clipData = ClipData.newPlainText("text", text);clipboardManager.setPrimaryClip(clipData);}/*** 从剪贴板获取文本** @return 剪贴板中的文本*/public String getCopiedText() {if (clipboardManager.hasPrimaryClip()) {ClipData clipData = clipboardManager.getPrimaryClip();if (clipData != null && clipData.getItemCount() > 0) {CharSequence text = clipData.getItemAt(0).getText();return text.toString();}}return null;}}
MainActivity:
package com.example.stardemo;import androidx.appcompat.app.AppCompatActivity;import android.os.Bundle;import android.view.View;import android.widget.TextView;import android.widget.Toast;public class MainActivity extends AppCompatActivity {TextView copeText,pasteText;ClipboardHelper mClipboardHelper;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);copeText = findViewById(R.id.copyText);pasteText = findViewById(R.id.pasteText);mClipboardHelper = new ClipboardHelper(this);copeText.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {mClipboardHelper.copyText(copeText.getText().toString());Toast.makeText(MainActivity.this, "复制成功", Toast.LENGTH_SHORT).show();}});pasteText.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {pasteText.setText(mClipboardHelper.getCopiedText());Toast.makeText(MainActivity.this, "粘贴成功", Toast.LENGTH_SHORT).show();}});}}
其中包含两个TextView
:copyText
和pasteText
。在点击copyText
时,它将使用ClipboardHelper
类将文本复制到剪贴板中,并显示一个Toast消息表示复制成功。在点击pasteText
时,它将从剪贴板中获取已复制的文本并设置为pasteText
的文本。
activity_main:
<?xml version="1.0" encoding="utf-8"?><androidx.constraintlayout.widget.ConstraintLayout xmlns:android="/apk/res/android"xmlns:app="/apk/res-auto"xmlns:tools="/tools"android:layout_width="match_parent"android:layout_height="match_parent"tools:context=".MainActivity"><TextViewandroid:id="@+id/copyText"android:layout_width="115dp"android:layout_height="100dp"android:gravity="center"android:text="Hello World!"android:textSize="18sp"app:layout_constraintBottom_toBottomOf="parent"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent"android:textColor="@color/black"app:layout_constraintVertical_bias="0.234" /><TextViewandroid:id="@+id/pasteText"android:background="@color/teal_200"android:textColor="@color/black"android:layout_width="115dp"android:layout_height="100dp"android:gravity="center"android:textSize="18sp"app:layout_constraintBottom_toBottomOf="parent"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent"app:layout_constraintVertical_bias="0.551" /></androidx.constraintlayout.widget.ConstraintLayout>