Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“92da467c99f43ce87a703a11cd77e8e4f47b25c1”上不存在“python/paddle/git@gitcode.net:s920243400/PaddleDetection.git”
未验证 提交 add981c8 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!12483 翻译完成 11932+11641+10827+11702+10111 

Merge pull request !12483 from ester.zhou/TR-11932
上级 78864d57 9b7908a9
隐藏空白更改
内联 并排
Showing with 940 addition and 507 deletion
en/application-dev/reference/apis/js-apis-pasteboard.md
浏览文件 @ add981c8
...@@ -12,25 +12,37 @@ The **pasteboard** module provides the copy and paste support for the system pas ...@@ -12,25 +12,37 @@ The **pasteboard** module provides the copy and paste support for the system pas
import pasteboard from '@ohos.pasteboard'; import pasteboard from '@ohos.pasteboard';
``` ```
## Attributes ## Constants
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
| Name| Type| Readable| Writable| Description| | Name| Type| Value| Description|
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| MAX_RECORD_NUM<sup>7+</sup> | number | Yes| No| Maximum number of records in a **PasteData** object.| | MAX_RECORD_NUM<sup>7+</sup> | number | 512 | Maximum number of records in a **PasteData** object.|
| MIMETYPE_TEXT_HTML<sup>7+</sup> | string | Yes| No| MIME type of the HTML content.| | MIMETYPE_TEXT_HTML<sup>7+</sup> | string | 'text/html' | MIME type of the HTML content.|
| MIMETYPE_TEXT_WANT<sup>7+</sup> | string | Yes| No| MIME type of the Want content.| | MIMETYPE_TEXT_WANT<sup>7+</sup> | string | 'text/want' | MIME type of the Want content.|
| MIMETYPE_TEXT_PLAIN<sup>7+</sup> | string | Yes| No| MIME type of the plain text content.| | MIMETYPE_TEXT_PLAIN<sup>7+</sup> | string | 'text/plain' | MIME type of the plain text content.|
| MIMETYPE_TEXT_URI<sup>7+</sup> | string | Yes| No| MIME type of the URI content.| | MIMETYPE_TEXT_URI<sup>7+</sup> | string | 'text/uri' | MIME type of the URI content.|
| MIMETYPE_PIXELMAP<sup>9+</sup> | string | Yes| No| MIME type of the pixel map.| | MIMETYPE_PIXELMAP<sup>9+</sup> | string | 'pixelMap' | MIME type of the pixel map.|
## ValueType<sup>9+</sup>
## pasteboard.createPlainTextData Enumerates the value types.
createPlainTextData(text: string): PasteData **System capability**: SystemCapability.MiscServices.Pasteboard
Creates a **PasteData** object of the plain text type. | Type| Description|
| -------- | -------- |
| string | The value is a string.|
| image.PixelMap | The value is of the [image.PixelMap](js-apis-image.md#pixelmap7) type.|
| Want | The value is of the [Want](js-apis-app-ability-want.md) type.|
| ArrayBuffer | The value is of the **ArrayBuffer** type.|
## pasteboard.createData<sup>9+</sup>
createData(mimeType: string, value: ValueType): PasteData
Creates a **PasteData** object of a custom type.
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -38,26 +50,27 @@ Creates a **PasteData** object of the plain text type. ...@@ -38,26 +50,27 @@ Creates a **PasteData** object of the plain text type.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| text | string | Yes| Plain text.| | mimeType | string | Yes| MIME type of custom data.|
| value | [ValueType](#valuetype9) | Yes| Content of custom data.|
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [PasteData](#pastedata) | **PasteData** object.| | [PasteData](#pastedata) | **PasteData** object.|
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("content"); let dataXml = new ArrayBuffer(256);
``` let pasteData = pasteboard.createData('app/xml', dataXml);
```
## pasteboard.createHtmlData<sup>7+</sup> ## pasteboard.createRecord<sup>9+</sup>
createHtmlData(htmlText: string): PasteData createRecord(mimeType: string, value: ValueType):PasteDataRecord;
Creates a **PasteData** object of the HTML type. Creates a **PasteDataRecord** object of the custom type.
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -65,58 +78,62 @@ Creates a **PasteData** object of the HTML type. ...@@ -65,58 +78,62 @@ Creates a **PasteData** object of the HTML type.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| htmlText | string | Yes| HTML content.| | mimeType | string | Yes| MIME type of custom data.|
| value | [ValueType](#valuetype9) | Yes| Content of custom data.|
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [PasteData](#pastedata) | **PasteData** object.| | [PasteDataRecord](#pastedatarecord7) | New **PasteDataRecord** object of the custom type.|
**Example** **Example**
```js ```js
var html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>"; let dataXml = new ArrayBuffer(256);
var pasteData = pasteboard.createHtmlData(html); let pasteDataRecord = pasteboard.createRecord('app/xml', dataXml);
``` ```
## pasteboard.createWantData<sup>7+</sup> ## pasteboard.getSystemPasteboard
createWantData(want: Want): PasteData getSystemPasteboard(): SystemPasteboard
Creates a **PasteData** object of the Want type. Obtains this **SystemPasteboard** object.
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-Want.md) | Yes| Want content.|
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [PasteData](#pastedata) | **PasteData** object.| | [SystemPasteboard](#systempasteboard) | **SystemPasteboard** object.|
**Example** **Example**
```js ```js
var object = { let systemPasteboard = pasteboard.getSystemPasteboard();
bundleName: "com.example.aafwk.test",
abilityName: "com.example.aafwk.test.TwoAbility"
};
var pasteData = pasteboard.createWantData(object);
``` ```
## ShareOption<sup>9+</sup>
## pasteboard.createUriData<sup>7+</sup> Enumerates the paste options of data.
createUriData(uri: string): PasteData **System capability**: SystemCapability.MiscServices.Pasteboard
Creates a **PasteData** object of the URI type. | Name | Description |
| ----- | ----------------------- |
| InApp |Only intra-application pasting is allowed.|
| LocalDevice |Paste is allowed in any application on the local device.|
| CrossDevice |Paste is allowed in any application across devices.|
## pasteboard.createHtmlData<sup>(deprecated)</sup>
createHtmlData(htmlText: string): PasteData
Creates a **PasteData** object of the HTML type.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.createData](#pasteboardcreatedata9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -124,7 +141,7 @@ Creates a **PasteData** object of the URI type. ...@@ -124,7 +141,7 @@ Creates a **PasteData** object of the URI type.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| uri | string | Yes| URI content.| | htmlText | string | Yes| HTML content.|
**Return value** **Return value**
...@@ -135,15 +152,18 @@ Creates a **PasteData** object of the URI type. ...@@ -135,15 +152,18 @@ Creates a **PasteData** object of the URI type.
**Example** **Example**
```js ```js
var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1/user.txt"); let html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>";
let pasteData = pasteboard.createHtmlData(html);
``` ```
## pasteboard.createWantData<sup>(deprecated)</sup>
## pasteboard.createPixelMapData<sup>9+</sup> createWantData(want: Want): PasteData
createPixelMapData(pixelMap: image.PixelMap): PasteData
Creates a **PasteData** object of the pixel map type. Creates a **PasteData** object of the Want type.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.createData](#pasteboardcreatedata9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -151,7 +171,7 @@ Creates a **PasteData** object of the pixel map type. ...@@ -151,7 +171,7 @@ Creates a **PasteData** object of the pixel map type.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| pixelMap | [image.PixelMap](js-apis-image.md#pixelmap7) | Yes| Pixel map.| | want | [Want](js-apis-app-ability-want.md) | Yes| Want content.|
**Return value** **Return value**
...@@ -162,26 +182,21 @@ Creates a **PasteData** object of the pixel map type. ...@@ -162,26 +182,21 @@ Creates a **PasteData** object of the pixel map type.
**Example** **Example**
```js ```js
import image from '@ohos.multimedia.image'; let object = {
bundleName: "com.example.aafwk.test",
var buffer = new ArrayBuffer(128) abilityName: "com.example.aafwk.test.TwoAbility"
var opt = { };
size: { height: 3, width: 5 }, let pasteData = pasteboard.createWantData(object);
pixelFormat: 3,
editable: true,
alphaType: 1,
scaleMode: 1
}
image.createPixelMap(buffer, opt).then((pixelMap) => {
var pasteData = pasteboard.createPixelMapData(pixelMap);
})
``` ```
## pasteboard.createData<sup>9+</sup> ## pasteboard.createPlainTextData<sup>(deprecated)</sup>
createData(mimeType: string, value: ArrayBuffer): PasteData; createPlainTextData(text: string): PasteData
Creates a **PasteData** object of a custom type. Creates a **PasteData** object of the plain text type.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.createData](#pasteboardcreatedata9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -189,28 +204,28 @@ Creates a **PasteData** object of a custom type. ...@@ -189,28 +204,28 @@ Creates a **PasteData** object of a custom type.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| mimeType | string | Yes| MIME type of custom data.| | text | string | Yes| Plain text.|
| value | ArrayBuffer | Yes| Content of custom data.|
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [PasteData](#pastedata) | **PasteData** object.| | [PasteData](#pastedata) | **PasteData** object.|
**Example** **Example**
```js ```js
var dataXml = new ArrayBuffer(256) let pasteData = pasteboard.createPlainTextData('content');
var pasteData = pasteboard.createData('app/xml', dataXml) ```
```
## pasteboard.createPlainTextRecord<sup>7+</sup> ## pasteboard.createUriData<sup>(deprecated)</sup>
createPlainTextRecord(text: string): PasteDataRecord createUriData(uri: string): PasteData
Creates a **PasteDataRecord** object of the plain text type. Creates a **PasteData** object of the URI type.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.createData](#pasteboardcreatedata9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -218,26 +233,27 @@ Creates a **PasteDataRecord** object of the plain text type. ...@@ -218,26 +233,27 @@ Creates a **PasteDataRecord** object of the plain text type.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| text | string | Yes| Plain text.| | uri | string | Yes| URI content.|
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [PasteDataRecord](#pastedatarecord7) | New **PasteDataRecord** object of the plain text type.| | [PasteData](#pastedata) | **PasteData** object.|
**Example** **Example**
```js ```js
var record = pasteboard.createPlainTextRecord("hello"); let pasteData = pasteboard.createUriData('dataability:///com.example.myapplication1/user.txt');
``` ```
## pasteboard.createHtmlTextRecord<sup>(deprecated)</sup>
## pasteboard.createHtmlTextRecord<sup>7+</sup>
createHtmlTextRecord(htmlText: string): PasteDataRecord createHtmlTextRecord(htmlText: string): PasteDataRecord
Creates a **PasteDataRecord** object of the HTML text type. Creates a **PasteDataRecord** object of the HTML text type.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.createRecord](#pasteboardcreaterecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -256,16 +272,18 @@ Creates a **PasteDataRecord** object of the HTML text type. ...@@ -256,16 +272,18 @@ Creates a **PasteDataRecord** object of the HTML text type.
**Example** **Example**
```js ```js
var html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>"; let html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>";
var record = pasteboard.createHtmlTextRecord(html); let record = pasteboard.createHtmlTextRecord(html);
``` ```
## pasteboard.createWantRecord<sup>(deprecated)</sup>
## pasteboard.createWantRecord<sup>7+</sup>
createWantRecord(want: Want): PasteDataRecord createWantRecord(want: Want): PasteDataRecord
Creates a **PasteDataRecord** object of the Want type. Creates a **PasteDataRecord** object of the Want type.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.createRecord](#pasteboardcreaterecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -273,7 +291,7 @@ Creates a **PasteDataRecord** object of the Want type. ...@@ -273,7 +291,7 @@ Creates a **PasteDataRecord** object of the Want type.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-Want.md) | Yes| Want content.| | want | [Want](js-apis-app-ability-want.md) | Yes| Want content.|
**Return value** **Return value**
...@@ -284,46 +302,21 @@ Creates a **PasteDataRecord** object of the Want type. ...@@ -284,46 +302,21 @@ Creates a **PasteDataRecord** object of the Want type.
**Example** **Example**
```js ```js
var object = { let object = {
bundleName: "com.example.aafwk.test", bundleName: "com.example.aafwk.test",
abilityName: "com.example.aafwk.test.TwoAbility" abilityName: "com.example.aafwk.test.TwoAbility"
}; };
var record = pasteboard.createWantRecord(object); let record = pasteboard.createWantRecord(object);
```
## pasteboard.createUriRecord<sup>7+</sup>
createUriRecord(uri: string): PasteDataRecord
Creates a **PasteDataRecord** object of the URI type.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| uri | string | Yes| URI content.|
**Return value**
| Type| Description|
| -------- | -------- |
| [PasteDataRecord](#pastedatarecord7) | New **PasteDataRecord** object of the URI type.|
**Example**
```js
var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1/user.txt");
``` ```
## pasteboard.createPlainTextRecord<sup>(deprecated)</sup>
## pasteboard.createPixelMapRecord<sup>9+</sup> createPlainTextRecord(text: string): PasteDataRecord
createPixelMapRecord(pixelMap: image.PixelMap): PasteDataRecord
Creates a **PasteDataRecord** object of the pixel map type. Creates a **PasteDataRecord** object of the plain text type.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.createRecord](#pasteboardcreaterecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -331,37 +324,28 @@ Creates a **PasteDataRecord** object of the pixel map type. ...@@ -331,37 +324,28 @@ Creates a **PasteDataRecord** object of the pixel map type.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| pixelMap | [image.PixelMap](js-apis-image.md#pixelmap7) | Yes| Pixel map.| | text | string | Yes| Plain text.|
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [PasteDataRecord](#pastedatarecord7) | New **PasteDataRecord** object of the pixel map type.| | [PasteDataRecord](#pastedatarecord7) | New **PasteDataRecord** object of the plain text type.|
**Example** **Example**
```js ```js
import image from '@ohos.multimedia.image'; let record = pasteboard.createPlainTextRecord('hello');
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);
})
``` ```
## pasteboard.createRecord<sup>9+</sup> ## pasteboard.createUriRecord<sup>(deprecated)</sup>
createRecord(mimeType: string, value: ArrayBuffer):PasteDataRecord; createUriRecord(uri: string): PasteDataRecord
Creates a **PasteDataRecord** object of the custom type. Creates a **PasteDataRecord** object of the URI type.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.createRecord](#pasteboardcreaterecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -369,55 +353,20 @@ Creates a **PasteDataRecord** object of the custom type. ...@@ -369,55 +353,20 @@ Creates a **PasteDataRecord** object of the custom type.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| mimeType | string | Yes| MIME type of custom data.| | uri | string | Yes| URI content.|
| value | ArrayBuffer | Yes| Content of custom data.|
**Return value**
| Type| Description|
| -------- | -------- |
| [PasteDataRecord](#pastedatarecord7) | New **PasteDataRecord** object of the custom type.|
**Example**
```js
var dataXml = new ArrayBuffer(256)
var pasteDataRecord = pasteboard.createRecord('app/xml', dataXml);
```
## pasteboard.getSystemPasteboard
getSystemPasteboard(): SystemPasteboard
Obtains this **SystemPasteboard** object.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [SystemPasteboard](#systempasteboard) | **SystemPasteboard** object.| | [PasteDataRecord](#pastedatarecord7) | New **PasteDataRecord** object of the URI type.|
**Example** **Example**
```js ```js
var systemPasteboard = pasteboard.getSystemPasteboard(); let record = pasteboard.createUriRecord('dataability:///com.example.myapplication1/user.txt');
``` ```
## ShareOption<sup>9+</sup>
Enumerates the paste options of data.
**System capability**: SystemCapability.MiscServices.Pasteboard
| Name | Description |
| ----- | ----------------------- |
| InApp |Only intra-application pasting is allowed. |
| LocalDevice |Paste is allowed in any application on the local device. |
| CrossDevice |Paste is allowed in any application across devices. |
## PasteDataProperty<sup>7+</sup> ## PasteDataProperty<sup>7+</sup>
...@@ -434,12 +383,10 @@ Defines the properties of all data records on the pasteboard, including the time ...@@ -434,12 +383,10 @@ Defines the properties of all data records on the pasteboard, including the time
| localOnly<sup>7+</sup> | boolean | Yes| Yes| Whether the pasteboard content is set for local access only. The default value is **true**.<br>- **true**: The pasteboard content is set for local access only.<br>- **false**: The pasteboard content can be shared between devices.| | localOnly<sup>7+</sup> | boolean | Yes| Yes| Whether the pasteboard content is set for local access only. The default value is **true**.<br>- **true**: The pasteboard content is set for local access only.<br>- **false**: The pasteboard content can be shared between devices.|
| shareOption<sup>9+</sup> | [ShareOption](#shareoption9) | Yes| Yes| Where the pasteboard content can be pasted. If this attribute is set incorrectly or not set, the default value **CrossDevice** is used.| | shareOption<sup>9+</sup> | [ShareOption](#shareoption9) | Yes| Yes| Where the pasteboard content can be pasted. If this attribute is set incorrectly or not set, the default value **CrossDevice** is used.|
## PasteDataRecord<sup>7+</sup> ## PasteDataRecord<sup>7+</sup>
Provides **PasteDataRecord** APIs. A **PasteDataRecord** is an abstract definition of the content on the pasteboard. The pasteboard content consists of one or more plain text, HTML, URI, or Want records. Provides **PasteDataRecord** APIs. A **PasteDataRecord** is an abstract definition of the content on the pasteboard. The pasteboard content consists of one or more plain text, HTML, URI, or Want records.
### Attributes ### Attributes
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -447,17 +394,43 @@ Provides **PasteDataRecord** APIs. A **PasteDataRecord** is an abstract definiti ...@@ -447,17 +394,43 @@ Provides **PasteDataRecord** APIs. A **PasteDataRecord** is an abstract definiti
| Name| Type| Readable| Writable| Description| | Name| Type| Readable| Writable| Description|
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| htmlText<sup>7+</sup> | string | Yes| No| HTML content.| | htmlText<sup>7+</sup> | string | Yes| No| HTML content.|
| want<sup>7+</sup> | [Want](js-apis-application-Want.md) | Yes| No| Want content.| | want<sup>7+</sup> | [Want](js-apis-app-ability-want.md) | Yes| No| Want content.|
| mimeType<sup>7+</sup> | string | Yes| No| Data type.| | mimeType<sup>7+</sup> | string | Yes| No| Data type.|
| plainText<sup>7+</sup> | string | Yes| No| Plain text.| | plainText<sup>7+</sup> | string | Yes| No| Plain text.|
| uri<sup>7+</sup> | string | Yes| No| URI content.| | uri<sup>7+</sup> | string | Yes| No| URI content.|
| pixelMap<sup>9+</sup> | [image.PixelMap](js-apis-image.md#pixelmap7) | Yes| No| Pixel map.| | pixelMap<sup>9+</sup> | [image.PixelMap](js-apis-image.md#pixelmap7) | Yes| No| Pixel map.|
| data<sup>9+</sup> | {[mimeType:&nbsp;string]:&nbsp;ArrayBuffer} | Yes| No| Content of custom data.| | data<sup>9+</sup> | {[mimeType: string]: ArrayBuffer} | Yes| No| Content of custom data.|
### convertToTextV9<sup>9+</sup>
### convertToText<sup>7+</sup> convertToTextV9(callback: AsyncCallback&lt;string&gt;): void
convertToText(): Promise&lt;string&gt; Forcibly converts the content in a **PasteData** object to text. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;string&gt; | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is the text obtained from the conversion. Otherwise, **err** is error information.|
**Example**
```js
let record = pasteboard.createUriRecord('dataability:///com.example.myapplication1/user.txt');
record.convertToTextV9((err, data) => {
if (err) {
console.error(`Failed to convert to text. Cause: ${err.message}`);
return;
}
console.info(`Succeeded in converting to text. Data: ${data}`);
});
```
### convertToTextV9<sup>9+</sup>
convertToTextV9(): Promise&lt;string&gt;
Forcibly converts the content in a **PasteData** object to text. This API uses a promise to return the result. Forcibly converts the content in a **PasteData** object to text. This API uses a promise to return the result.
...@@ -472,20 +445,22 @@ Forcibly converts the content in a **PasteData** object to text. This API uses a ...@@ -472,20 +445,22 @@ Forcibly converts the content in a **PasteData** object to text. This API uses a
**Example** **Example**
```js ```js
var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1/user.txt"); let record = pasteboard.createUriRecord('dataability:///com.example.myapplication1/user.txt');
record.convertToText().then((data) => { record.convertToTextV9().then((data) => {
console.info('Succeeded in converting to text. Data: ' + JSON.stringify(data)); console.info(`Succeeded in converting to text. Data: ${data}`);
}).catch((err) => { }).catch((err) => {
console.error('Failed to convert to text. Cause: ' + JSON.stringify(err)); console.error(`Failed to convert to text. Cause: ${err.message}`);
}); });
``` ```
### convertToText<sup>(deprecated)</sup>
### convertToText<sup>7+</sup>
convertToText(callback: AsyncCallback&lt;string&gt;): void convertToText(callback: AsyncCallback&lt;string&gt;): void
Forcibly converts the content in a **PasteData** object to text. This API uses an asynchronous callback to return the result. Forcibly converts the content in a **PasteData** object to text. This API uses an asynchronous callback to return the result.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [convertToTextV9](#converttotextv99).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -498,16 +473,43 @@ Forcibly converts the content in a **PasteData** object to text. This API uses a ...@@ -498,16 +473,43 @@ Forcibly converts the content in a **PasteData** object to text. This API uses a
**Example** **Example**
```js ```js
var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1/user.txt"); let record = pasteboard.createUriRecord('dataability:///com.example.myapplication1/user.txt');
record.convertToText((err, data) => { record.convertToText((err, data) => {
if (err) { if (err) {
console.error('Failed to convert to text. Cause: ' + JSON.stringify(err)); console.error(`Failed to convert to text. Cause: ${err.message}`);
return; return;
} }
console.info('Succeeded in converting to text. Data: ' + JSON.stringify(data)); console.info(`Succeeded in converting to text. Data: ${data}`);
}); });
``` ```
### convertToText<sup>(deprecated)</sup>
convertToText(): Promise&lt;string&gt;
Forcibly converts the content in a **PasteData** object to text. This API uses a promise to return the result.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [convertToTextV9](#converttotextv99-1).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Return value**
| Type| Description|
| -------- | -------- |
| Promise&lt;string&gt; | Promise used to return the text obtained from the conversion.|
**Example**
```js
let record = pasteboard.createUriRecord('dataability:///com.example.myapplication1/user.txt');
record.convertToText().then((data) => {
console.info(`Succeeded in converting to text. Data: ${data}`);
}).catch((err) => {
console.error(`Failed to convert to text. Cause: ${err.message}`);
});
```
## PasteData ## PasteData
...@@ -517,18 +519,14 @@ Before calling any **PasteData** API, you must obtain a **PasteData** object. ...@@ -517,18 +519,14 @@ Before calling any **PasteData** API, you must obtain a **PasteData** object.
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
### getPrimaryText ### getPrimaryText
getPrimaryText(): string getPrimaryText(): string
Obtains the plain text of the primary record. Obtains the plain text of the primary record.
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
**Return value** **Return value**
| Type| Description| | Type| Description|
...@@ -538,11 +536,10 @@ Obtains the plain text of the primary record. ...@@ -538,11 +536,10 @@ Obtains the plain text of the primary record.
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var plainText = pasteData.getPrimaryText(); let plainText = pasteData.getPrimaryText();
``` ```
### getPrimaryHtml<sup>7+</sup> ### getPrimaryHtml<sup>7+</sup>
getPrimaryHtml(): string getPrimaryHtml(): string
...@@ -560,12 +557,11 @@ Obtains the HTML content of the primary record. ...@@ -560,12 +557,11 @@ Obtains the HTML content of the primary record.
**Example** **Example**
```js ```js
var html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>"; let html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>";
var pasteData = pasteboard.createHtmlData(html); let pasteData = pasteboard.createHtmlData(html);
var htmlText = pasteData.getPrimaryHtml(); let htmlText = pasteData.getPrimaryHtml();
``` ```
### getPrimaryWant<sup>7+</sup> ### getPrimaryWant<sup>7+</sup>
getPrimaryWant(): Want getPrimaryWant(): Want
...@@ -578,20 +574,19 @@ Obtains the Want object of the primary record. ...@@ -578,20 +574,19 @@ Obtains the Want object of the primary record.
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [Want](js-apis-application-Want.md) | Want object.| | [Want](js-apis-app-ability-want.md) | Want object.|
**Example** **Example**
```js ```js
var object = { let object = {
bundleName: "com.example.aafwk.test", bundleName: "com.example.aafwk.test",
abilityName: "com.example.aafwk.test.TwoAbility" abilityName: "com.example.aafwk.test.TwoAbility"
}; };
var pasteData = pasteboard.createWantData(object); let pasteData = pasteboard.createWantData(object);
var want = pasteData.getPrimaryWant(); let want = pasteData.getPrimaryWant();
``` ```
### getPrimaryUri<sup>7+</sup> ### getPrimaryUri<sup>7+</sup>
getPrimaryUri(): string getPrimaryUri(): string
...@@ -609,11 +604,10 @@ Obtains the URI of the primary record. ...@@ -609,11 +604,10 @@ Obtains the URI of the primary record.
**Example** **Example**
```js ```js
var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1/user.txt"); let pasteData = pasteboard.createUriData('dataability:///com.example.myapplication1/user.txt');
var uri = pasteData.getPrimaryUri(); let uri = pasteData.getPrimaryUri();
``` ```
### getPrimaryPixelMap<sup>9+</sup> ### getPrimaryPixelMap<sup>9+</sup>
getPrimaryPixelMap(): image.PixelMap getPrimaryPixelMap(): image.PixelMap
...@@ -633,26 +627,25 @@ Obtains the pixel map of the primary record. ...@@ -633,26 +627,25 @@ Obtains the pixel map of the primary record.
```js ```js
import image from '@ohos.multimedia.image'; import image from '@ohos.multimedia.image';
var buffer = new ArrayBuffer(128) let buffer = new ArrayBuffer(128);
var opt = { let opt = {
size: { height: 3, width: 5 }, size: { height: 3, width: 5 },
pixelFormat: 3, pixelFormat: 3,
editable: true, editable: true,
alphaType: 1, alphaType: 1,
scaleMode: 1 scaleMode: 1
} };
image.createPixelMap(buffer, opt).then((pixelMap) => { image.createPixelMap(buffer, opt).then((pixelMap) => {
var pasteData = pasteboard.createPixelMapData(pixelMap); let pasteData = pasteboard.createData('app/xml',pixelMap);
var pixelMap = pasteData.getPrimaryPixelMap(); let PixelMap = pasteData.getPrimaryPixelMap();
}) });
``` ```
### addRecord<sup>7+</sup>
### addTextRecord<sup>7+</sup> addRecord(record: PasteDataRecord): void
addTextRecord(text: string): void
Adds a plain text record to this pasteboard, and adds **MIME_TEXT_PLAIN** to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails. Adds a data record to this pasteboard, and adds its type to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
The pasteboard supports a maximum number of 512 data records. The pasteboard supports a maximum number of 512 data records.
...@@ -662,130 +655,21 @@ The pasteboard supports a maximum number of 512 data records. ...@@ -662,130 +655,21 @@ The pasteboard supports a maximum number of 512 data records.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| text | string | Yes| Plain text.| | record | [PasteDataRecord](#pastedatarecord7) | Yes| Record to add.|
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createUriData('dataability:///com.example.myapplication1/user.txt');
pasteData.addTextRecord("good"); let textRecord = pasteboard.createPlainTextRecord('hello');
``` let html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>";
let htmlRecord = pasteboard.createHtmlTextRecord(html);
pasteData.addRecord(textRecord);
### addHtmlRecord<sup>7+</sup> pasteData.addRecord(htmlRecord);
addHtmlRecord(htmlText: string): void
Adds an HTML record to this pasteboard, and adds **MIMETYPE_TEXT_HTML** to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
The pasteboard supports a maximum number of 512 data records.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| htmlText | string | Yes| HTML content.|
**Example**
```js
var pasteData = pasteboard.createPlainTextData("hello");
var html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>";
pasteData.addHtmlRecord(html);
```
### addWantRecord<sup>7+</sup>
addWantRecord(want: Want): void
Adds a Want record to this pasteboard, and adds **MIMETYPE_TEXT_WANT** to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
The pasteboard supports a maximum number of 512 data records.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-Want.md) | Yes| Want object.|
**Example**
```js
var pasteData = pasteboard.createPlainTextData("hello");
var object = {
bundleName: "com.example.aafwk.test",
abilityName: "com.example.aafwk.test.TwoAbility"
};
pasteData.addWantRecord(object);
```
### addUriRecord<sup>7+</sup>
addUriRecord(uri: string): void
Adds a URI record to this pasteboard, and adds **MIMETYPE_TEXT_URI** to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
The pasteboard supports a maximum number of 512 data records.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| uri | string | Yes| URI content.|
**Example**
```js
var pasteData = pasteboard.createPlainTextData("hello");
pasteData.addUriRecord("dataability:///com.example.myapplication1/user.txt");
```
### addPixelMapRecord<sup>9+</sup>
addPixelMapRecord(pixelMap: image.PixelMap): void
Adds a pixel map record to this pasteboard, and adds **MIMETYPE_PIXELMAP** to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
The pasteboard supports a maximum number of 512 data records.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| pixelMap | [image.PixelMap](js-apis-image.md#pixelmap7) | Yes| Pixel map.|
**Example**
```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);
})
``` ```
### addRecord<sup>9+</sup> ### addRecord<sup>9+</sup>
addRecord(mimeType: string, value: ArrayBuffer): void addRecord(mimeType: string, value: ValueType): void
Adds a custom-type record to this pasteboard, and adds the custom type to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails. Adds a custom-type record to this pasteboard, and adds the custom type to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
...@@ -798,44 +682,23 @@ The pasteboard supports a maximum number of 512 data records. ...@@ -798,44 +682,23 @@ The pasteboard supports a maximum number of 512 data records.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| mimeType | string | Yes| MIME type of custom data.| | mimeType | string | Yes| MIME type of custom data.|
| value | ArrayBuffer | Yes| Content of custom data.| | value | [ValueType](#valuetype9) | Yes| Content of custom data.|
**Example** **Error codes**
```js
var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1/user.txt");
var dataXml = new ArrayBuffer(256)
pasteData.addRecord('app/xml', dataXml);
```
### addRecord<sup>7+</sup>
addRecord(record: PasteDataRecord): void
Adds a data record to this pasteboard, and adds its type to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
The pasteboard supports a maximum number of 512 data records.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters** For details about the error codes, see [Pasteboard Error Codes](../errorcodes/errorcode-pasteboard.md).
| Name| Type| Mandatory| Description| | Error Code ID| Error Message|
| -------- | -------- | -------- | -------- | | -------- | -------- |
| record | [PasteDataRecord](#pastedatarecord7) | Yes| Record to add.| | 12900002 | The number of record exceeds the maximum limit. |
**Example** **Example**
```js ```js
var pasteData = pasteboard.createUriData("dataability:///com.example.myapplication1/user.txt"); let pasteData = pasteboard.createUriData('dataability:///com.example.myapplication1/user.txt');
var textRecord = pasteboard.createPlainTextRecord("hello"); let dataXml = new ArrayBuffer(256);
var html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>"; pasteData.addRecord('app/xml', dataXml);
var htmlRecord = pasteboard.createHtmlTextRecord(html); ```
pasteData.addRecord(textRecord);
pasteData.addRecord(htmlRecord);
```
### getMimeTypes<sup>7+</sup> ### getMimeTypes<sup>7+</sup>
...@@ -854,11 +717,10 @@ Obtains a list of **mimeTypes** objects in [PasteDataProperty](#pastedatapropert ...@@ -854,11 +717,10 @@ Obtains a list of **mimeTypes** objects in [PasteDataProperty](#pastedatapropert
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var types = pasteData.getMimeTypes(); let types = pasteData.getMimeTypes();
``` ```
### getPrimaryMimeType<sup>7+</sup> ### getPrimaryMimeType<sup>7+</sup>
getPrimaryMimeType(): string getPrimaryMimeType(): string
...@@ -876,11 +738,10 @@ Obtains the data type of the primary record in this pasteboard. ...@@ -876,11 +738,10 @@ Obtains the data type of the primary record in this pasteboard.
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var type = pasteData.getPrimaryMimeType(); let type = pasteData.getPrimaryMimeType();
``` ```
### getProperty<sup>7+</sup> ### getProperty<sup>7+</sup>
getProperty(): PasteDataProperty getProperty(): PasteDataProperty
...@@ -898,11 +759,10 @@ Obtains the property of the pasteboard data. ...@@ -898,11 +759,10 @@ Obtains the property of the pasteboard data.
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var property = pasteData.getProperty(); let property = pasteData.getProperty();
``` ```
### setProperty<sup>9+</sup> ### setProperty<sup>9+</sup>
setProperty(property: PasteDataProperty): void setProperty(property: PasteDataProperty): void
...@@ -920,16 +780,15 @@ Sets the property (attributes) for the pasteboard data. Currently, only the **sh ...@@ -920,16 +780,15 @@ Sets the property (attributes) for the pasteboard data. Currently, only the **sh
**Example** **Example**
```js ```js
var pasteData = pasteboard.createHtmlData('application/xml'); let pasteData = pasteboard.createHtmlData('application/xml');
let prop = pasteData.getProperty(); let prop = pasteData.getProperty();
prop.shareOption = pasteboard.ShareOption.InApp; prop.shareOption = pasteboard.ShareOption.InApp;
pasteData.setProperty(prop); pasteData.setProperty(prop);
``` ```
### getRecord<sup>9+</sup>
### getRecordAt<sup>7+</sup> getRecord(index: number): PasteDataRecord
getRecordAt(index: number): PasteDataRecord
Obtains the specified record in the pasteboard. Obtains the specified record in the pasteboard.
...@@ -947,14 +806,21 @@ Obtains the specified record in the pasteboard. ...@@ -947,14 +806,21 @@ Obtains the specified record in the pasteboard.
| -------- | -------- | | -------- | -------- |
| [PasteDataRecord](#pastedatarecord7) | Record with the specified index.| | [PasteDataRecord](#pastedatarecord7) | Record with the specified index.|
**Error codes**
For details about the error codes, see [Pasteboard Error Codes](../errorcodes/errorcode-pasteboard.md).
| Error Code ID| Error Message|
| -------- | -------- |
| 12900001 | The index is out of range. |
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var record = pasteData.getRecordAt(0); let record = pasteData.getRecord(0);
``` ```
### getRecordCount<sup>7+</sup> ### getRecordCount<sup>7+</sup>
getRecordCount(): number getRecordCount(): number
...@@ -972,11 +838,10 @@ Obtains the number of records in the pasteboard. ...@@ -972,11 +838,10 @@ Obtains the number of records in the pasteboard.
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var count = pasteData.getRecordCount(); let count = pasteData.getRecordCount();
``` ```
### getTag<sup>7+</sup> ### getTag<sup>7+</sup>
getTag(): string getTag(): string
...@@ -994,14 +859,13 @@ Obtains the custom tag from the pasteboard. If no custom tag is set, null is ret ...@@ -994,14 +859,13 @@ Obtains the custom tag from the pasteboard. If no custom tag is set, null is ret
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var tag = pasteData.getTag(); let tag = pasteData.getTag();
``` ```
### hasType<sup>9+</sup>
### hasMimeType<sup>7+</sup> hasType(mimeType: string): boolean
hasMimeType(mimeType: string): boolean
Checks whether the pasteboard contains data of the specified type. Checks whether the pasteboard contains data of the specified type.
...@@ -1022,14 +886,13 @@ Checks whether the pasteboard contains data of the specified type. ...@@ -1022,14 +886,13 @@ Checks whether the pasteboard contains data of the specified type.
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var hasType = pasteData.hasMimeType(pasteboard.MIMETYPE_TEXT_PLAIN); let hasType = pasteData.hasType(pasteboard.MIMETYPE_TEXT_PLAIN);
``` ```
### removeRecord<sup>9+</sup>
### removeRecordAt<sup>7+</sup> removeRecord(index: number): void
removeRecordAt(index: number): boolean
Removes the record with the specified index from the pasteboard. Removes the record with the specified index from the pasteboard.
...@@ -1041,23 +904,24 @@ Removes the record with the specified index from the pasteboard. ...@@ -1041,23 +904,24 @@ Removes the record with the specified index from the pasteboard.
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| index | number | Yes| Specified index.| | index | number | Yes| Specified index.|
**Return value** **Error codes**
| Type| Description| For details about the error codes, see [Pasteboard Error Codes](../errorcodes/errorcode-pasteboard.md).
| Error Code ID| Error Message|
| -------- | -------- | | -------- | -------- |
| boolean | Returns **true** if the operation is successful; returns **false** otherwise.| | 12900001 | The index is out of range. |
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var isRemove = pasteData.removeRecordAt(0); pasteData.removeRecord(0);
``` ```
### replaceRecord<sup>9+</sup>
### replaceRecordAt<sup>7+</sup> replaceRecord(index: number, record: PasteDataRecord): void
replaceRecordAt(index: number, record: PasteDataRecord): boolean
Replaces the record with the specified index in the pasteboard with a new record. Replaces the record with the specified index in the pasteboard with a new record.
...@@ -1070,36 +934,58 @@ Replaces the record with the specified index in the pasteboard with a new record ...@@ -1070,36 +934,58 @@ Replaces the record with the specified index in the pasteboard with a new record
| index | number | Yes| Specified index.| | index | number | Yes| Specified index.|
| record | [PasteDataRecord](#pastedatarecord7) | Yes| New record.| | record | [PasteDataRecord](#pastedatarecord7) | Yes| New record.|
**Return value** **Error codes**
| Type| Description| For details about the error codes, see [Pasteboard Error Codes](../errorcodes/errorcode-pasteboard.md).
| Error Code ID| Error Message|
| -------- | -------- | | -------- | -------- |
| boolean | Returns **true** if the operation is successful; returns **false** otherwise.| | 12900001 | The index is out of range. |
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("hello"); let pasteData = pasteboard.createPlainTextData('hello');
var record = pasteboard.createUriRecord("dataability:///com.example.myapplication1/user.txt"); let record = pasteboard.createUriRecord('dataability:///com.example.myapplication1/user.txt');
var isReplace = pasteData.replaceRecordAt(0, record); pasteData.replaceRecord(0, record);
``` ```
### addHtmlRecord<sup>(deprecated)</sup>
## SystemPasteboard addHtmlRecord(htmlText: string): void
Provides **SystemPasteboard** APIs. Adds an HTML record to this pasteboard, and adds **MIMETYPE_TEXT_HTML** to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
Before calling any **SystemPasteboard** API, you must obtain a **SystemPasteboard** object using [getSystemPasteboard](#pasteboardgetsystempasteboard). The pasteboard supports a maximum number of 512 data records.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [addRecord](#addrecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| htmlText | string | Yes| HTML content.|
**Example**
```js ```js
var systemPasteboard = pasteboard.getSystemPasteboard(); let pasteData = pasteboard.createPlainTextData('hello');
let html = "<!DOCTYPE html>\n" + "<html>\n" + "<head>\n" + "<meta charset=\"utf-8\">\n" + "<title>HTML-PASTEBOARD_HTML</title>\n" + "</head>\n" + "<body>\n" + " <h1>HEAD</h1>\n" + " <p></p>\n" + "</body>\n" + "</html>";
pasteData.addHtmlRecord(html);
``` ```
### addWantRecord<sup>(deprecated)</sup>
### setPasteData addWantRecord(want: Want): void
setPasteData(data: PasteData, callback: AsyncCallback&lt;void&gt;): void Adds a Want record to this pasteboard, and adds **MIMETYPE_TEXT_WANT** to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
Writes a **PasteData** object to the pasteboard. This API uses an asynchronous callback to return the result. The pasteboard supports a maximum number of 512 data records.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [addRecord](#addrecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -1107,62 +993,55 @@ Writes a **PasteData** object to the pasteboard. This API uses an asynchronous c ...@@ -1107,62 +993,55 @@ Writes a **PasteData** object to the pasteboard. This API uses an asynchronous c
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| data | [PasteData](#pastedata) | Yes| **PasteData** object.| | want | [Want](js-apis-app-ability-want.md) | Yes| Want object.|
| callback | AsyncCallback&lt;void> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined**; otherwise, **err** is an error object.|
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("content"); let pasteData = pasteboard.createPlainTextData('hello');
var systemPasteboard = pasteboard.getSystemPasteboard(); let object = {
systemPasteboard.setPasteData(pasteData, (err, data) => { bundleName: "com.example.aafwk.test",
if (err) { abilityName: "com.example.aafwk.test.TwoAbility"
console.error('Failed to set PasteData. Cause: ' + err.message); };
return; pasteData.addWantRecord(object);
}
console.info('Succeeded in setting PasteData.');
});
``` ```
### addTextRecord<sup>(deprecated)</sup>
### setPasteData addTextRecord(text: string): void
setPasteData(data: PasteData): Promise&lt;void&gt; Adds a plain text record to this pasteboard, and adds **MIME_TEXT_PLAIN** to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
Writes a **PasteData** object to the pasteboard. This API uses a promise to return the result. The pasteboard supports a maximum number of 512 data records.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [addRecord](#addrecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters** **Parameters**
| Name| Type| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| data | [PasteData](#pastedata) | **PasteData** object.| | text | string | Yes| Plain text.|
**Return value**
| Type| Description|
| -------- | -------- |
| Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
```js ```js
var pasteData = pasteboard.createPlainTextData("content"); let pasteData = pasteboard.createPlainTextData('hello');
var systemPasteboard = pasteboard.getSystemPasteboard(); pasteData.addTextRecord('good');
systemPasteboard.setPasteData(pasteData).then((data) => {
console.info('Succeeded in setting PasteData.');
}).catch((err) => {
console.error('Failed to set PasteData. Cause: ' + err.message);
});
``` ```
### addUriRecord<sup>(deprecated)</sup>
### getPasteData addUriRecord(uri: string): void
getPasteData( callback: AsyncCallback&lt;PasteData&gt;): void Adds a URI record to this pasteboard, and adds **MIMETYPE_TEXT_URI** to **mimeTypes** in [PasteDataProperty](#pastedataproperty7). The parameters cannot be empty. Otherwise, the operation fails.
Obtains a **PasteData** object from the pasteboard. This API uses an asynchronous callback to return the result. The pasteboard supports a maximum number of 512 data records.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [addRecord](#addrecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -1170,53 +1049,52 @@ Obtains a **PasteData** object from the pasteboard. This API uses an asynchronou ...@@ -1170,53 +1049,52 @@ Obtains a **PasteData** object from the pasteboard. This API uses an asynchronou
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;[PasteData](#pastedata)&gt; | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is the system pasteboard data. Otherwise, **err** is an error object.| | uri | string | Yes| URI content.|
**Example** **Example**
```js ```js
var systemPasteboard = pasteboard.getSystemPasteboard(); let pasteData = pasteboard.createPlainTextData('hello');
systemPasteboard.getPasteData((err, pasteData) => { pasteData.addUriRecord('dataability:///com.example.myapplication1/user.txt');
if (err) {
console.error('Failed to get PasteData. Cause: ' + err.message);
return;
}
var text = pasteData.getPrimaryText();
});
``` ```
### getRecordAt<sup>(deprecated)</sup>
getRecordAt(index: number): PasteDataRecord
### getPasteData Obtains the specified record in the pasteboard.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [getRecord](#getrecord9).
getPasteData(): Promise&lt;PasteData&gt; **System capability**: SystemCapability.MiscServices.Pasteboard
Obtains a **PasteData** object from the pasteboard. This API uses a promise to return the result. **Parameters**
**System capability**: SystemCapability.MiscServices.Pasteboard | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| index | number | Yes| Index of the target record.|
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| Promise&lt;[PasteData](#pastedata)&gt; | Promise used to return the system pasteboard data.| | [PasteDataRecord](#pastedatarecord7) | Record with the specified index.|
**Example** **Example**
```js ```js
var systemPasteboard = pasteboard.getSystemPasteboard(); let pasteData = pasteboard.createPlainTextData('hello');
systemPasteboard.getPasteData().then((pasteData) => { let record = pasteData.getRecordAt(0);
var text = pasteData.getPrimaryText();
}).catch((err) => {
console.error('Failed to get PasteData. Cause: ' + err.message);
})
``` ```
### hasMimeType<sup>(deprecated)</sup>
### on('update')<sup>7+</sup> hasMimeType(mimeType: string): boolean
on(type: 'update', callback: () =&gt;void ): void
Subscribes to the content change event of the system pasteboard. Checks whether the pasteboard contains data of the specified type.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [hasType](#hastype9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -1224,19 +1102,115 @@ Subscribes to the content change event of the system pasteboard. ...@@ -1224,19 +1102,115 @@ Subscribes to the content change event of the system pasteboard.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | Yes| Event type. The value **'update'** indicates changes in the pasteboard content.| | mimeType | string | Yes| Type of the data to query.|
| callback | function | Yes| Callback invoked when the pasteboard content changes.|
**Return value**
| Type| Description|
| -------- | -------- |
| boolean | Returns **true** if the specified data type exists; returns **false** otherwise.|
**Example** **Example**
```js ```js
var systemPasteboard = pasteboard.getSystemPasteboard(); let pasteData = pasteboard.createPlainTextData('hello');
var listener = () => { let hasType = pasteData.hasMimeType(pasteboard.MIMETYPE_TEXT_PLAIN);
console.info('The system pasteboard has changed.');
};
systemPasteboard.on('update', listener);
``` ```
### removeRecordAt<sup>(deprecated)</sup>
removeRecordAt(index: number): boolean
Removes the record with the specified index from the pasteboard.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [removeRecord](#removerecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| index | number | Yes| Specified index.|
**Return value**
| Type| Description|
| -------- | -------- |
| boolean | Returns **true** if the operation is successful; returns **false** otherwise.|
**Example**
```js
let pasteData = pasteboard.createPlainTextData('hello');
let isRemove = pasteData.removeRecordAt(0);
```
### replaceRecordAt<sup>(deprecated)</sup>
replaceRecordAt(index: number, record: PasteDataRecord): boolean
Replaces the record with the specified index in the pasteboard with a new record.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [replaceRecord](#replacerecord9).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| index | number | Yes| Specified index.|
| record | [PasteDataRecord](#pastedatarecord7) | Yes| New record.|
**Return value**
| Type| Description|
| -------- | -------- |
| boolean | Returns **true** if the operation is successful; returns **false** otherwise.|
**Example**
```js
let pasteData = pasteboard.createPlainTextData('hello');
let record = pasteboard.createUriRecord('dataability:///com.example.myapplication1/user.txt');
let isReplace = pasteData.replaceRecordAt(0, record);
```
## SystemPasteboard
Provides **SystemPasteboard** APIs.
Before calling any **SystemPasteboard** API, you must obtain a **SystemPasteboard** object using [getSystemPasteboard](#pasteboardgetsystempasteboard).
```js
let systemPasteboard = pasteboard.getSystemPasteboard();
```
### on('update')<sup>7+</sup>
on(type: 'update', callback: () =&gt;void ): void
Subscribes to the content change event of the system pasteboard.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| type | string | Yes| Event type. The value **'update'** indicates changes in the pasteboard content.|
| callback | function | Yes| Callback invoked when the pasteboard content changes.|
**Example**
```js
let systemPasteboard = pasteboard.getSystemPasteboard();
let listener = () => {
console.info('The system pasteboard has changed.');
};
systemPasteboard.on('update', listener);
```
### off('update')<sup>7+</sup> ### off('update')<sup>7+</sup>
...@@ -1256,16 +1230,215 @@ Unsubscribes from the system pasteboard content change event. ...@@ -1256,16 +1230,215 @@ Unsubscribes from the system pasteboard content change event.
**Example** **Example**
```js ```js
let systemPasteboard = pasteboard.getSystemPasteboard();
let listener = () => { let listener = () => {
console.info('The system pasteboard has changed.'); console.info('The system pasteboard has changed.');
}; };
systemPasteboard.off('update', listener); systemPasteboard.off('update', listener);
``` ```
### clearData<sup>9+</sup>
### hasPasteData<sup>7+</sup> clearData(callback: AsyncCallback&lt;void&gt;): void
hasPasteData(callback: AsyncCallback&lt;boolean&gt;): void Clears the system pasteboard. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined**; otherwise, **err** is an error object.|
**Example**
```js
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.clearData((err, data) => {
if (err) {
console.error(`Failed to clear the pasteboard. Cause: ${err.message}`);
return;
}
console.info('Succeeded in clearing the pasteboard.');
});
```
### clearData<sup>9+</sup>
clearData(): Promise&lt;void&gt;
Clears the system pasteboard. This API uses a promise to return the result.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Return value**
| Type| Description|
| -------- | -------- |
| Promise&lt;void&gt; | Promise that returns no value.|
**Example**
```js
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.clearData().then((data) => {
console.info('Succeeded in clearing the pasteboard.');
}).catch((err) => {
console.error(`Failed to clear the pasteboard. Cause: ${err.message}`);
});
```
### setData<sup>9+</sup>
setData(data: PasteData, callback: AsyncCallback&lt;void&gt;): void
Writes a **PasteData** object to the pasteboard. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| data | [PasteData](#pastedata) | Yes| **PasteData** object.|
| callback | AsyncCallback&lt;void> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined**; otherwise, **err** is an error object.|
**Error codes**
For details about the error codes, see [Pasteboard Error Codes](../errorcodes/errorcode-pasteboard.md).
| Error Code ID| Error Message|
| -------- | -------- |
| 12900003 | Another copy or paste is in progress. |
| 12900004 | Replication is prohibited. |
**Example**
```js
let pasteData = pasteboard.createPlainTextData('content');
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.setData(pasteData, (err, data) => {
if (err) {
console.error('Failed to set PasteData. Cause: ' + err.message);
return;
}
console.info('Succeeded in setting PasteData.');
});
```
### setData<sup>9+</sup>
setData(data: PasteData): Promise&lt;void&gt;
Writes a **PasteData** object to the pasteboard. This API uses a promise to return the result.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| data | [PasteData](#pastedata) | Yes| **PasteData** object.|
**Return value**
| Type| Description|
| -------- | -------- |
| Promise&lt;void&gt; | Promise that returns no value.|
**Error codes**
For details about the error codes, see [Pasteboard Error Codes](../errorcodes/errorcode-pasteboard.md).
| Error Code ID| Error Message|
| -------- | -------- |
| 12900003 | Another copy or paste is in progress. |
| 12900004 | Replication is prohibited. |
**Example**
```js
let pasteData = pasteboard.createPlainTextData('content');
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.setData(pasteData).then((data) => {
console.info('Succeeded in setting PasteData.');
}).catch((err) => {
console.error('Failed to set PasteData. Cause: ' + err.message);
});
```
### getData<sup>9+</sup>
getData( callback: AsyncCallback&lt;PasteData&gt;): void
Obtains a **PasteData** object from the pasteboard. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;[PasteData](#pastedata)&gt; | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is the system pasteboard data. Otherwise, **err** is an error object.|
**Error codes**
For details about the error codes, see [Pasteboard Error Codes](../errorcodes/errorcode-pasteboard.md).
| Error Code ID| Error Message|
| -------- | -------- |
| 12900003 | Another copy or paste is in progress. |
**Example**
```js
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.getData((err, pasteData) => {
if (err) {
console.error('Failed to get PasteData. Cause: ' + err.message);
return;
}
let text = pasteData.getPrimaryText();
});
```
### getData<sup>9+</sup>
getData(): Promise&lt;PasteData&gt;
Obtains a **PasteData** object from the pasteboard. This API uses a promise to return the result.
**System capability**: SystemCapability.MiscServices.Pasteboard
**Return value**
| Type| Description|
| -------- | -------- |
| Promise&lt;[PasteData](#pastedata)&gt; | Promise used to return the system pasteboard data.|
**Error codes**
For details about the error codes, see [Pasteboard Error Codes](../errorcodes/errorcode-pasteboard.md).
| Error Code ID| Error Message|
| -------- | -------- |
| 12900003 | Another copy or paste is in progress. |
**Example**
```js
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.getData().then((pasteData) => {
let text = pasteData.getPrimaryText();
}).catch((err) => {
console.error('Failed to get PasteData. Cause: ' + err.message);
})
```
### hasData<sup>9+</sup>
hasData(callback: AsyncCallback&lt;boolean&gt;): void
Checks whether the system pasteboard contains data. This API uses an asynchronous callback to return the result. Checks whether the system pasteboard contains data. This API uses an asynchronous callback to return the result.
...@@ -1280,19 +1453,19 @@ Checks whether the system pasteboard contains data. This API uses an asynchronou ...@@ -1280,19 +1453,19 @@ Checks whether the system pasteboard contains data. This API uses an asynchronou
**Example** **Example**
```js ```js
systemPasteboard.hasPasteData((err, data) => { let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.hasData((err, data) => {
if (err) { if (err) {
console.error('Failed to check the PasteData. Cause: ' + JSON.stringify(err)); console.error(`Failed to check the PasteData. Cause: ${err.message}`);
return; return;
} }
console.info('Succeeded in checking the PasteData. Data: ' + JSON.stringify(data)); console.info(`Succeeded in checking the PasteData. Data: ${data}`);
}); });
``` ```
### hasData<sup>9+</sup>
### hasPasteData<sup>7+</sup> hasData(): Promise&lt;boolean&gt;
hasPasteData(): Promise&lt;boolean&gt;
Checks whether the system pasteboard contains data. This API uses a promise to return the result. Checks whether the system pasteboard contains data. This API uses a promise to return the result.
...@@ -1307,19 +1480,22 @@ Checks whether the system pasteboard contains data. This API uses a promise to r ...@@ -1307,19 +1480,22 @@ Checks whether the system pasteboard contains data. This API uses a promise to r
**Example** **Example**
```js ```js
systemPasteboard.hasPasteData().then((data) => { let systemPasteboard = pasteboard.getSystemPasteboard();
console.info('Succeeded in checking the PasteData. Data: ' + JSON.stringify(data)); systemPasteboard.hasData().then((data) => {
console.info(`Succeeded in checking the PasteData. Data: ${data}`);
}).catch((err) => { }).catch((err) => {
console.error('Failed to check the PasteData. Cause: ' + JSON.stringify(err)); console.error(`Failed to check the PasteData. Cause: ${err.message}`);
}); });
``` ```
### clear<sup>(deprecated)</sup>
### clear<sup>7+</sup>
clear(callback: AsyncCallback&lt;void&gt;): void clear(callback: AsyncCallback&lt;void&gt;): void
Clears the system pasteboard. This API uses an asynchronous callback to return the result. Clears the system pasteboard. This API uses an asynchronous callback to return the result.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.clearData](#cleardata9).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -1334,19 +1510,21 @@ Clears the system pasteboard. This API uses an asynchronous callback to return t ...@@ -1334,19 +1510,21 @@ Clears the system pasteboard. This API uses an asynchronous callback to return t
```js ```js
systemPasteboard.clear((err, data) => { systemPasteboard.clear((err, data) => {
if (err) { if (err) {
console.error('Failed to clear the PasteData. Cause: ' + JSON.stringify(err)); console.error(`Failed to clear the PasteData. Cause: ${err.message}`);
return; return;
} }
console.info('Succeeded in clearing the PasteData.'); console.info('Succeeded in clearing the PasteData.');
}); });
``` ```
### clear<sup>(deprecated)</sup>
### clear<sup>7+</sup>
clear(): Promise&lt;void&gt; clear(): Promise&lt;void&gt;
Clears the system pasteboard. This API uses a promise to return the result. Clears the system pasteboard. This API uses a promise to return the result.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [pasteboard.clearData](#cleardata9-1).
**System capability**: SystemCapability.MiscServices.Pasteboard **System capability**: SystemCapability.MiscServices.Pasteboard
...@@ -1362,6 +1540,186 @@ Clears the system pasteboard. This API uses a promise to return the result. ...@@ -1362,6 +1540,186 @@ Clears the system pasteboard. This API uses a promise to return the result.
systemPasteboard.clear().then((data) => { systemPasteboard.clear().then((data) => {
console.info('Succeeded in clearing the PasteData.'); console.info('Succeeded in clearing the PasteData.');
}).catch((err) => { }).catch((err) => {
console.error('Failed to clear the PasteData. Cause: ' + JSON.stringify(err)); console.error(`Failed to clear the PasteData. Cause: ${err.message}`);
});
```
### getPasteData<sup>(deprecated)</sup>
getPasteData( callback: AsyncCallback&lt;PasteData&gt;): void
Obtains a **PasteData** object from the pasteboard. This API uses an asynchronous callback to return the result.
> **NOTE**
>
> This API is supported since API version 6 and deprecated since API version 9. You are advised to use [getData](#getdata9).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;[PasteData](#pastedata)&gt; | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined** and **data** is the system pasteboard data. Otherwise, **err** is an error object.|
**Example**
```js
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.getPasteData((err, pasteData) => {
if (err) {
console.error('Failed to get PasteData. Cause: ' + err.message);
return;
}
let text = pasteData.getPrimaryText();
});
```
### getPasteData<sup>(deprecated)</sup>
getPasteData(): Promise&lt;PasteData&gt;
Obtains a **PasteData** object from the pasteboard. This API uses a promise to return the result.
> **NOTE**
>
> This API is supported since API version 6 and deprecated since API version 9. You are advised to use [getData](#getdata9-1).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Return value**
| Type| Description|
| -------- | -------- |
| Promise&lt;[PasteData](#pastedata)&gt; | Promise used to return the system pasteboard data.|
**Example**
```js
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.getPasteData().then((pasteData) => {
let text = pasteData.getPrimaryText();
}).catch((err) => {
console.error('Failed to get PasteData. Cause: ' + err.message);
})
```
### hasPasteData<sup>(deprecated)</sup>
hasPasteData(callback: AsyncCallback&lt;boolean&gt;): void
Checks whether the system pasteboard contains data. This API uses an asynchronous callback to return the result.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [hasData](#hasdata9).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return the result. Returns **true** if the system pasteboard contains data; returns **false** otherwise.|
**Example**
```js
systemPasteboard.hasPasteData((err, data) => {
if (err) {
console.error(`Failed to check the PasteData. Cause: ${err.message}`);
return;
}
console.info(`Succeeded in checking the PasteData. Data: ${data}`);
});
```
### hasPasteData<sup>(deprecated)</sup>
hasPasteData(): Promise&lt;boolean&gt;
Checks whether the system pasteboard contains data. This API uses a promise to return the result.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [hasData](#hasdata9-1).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Return value**
| Type| Description|
| -------- | -------- |
| Promise&lt;boolean&gt; | Promise used to return the result. Returns **true** if the system pasteboard contains data; returns **false** otherwise.|
**Example**
```js
systemPasteboard.hasPasteData().then((data) => {
console.info(`Succeeded in checking the PasteData. Data: ${data}`);
}).catch((err) => {
console.error(`Failed to check the PasteData. Cause: ${err.message}`);
});
```
### setPasteData<sup>(deprecated)</sup>
setPasteData(data: PasteData, callback: AsyncCallback&lt;void&gt;): void
Writes a **PasteData** object to the pasteboard. This API uses an asynchronous callback to return the result.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [setData](#setdata9).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| data | [PasteData](#pastedata) | Yes| **PasteData** object.|
| callback | AsyncCallback&lt;void> | Yes| Callback used to return the result. If the operation is successful, **err** is **undefined**; otherwise, **err** is an error object.|
**Example**
```js
let pasteData = pasteboard.createPlainTextData('content');
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.setPasteData(pasteData, (err, data) => {
if (err) {
console.error('Failed to set PasteData. Cause: ' + err.message);
return;
}
console.info('Succeeded in setting PasteData.');
});
```
### setPasteData<sup>(deprecated)</sup>
setPasteData(data: PasteData): Promise&lt;void&gt;
Writes a **PasteData** object to the pasteboard. This API uses a promise to return the result.
> **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [setData](#setdata9-1).
**System capability**: SystemCapability.MiscServices.Pasteboard
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| data | [PasteData](#pastedata) | Yes| **PasteData** object.|
**Return value**
| Type| Description|
| -------- | -------- |
| Promise&lt;void&gt; | Promise that returns no value.|
**Example**
```js
let pasteData = pasteboard.createPlainTextData('content');
let systemPasteboard = pasteboard.getSystemPasteboard();
systemPasteboard.setPasteData(pasteData).then((data) => {
console.info('Succeeded in setting PasteData.');
}).catch((err) => {
console.error('Failed to set PasteData. Cause: ' + err.message);
}); });
``` ```
en/application-dev/reference/errorcodes/errorcode-pasteboard.md 0 → 100644
浏览文件 @ add981c8
# Pasteboard Error Codes
## 12900001 Index Out of Range
**Error Message**
The index is out of range.
**Description**
This error code is reported when the index passed in to the called API, such as **getRecord**, is out of range.
**Possible Causes**
The index passed in the API is beyond the record index range of the **PasteData** object. For example, the index passed in to **getRecord** exceeds the number of records.
**Solution**
Check the index range and call the API again with a valid index.
## 12900002 Maximum Number of Records Reached
**Error Message**
The number of record exceeds the maximum limit.
**Description**
This error code is reported when no new **PasteData** record can be added.
**Possible Causes**
The number of **PasteData** records has reached the maximum.
**Solution**
1. Check whether the number of **PasteData** records has reached the maximum.
2. If the number of **PasteData** records has reached the maximum, delete some records before adding new ones.
## 12900003 Another Copy or Paste Operation in Progress
**Error Message**
Another copy or paste is in progress.
**Description**
This error code is reported when a new copy or paste attempt is made before the previous one is completed.
**Possible Causes**
The copy and paste APIs are both asynchronous APIs. If the data to be copied or pasted is in large amount, the time required may be long. New copy or paste operations can be performed only after the previous operations have been completed.
**Solution**
1. Before copying or pasting data, check the status of the last copy or paste operation.
2. Perform subsequent operations only after the previous copy/paste operation is completed.
## 12900004 Copy Prohibited
**Error Message**
Replication is prohibited.
**Description**
This error code is reported when an attempt is made to copy data that cannot be copied.
**Possible Causes**
The target data cannot be copied, such as read-only data.
**Solution**
Make sure the target data allows the copy action.
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或