diff --git a/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md b/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
index e41944c75170b6c9d36d451a2500dcb77c7586e7..c28402c720e5f23a21fded716afaaa291603cee2 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
@@ -25,6 +25,7 @@ import pasteboard from '@ohos.pasteboard';
| MIMETYPE_TEXT_WANT7+ | string | 是 | 否 | Want的MIME类型定义。 |
| MIMETYPE_TEXT_PLAIN7+ | string | 是 | 否 | Plain text文本的MIME类型定义。 |
| MIMETYPE_TEXT_URI7+ | string | 是 | 否 | URI文本的MIME类型定义。 |
+| MIMETYPE_PIXELMAP9+ | string | 是 | 否 | PixelMap的MIME类型定义。 |
## pasteboard.createPlainTextData
@@ -128,7 +129,43 @@ createUriData(uri:string): PasteData
**示例**
```js
- var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1?user.txt");
+ var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1/user.txt");
+ ```
+
+
+## pasteboard.createPixelMapData9+
+
+createPixelMapData((pixelMap: image.PixelMap): PasteData
+
+构建一个PixelMap剪贴板内容对象。
+
+**系统能力**: SystemCapability.MiscServices.Pasteboard
+
+**参数**
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| pixelMap | [image.PixelMap](js-apis-image.md#pixelmap7) | 是 | 待保存的PixelMap内容。 |
+
+**返回值**
+| 类型 | 说明 |
+| -------- | -------- |
+| [PasteData](#pastedata) | 包含此内容的剪贴板内容对象。 |
+
+**示例**
+
+ ```js
+ import image from '@ohos.multimedia.image';
+ var buffer = new ArrayBuffer(128)
+ var opt = {
+ size: { height: 3, width: 5 },
+ pixelFormat: 3,
+ editable: true,
+ alphaType: 1,
+ scaleMode: 1
+ }
+ image.createPixelMap(buffer, opt).then((pixelMap) => {
+ var pasteData = pasteboard.createPixelMapData(pixelMap);
+ })
```
@@ -233,23 +270,72 @@ createUriRecord(uri:string): PasteDataRecord
**示例**
```js
- var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1?user.txt");
+ var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1/user.txt");
+ ```
+
+
+## pasteboard.createPixelMapRecord9+
+
+createPixelMapRecord(pixelMap:image.PixelMap): PasteDataRecord
+
+创建一条PixelMap对象内容的条目。
+
+**系统能力**: SystemCapability.MiscServices.Pasteboard
+
+**参数**
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| pixelMap | [image.PixelMap](js-apis-image.md#pixelmap7) | 是 | PixelMap对象内容。 |
+
+**返回值**
+| 类型 | 说明 |
+| -------- | -------- |
+| [PasteDataRecord](#pastedatarecord7) | 一条新建的PixelMap对象内容条目。 |
+
+**示例**
+
+ ```js
+ import image from '@ohos.multimedia.image';
+ var buffer = new ArrayBuffer(128)
+ var opt = {
+ size: { height: 3, width: 5 },
+ pixelFormat: 3,
+ editable: true,
+ alphaType: 1,
+ scaleMode: 1
+ }
+ image.createPixelMap(buffer, opt).then((pixelMap) => {
+ var record = pasteboard.createPixelMapRecord(pixelMap);
+ })
```
+## ShareOption9+
+
+可粘贴数据的范围类型枚举。
+
+**系统能力**: SystemCapability.MiscServices.Pasteboard
+
+| 名称 | 说明 |
+| ----- | ----------------------- |
+| InApp |InApp表示仅允许同应用内粘贴。 |
+| LocalDevice |LocalDevice表示仅允许在此设备中粘贴。 |
+
+
## PasteDataProperty7+
-定义了剪贴板中所有内容条目的属性,包含时间戳、数据类型以及一些附加数据等。
+定义了剪贴板中所有内容条目的属性,包含时间戳、数据类型、粘贴范围以及一些附加数据等。
**系统能力**: 以下各项对应的系统能力均为SystemCapability.MiscServices.Pasteboard。
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
-| additions | {[key: string]: object} | 是 | 是 | 设置的其他附加属性数据。 |
-| mimeTypes | Array<string> | 是 | 否 | 剪贴板内容条目的数据类型, 非重复的类型列表。 |
-| tag | string | 是 | 是 | 用户自定义标签。 |
-| timestamp | number | 是 | 否 | 剪贴板数据的写入时间戳(毫秒)。 |
-| localOnly | boolean | 是 | 是 | 配置剪贴板内容的“仅在本地”标志位。
- 默认情况为true。
- 配置为true时,表示内容仅在本地,不会在设备之间传递。
- 配置为false时,表示内容将在设备间传递。 |
+| additions7+ | {[key: string]: object} | 是 | 是 | 设置的其他附加属性数据。 |
+| mimeTypes7+ | Array<string> | 是 | 否 | 剪贴板内容条目的数据类型, 非重复的类型列表。 |
+| tag7+ | string | 是 | 是 | 用户自定义标签。 |
+| timestamp7+ | number | 是 | 否 | 剪贴板数据的写入时间戳(毫秒)。 |
+| localOnly7+ | boolean | 是 | 是 | 配置剪贴板内容的“仅在本地”标志位。
- 默认情况为true。
- 配置为true时,表示内容仅在本地,不会在设备之间传递。
- 配置为false时,表示内容将在设备间传递。 |
+| shareOption9+ | [ShareOption](#shareoption9) | 是 | 是 | 指示剪贴板数据可以粘贴到的范围。 |
## PasteDataRecord7+
@@ -268,6 +354,7 @@ createUriRecord(uri:string): PasteDataRecord
| mimeType7+ | string | 是 | 否 | 数据类型。 |
| plainText7+ | string | 是 | 否 | 文本内容。 |
| uri7+ | string | 是 | 否 | URI内容。 |
+| pixelMap9+ | [image.PixelMap](js-apis-image.md#pixelmap7) | 是 | 否 | PixelMap内容。 |
### convertToText7+
@@ -286,10 +373,10 @@ convertToText(): Promise<string>
**示例**
```js
- var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1?user.txt");
+ var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1/user.txt");
record.convertToText().then((data) => {
console.info('convertToText success data : ' + JSON.stringify(data));
- }).catch((error) => {
+ }).catch((error) => {
console.error('convertToText failed because ' + JSON.stringify(error));
});
```
@@ -311,7 +398,7 @@ convertToText(callback: AsyncCallback<string>): void
**示例**
```js
- var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1?user.txt");
+ var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1/user.txt");
record.convertToText((err, data) => {
if (err) {
console.error('convertToText failed because ' + JSON.stringify(err));
@@ -416,11 +503,44 @@ getPrimaryUri(): string
**示例**
```js
- var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1?user.txt");
+ var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1/user.txt");
var uri = pasteData.getPrimaryUri();
```
+### getPrimaryPixelMap9+
+
+getPrimaryPixelMap(): image.PixelMap
+
+获取首个条目的PixelMap对象内容。
+
+**系统能力**: SystemCapability.MiscServices.Pasteboard
+
+**返回值**
+| 类型 | 说明 |
+| -------- | -------- |
+| [image.PixelMap](js-apis-image.md#pixelmap7) | PixelMap对象内容。 |
+
+**示例**
+
+ ```js
+ import image from '@ohos.multimedia.image';
+
+ var buffer = new ArrayBuffer(128)
+ var opt = {
+ size: { height: 3, width: 5 },
+ pixelFormat: 3,
+ editable: true,
+ alphaType: 1,
+ scaleMode: 1
+ }
+ image.createPixelMap(buffer, opt).then((pixelMap) => {
+ var pasteData = pasteboard.createPixelMapData(pixelMap);
+ var pixelMap = pasteData.getPrimaryPixelMap();
+ })
+ ```
+
+
### addTextRecord7+
addTextRecord(text: string): void
@@ -514,7 +634,39 @@ addUriRecord(uri: string): void
```js
var pasteData = pasteboard.createPlainTextData("hello");
- pasteData.addUriRecord("dataability:///com.example.myapplication1?user.txt");
+ pasteData.addUriRecord("dataability:///com.example.myapplication1/user.txt");
+ ```
+
+### addPixelMapRecord9+
+
+addPixelMapRecord(pixelMap: image.PixelMap): void
+
+向当前剪贴板内容中添加一条pixelMap条目,并将MIMETYPE_PIXELMAP添加到[PasteDataProperty](#pastedataproperty7)的mimeTypes中。入参均不能为空,否则添加失败。
+
+剪贴板内容中添加的条目达到数量上限512后,后续的添加操作无效。
+
+**系统能力**: SystemCapability.MiscServices.Pasteboard
+
+**参数**
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| pixelMap | [image.PixelMap](js-apis-image.md#pixelmap7) | 是 | PixelMap对象内容。 |
+
+**示例**
+
+ ```js
+ import image from '@ohos.multimedia.image';
+ var buffer = new ArrayBuffer(128)
+ var opt = {
+ size: { height: 3, width: 5 },
+ pixelFormat: 3,
+ editable: true,
+ alphaType: 1,
+ scaleMode: 1
+ }
+ image.createPixelMap(buffer, opt).then((pixelMap) => {
+ var record = pasteboard.createPlainTextData("hello").addPixelMapRecord(pixelMap);
+ })
```
@@ -536,7 +688,7 @@ addRecord(record: PasteDataRecord): void
**示例**
```js
- var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1?user.txt");
+ var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1/user.txt");
var textRecord = pasteboard.createPlainTextRecord("hello");
var html = "\n" + "\n" + "