harmony 鸿蒙使用剪贴板进行复制粘贴

2025-06-12
浏览 (8)

使用剪贴板进行复制粘贴

场景介绍

剪贴板为开发者提供数据的复制粘贴能力。当需要使用复制粘贴等功能时，例如：复制文字内容到备忘录中粘贴，复制图库照片到文件管理粘贴，就可以通过剪贴板来完成。

约束限制

剪贴板内容包含剪贴板系统服务元数据和应用设置的数据，总大小上限默认为128MB，PC/2in1设备可通过系统配置修改上限，有效范围为128MB~2GB。
为保证剪贴板数据的准确性，同一时间只能支持一个复制操作。
API version 12及之后，系统为提升用户隐私安全保护能力，剪贴板读取接口增加权限管控。

使用基础数据类型进行复制粘贴

剪贴板支持使用基础数据类型进行复制粘贴，当前支持的基础数据类型有文本、HTML、URI、Want、PixelMap。ArkTS接口与NDK接口支持数据类型不完全一致，使用时须匹配接口支持类型。

新开发的应用建议使用本方案实现复制粘贴功能。

ArkTS接口与NDK接口数据类型对应关系

ArkTS数据类型	NDK数据类型
MIMETYPE_PIXELMAP : “pixelMap”	UDMF_META_OPENHARMONY_PIXEL_MAP : “openharmony.pixle-map”
MIMETYPE_TEXT_HTML : “text/html”	UDMF_META_HTML : “general.html”
MIMETYPE_TEXT_PLAIN : “text/plain”	UDMF_META_PLAIN_TEXT : “general.plain-text”
MIMETYPE_TEXT_URI : “text/uri”	UDMF_META_GENERAL_FILE_URI : “general.file-uri”
MIMETYPE_TEXT_WANT : “text/want”	NDK接口不支持该数据类型。

ArkTS数据类型对应剪贴板类型，详见ohos.pasteboard。NDK数据类型对应统一数据管理框架，详见UDMF。

接口说明

详细接口见接口文档。

使用剪贴板getData接口获取到uri类型数据之后，请使用文件管理的fs.copy接口获取文件。

名称	说明
setData(data: PasteData, callback: AsyncCallback<void>): void	将数据写入系统剪贴板，使用callback异步回调。
setData(data: PasteData): Promise<void>	将数据写入系统剪贴板，使用Promise异步回调。
getData( callback: AsyncCallback<PasteData>): void	读取系统剪贴板内容，使用callback异步回调。
getData(): Promise<PasteData>	读取系统剪贴板内容，使用Promise异步回调。
getDataSync(): PasteData	读取系统剪贴板内容, 此接口为同步接口，不能与SetData同线程调用。

示例代码

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { BusinessError, pasteboard } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  async onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): Promise<void> {
    // 获取系统剪贴板对象
    let text = "test";
    // 创建一条纯文本类型的剪贴板内容对象
    let pasteData = pasteboard.createData(pasteboard.MIMETYPE_TEXT_PLAIN, text);
    // 将数据写入系统剪贴板
    let systemPasteboard = pasteboard.getSystemPasteboard();
    await systemPasteboard.setData(pasteData);
    //从系统剪贴板中读取数据
    systemPasteboard.getData().then((data) => {
      let outputData = data;
      // 从剪贴板数据中获取条目数量
      let recordCount = outputData.getRecordCount();
      // 从剪贴板数据中获取对应条目信息
      for (let i = 0; i < recordCount; i++) {
        let record = outputData.getRecord(i).toPlainText();
        console.log('Get data success, record:' + record);
      }
    }).catch((error: BusinessError) => {
      // 处理异常场景
    })
  }
}

使用统一数据类型进行复制粘贴

为了方便剪贴板与其他应用间进行数据交互，减少数据类型适配的工作量，剪贴板支持使用统一数据对象进行复制粘贴。详细的统一数据对象请见标准化数据通路文档介绍。

剪贴板支持使用基础数据类型进行复制粘贴，当前支持的基础数据类型有文本、HTML。ArkTS接口与NDK接口支持数据类型不完全一致，使用时须匹配接口支持类型。

接口说明

详细接口见接口文档。

名称	说明
setUnifiedData(data: udc.UnifiedData): Promise<void>	将统一数据对象的数据写入系统剪贴板。
setUnifiedDataSync(data: udc.UnifiedData): void	将统一数据对象的数据写入系统剪贴板，此接口为同步接口。
getUnifiedData(): Promise<udc.UnifiedData>	从系统剪贴板中读取统一数据对象的数据。
getUnifiedDataSync(): udc.UnifiedData	从系统剪贴板中读取统一数据对象的数据，此接口为同步接口。

示例代码

import {BusinessError, pasteboard} from '@kit.BasicServicesKit';
import { unifiedDataChannel, uniformDataStruct, uniformTypeDescriptor } from '@kit.ArkData';

// 构造一条PlainText数据
let plainText : uniformDataStruct.PlainText = {
    uniformDataType: uniformTypeDescriptor.UniformDataType.PLAIN_TEXT,
    textContent : 'PLAINTEXT_CONTENT',
    abstract : 'PLAINTEXT_ABSTRACT',
}
let record = new unifiedDataChannel.UnifiedRecord(uniformTypeDescriptor.UniformDataType.PLAIN_TEXT, plainText);
let data = new unifiedDataChannel.UnifiedData();
data.addRecord(record);

// 向系统剪贴板中存入一条PlainText数据
let systemPasteboard: pasteboard.SystemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.setUnifiedData(data).then((data: void) => {
    console.info('Succeeded in setting UnifiedData.');
    // 存入成功，处理正常场景
}).catch((err: BusinessError) => {
    console.error('Failed to set UnifiedData. Cause: ' + err.message);
    // 处理异常场景
});

// 从系统剪贴板中读取这条text数据
systemPasteboard.getUnifiedData().then((data) => {
    let records: Array<unifiedDataChannel.UnifiedRecord> = data.getRecords();
    for (let j = 0; j < records.length; j++) {
        if (records[j].getType() === uniformTypeDescriptor.UniformDataType.PLAIN_TEXT) {
            let text = records[j].getValue() as uniformDataStruct.PlainText;
            console.info(`${j + 1}.${text.textContent}`);
        }
    }
}).catch((err: BusinessError) => {
    console.error('Failed to get UnifiedData. Cause: ' + err.message);
    // 处理异常场景
});

你可能感兴趣的鸿蒙文章

harmony 鸿蒙剪贴板服务

harmony 鸿蒙申请访问剪贴板权限

harmony 鸿蒙使用剪贴板进行复制粘贴 (C/C++)

harmony 鸿蒙使用剪贴板进行延迟复制粘贴

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/9fLhsD

harmony 鸿蒙使用剪贴板进行复制粘贴

使用剪贴板进行复制粘贴

场景介绍

约束限制

使用基础数据类型进行复制粘贴

ArkTS接口与NDK接口数据类型对应关系

接口说明

示例代码

使用统一数据类型进行复制粘贴

接口说明

示例代码

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录