剪贴板Sample
介绍
本示例主要使用@ohos.pasteboard 展示了剪贴板的能力,包括基础功能、支持查询剪贴板数据类型、支持查询剪贴板数据是否来自跨设备、使用系统安全控件读取剪贴板、通过ctrl v访问剪贴板数据。
效果预览
| 首页 |
|---|
![]() |
使用说明
- 在主界面,应用第一次安装时,弹出剪切板授权请求,点击“仅本次允许”进行用户授权;
- 在主界面,文本框中输入文本,点击“复制”按钮,文本内容即可由文本框拷贝到剪切板;
- 在主界面,点击“粘贴”按钮,文本内容即可由剪切板到文本框;
- 在主界面,点击“文本粘贴”按钮,文本类型的内容即可由剪切板到文本框;
- 在主界面,点击粘贴控件,文本类型的内容即可由剪切板到文本框;
- 在主界面,点击"跨设备粘贴"按钮,可将跨设备剪切板中的内容到文本框;
- 设备外接键盘,焦点放在文本框中,点击ctrl+v,文本内容即可由剪切板到文本框;
工程目录
entry/src/main/ets/
|---entryAbility
|---pages|
| |---Index.ets // 首页
具体实现
场景一:基础功能场景
数据复制
- 输入:复制
- 处理:将数据写入剪贴板
- 输出:复制成功
数据粘贴
- 输入:粘贴
- 处理:读取剪贴板数据
- 输出:粘贴成功
场景二:查询剪贴板数据类型
- 输入:仅文本粘贴
- 处理:查询剪贴板是否有文本类型数据 hasDataType
- 输出:有数据则粘贴成功
场景三:查询剪贴板数据是否来自跨设备
- 输入:仅跨设备粘贴
- 处理:查询剪贴板数据是否来自跨设备
- 输出:有则粘贴成功
场景四:通过安全控件的粘贴按钮访问剪贴板数据
- 输入:安全控件粘贴
- 处理:集成安全控件的粘贴控件,通过粘贴控件访问剪贴板数据
- 输出:粘贴成功
场景五:通过ctrl v访问剪贴板数据
- 输入:外接键盘,按ctrl + v
- 处理:默认实现
- 输出:粘贴成功
相关权限
ohos.permission.READ_PASTEBOARD 允许应用访问剪贴板
依赖
不涉及
约束与限制
- 本示例仅支持标准系统上运行,支持设备:RK3568。
- 本示例为Stage模型,仅支持API12版本SDK,SDK版本号(API Version 12 Release),镜像版本号(OpenHarmony 5.0.0.25及更高版本)。
- 本示例需要使用DevEco Studio 版本号(4.1Release)及以上版本才可编译运行。
- 本示例涉及调用系统权限的接口,需要配置允许权限列表,可以参考特殊权限配置方法 ,在配置文件中的“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
