一、剪贴板概述

• 用户通过系统剪贴板服务，可实现应用之间的简单数据传递。例如：在应用 A 中复制的数据，可以在应用 B 中粘贴，反之亦可。
• HarmonyOS 提供系统剪贴板服务的操作接口，支持用户程序从系统剪贴板中读取、写入和查询剪贴板数据，以及添加、移除系统剪贴板数据变化的回调。
• HarmonyOS 提供剪贴板数据的对象定义，包含内容对象和属性对象。

二、使用场景

• 同一设备的应用程序 A、B 之间可以借助系统剪贴板服务完成简单数据的传递，即应用程序 A 向剪贴板服务写入数据后，应用程序 B 可以从中读取出数据。
• 剪贴板服务如下所示：

• 在使用剪贴板服务时，需要注意以下几点：
• • 只有在前台获取到焦点的应用才有读取系统剪贴板的权限（系统默认输入法应用除外）；
• • 写入到剪贴板服务中的剪贴板数据不会随应用程序结束而销毁；
• • 对同一用户而言，写入剪贴板服务的数据会被下一次写入的剪贴板数据所覆盖；
• • 在同一设备内，剪贴板单次传递内容不应超过 500 KB。

三、API 说明

① 剪贴板 API

• SystemPasteboard 提供系统剪贴板操作的相关接口，比如复制、粘贴、配置回调等。
• PasteData 是剪贴板服务操作的数据对象，一个 PasteData 由若干个内容节点（PasteData.Record）和一个属性集合对象（PasteData.DataProperty）组成。
• Record 是存放剪贴板数据内容信息的最小单位，每个 Record 都有其特定的 MIME 类型，如纯文本、HTML、URI、Intent。
• 剪贴板数据的属性信息存在放 PasteData.DataProperty 中，包括标签、时间戳等。

② SystemPasteboard

• SystemPasteboard 提供系统剪贴板服务的操作接口，比如复制、粘贴、配置回调等。
• SystemPasteboard 的主要接口如下表所示：

② PasteData

• PasteData 是剪贴板服务操作的数据对象，其中内容节点定义为 PasteData.Record，属性集合定义为 PasteData.DataProperty。
• PasteData 的主要接口如下表所示：

• PasteData 中定义的常量如下：

③ PasteData.Record

• 一个 PasteData 中包含若干个特定 MIME 类型的 PasteData.Record，每个 Record 是存放剪贴板数据内容信息的最小单位。
• PasteData.Record 的主要接口如下所示：

④ PasteData.DataProperty

• 每个 PasteData 中都有一个 PasteData.DataProperty 成员，其中存放着该数据对象的属性集合，例如自定义标签、MIME 类型集合列表等。
• PasteData.DataProperty 的主要接口如下：

⑤ IPasteDataChangedListener

• IPasteDataChangedListener 是定义剪贴板数据变化回调的接口类，开发者需要实现此接口来编码触发回调时的处理逻辑。
• IPasteDataChangedListener 的主要接口如下：

四、使用流程

• 应用 A 获取系统剪贴板服务：

SystemPasteboard pasteboard = SystemPasteboard.getSystemPasteboard(appContext);

• 应用 A 向系统剪贴板中写入一条纯文本数据：

if (pasteboard != null) {
	    pasteboard.setPasteData(PasteData.creatPlainTextData("Hello, world!"));
	}

• 应用 B 从系统剪贴板读取数据，将数据对象中的首个文本类型（纯文本/HTML）内容信息在控件中显示，忽略其它类型内容：

PasteData pasteData = pasteboard.getPasteData();
	if (pasteData == null) {
	    return;
	}
	DataProperty dataProperty = pasteData.getProperty();
	boolean hasHtml = dataProperty.hasMimeType(PasteData.MIMETYPE_TEXT_HTML);
	boolean hasText = dataProperty.hasMimeType(PasteData.MIMETYPE_TEXT_PLAIN);
	if (hasHtml || hasText) {
	    Text text = (Text) findComponentById(ResourceTable.Id_text);
	    for (int i = 0; i < pasteData.getRecordCount(); i++) {
	        PasteData.Record record = pasteData.getRecordAt(i);
	        String mimeType = record.getMimeType();
	        if (mimeType.equals(PasteData.MIMETYPE_TEXT_HTML)) {
	            text.setText(record.getHtmlText());
	            break;
	        } else if (mimeType.equals(PasteData.MIMETYPE_TEXT_PLAIN)) {
	            text.setText(record.getPlainText().toString());
	            break;
	        } else {
	            // skip records of other Mime type 
	        }
	    }
	}

• 应用 C 注册添加系统剪贴板数据变化回调，当系统剪贴板数据发生变化时触发处理逻辑：

IPasteDataChangedListener listener = new IPasteDataChangedListener() {
	    @Override
	    public void onChanged() {
	        PasteData pasteData = pasteboard.getPasteData();
	        if (pasteData == null) {
	            return;
	        }
	        // Operations to handle data change on the system pasteboard
	    }
	};
	pasteboard.addPasteDataChangedListener(listener);