187d2334创建于 2025年6月12日历史提交

剪贴板Sample

介绍

本示例主要使用@ohos.pasteboard 展示了剪贴板的能力,包括基础功能、支持查询剪贴板数据类型、支持查询剪贴板数据是否来自跨设备、使用系统安全控件读取剪贴板、通过ctrl v访问剪贴板数据。

效果预览

首页
main

使用说明

  1. 在主界面,应用第一次安装时,弹出剪切板授权请求,点击“仅本次允许”进行用户授权;
  2. 在主界面,文本框中输入文本,点击“复制”按钮,文本内容即可由文本框拷贝到剪切板;
  3. 在主界面,点击“粘贴”按钮,文本内容即可由剪切板到文本框;
  4. 在主界面,点击“文本粘贴”按钮,文本类型的内容即可由剪切板到文本框;
  5. 在主界面,点击粘贴控件,文本类型的内容即可由剪切板到文本框;
  6. 在主界面,点击"跨设备粘贴"按钮,可将跨设备剪切板中的内容到文本框;
  7. 设备外接键盘,焦点放在文本框中,点击ctrl+v,文本内容即可由剪切板到文本框;

工程目录

entry/src/main/ets/
|---entryAbility
|---pages|   
|   |---Index.ets      // 首页

具体实现

场景一:基础功能场景

数据复制
  • 输入:复制
  • 处理:将数据写入剪贴板
  • 输出:复制成功

数据粘贴

  • 输入:粘贴
  • 处理:读取剪贴板数据
  • 输出:粘贴成功

场景二:查询剪贴板数据类型

  • 输入:仅文本粘贴
  • 处理:查询剪贴板是否有文本类型数据 hasDataType
  • 输出:有数据则粘贴成功

场景三:查询剪贴板数据是否来自跨设备

  • 输入:仅跨设备粘贴
  • 处理:查询剪贴板数据是否来自跨设备
  • 输出:有则粘贴成功

场景四:通过安全控件的粘贴按钮访问剪贴板数据

  • 输入:安全控件粘贴
  • 处理:集成安全控件的粘贴控件,通过粘贴控件访问剪贴板数据
  • 输出:粘贴成功

场景五:通过ctrl v访问剪贴板数据

  • 输入:外接键盘,按ctrl + v
  • 处理:默认实现
  • 输出:粘贴成功

相关权限

ohos.permission.READ_PASTEBOARD 允许应用访问剪贴板

依赖

不涉及

约束与限制

  1. 本示例仅支持标准系统上运行,支持设备:RK3568。
  2. 本示例为Stage模型,仅支持API12版本SDK,SDK版本号(API Version 12 Release),镜像版本号(OpenHarmony 5.0.0.25及更高版本)。
  3. 本示例需要使用DevEco Studio 版本号(4.1Release)及以上版本才可编译运行。
  4. 本示例涉及调用系统权限的接口,需要配置允许权限列表,可以参考特殊权限配置方法 ,在配置文件中的“allowed-acls”字段中增加"ohos.permission.READ_PASTEBOARD"权限,ohos.permission.REQUIRE_FORM为system_basic级别。

下载

如需单独下载本工程,执行如下命令:

git init
git config core.sparsecheckout true
echo code/BasicFeature/DataManagement/pasteboard/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master