• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1#  剪贴板Sample
2
3### 介绍
4
5 本示例主要使用[@ohos.pasteboard](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-pasteboard.md) 展示了剪贴板的能力，包括基础功能、支持查询剪贴板数据类型、支持查询剪贴板数据是否来自跨设备、使用系统安全控件读取剪贴板、通过ctrl v访问剪贴板数据。
6
7
8### 效果预览
9
10|               首页               |
11|:------------------------------: |
12| ![main](screenshots/first.png) |
13
14
15使用说明
161. 在主界面，应用第一次安装时，弹出剪切板授权请求，点击“仅本次允许”进行用户授权；
172. 在主界面，文本框中输入文本，点击“复制”按钮，文本内容即可由文本框拷贝到剪切板；
183. 在主界面，点击“粘贴”按钮，文本内容即可由剪切板到文本框；
194. 在主界面，点击“文本粘贴”按钮，文本类型的内容即可由剪切板到文本框；
205. 在主界面，点击粘贴控件，文本类型的内容即可由剪切板到文本框；
216. 在主界面，点击"跨设备粘贴"按钮，可将跨设备剪切板中的内容到文本框；
227. 设备外接键盘，焦点放在文本框中，点击ctrl+v，文本内容即可由剪切板到文本框；
23
24### 工程目录
25
26```
27entry/src/main/ets/
28|---entryAbility
29|---pages|
30|   |---Index.ets      // 首页
31```
32
33### 具体实现
34
35#### 场景一：基础功能场景
36
37##### 数据复制
38
39* 输入：复制
40* 处理：将数据写入剪贴板
41* 输出：复制成功
42
43#### 数据粘贴
44* 输入：粘贴
45* 处理：读取剪贴板数据
46* 输出：粘贴成功
47
48
49#### 场景二：查询剪贴板数据类型
50
51* 输入：仅文本粘贴
52* 处理：查询剪贴板是否有文本类型数据 hasDataType
53* 输出：有数据则粘贴成功
54
55
56#### 场景三：查询剪贴板数据是否来自跨设备
57* 输入：仅跨设备粘贴
58* 处理：查询剪贴板数据是否来自跨设备
59* 输出：有则粘贴成功
60
61
62#### 场景四：通过安全控件的粘贴按钮访问剪贴板数据
63* 输入：安全控件粘贴
64* 处理：集成安全控件的粘贴控件，通过粘贴控件访问剪贴板数据
65* 输出：粘贴成功
66
67
68#### 场景五：通过ctrl v访问剪贴板数据
69* 输入：外接键盘，按ctrl + v
70* 处理：默认实现
71* 输出：粘贴成功
72
73
74### 相关权限
75
76[ohos.permission.READ_PASTEBOARD](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-system-apps.md#ohospermissionread_pasteboard) 允许应用访问剪贴板
77
78### 依赖
79
80不涉及
81
82### 约束与限制
83
841. 本示例仅支持标准系统上运行，支持设备：RK3568。
852. 本示例为Stage模型，仅支持API12版本SDK，SDK版本号(API Version 12 Release),镜像版本号(OpenHarmony 5.0.0.25及更高版本)。
863. 本示例需要使用DevEco Studio 版本号(4.1Release)及以上版本才可编译运行。
874. 本示例涉及调用系统权限的接口，需要配置允许权限列表，可以参考[特殊权限配置方法](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/security/hapsigntool-overview.md/) ，在配置文件中的“allowed-acls”字段中增加"ohos.permission.READ_PASTEBOARD"权限，ohos.permission.REQUIRE_FORM为system_basic级别。
88
89### 下载
90
91如需单独下载本工程，执行如下命令：
92
93    git init
94    git config core.sparsecheckout true
95    echo code/BasicFeature/DataManagement/pasteboard/ > .git/info/sparse-checkout
96    git remote add origin https://gitee.com/openharmony/applications_app_samples.git
97    git pull origin master
98