!15942 翻译完成 15206：api9发布前终审修改

Merge pull request !15942 from ester.zhou/TR-15590

en/application-dev/reference/apis/js-apis-pasteboard.md

@@ -63,7 +63,7 @@ Creates a **PasteData** object of a custom type.
 
   ```js
   let dataXml = new ArrayBuffer(256);
-  let pasteData = pasteboard.createData('app/xml', dataXml);
+let pasteData = pasteboard.createData('app/xml', dataXml);
   ```
 
 ## pasteboard.createRecord<sup>9+</sup>
@@ -90,8 +90,8 @@ Creates a **PasteDataRecord** object of the custom type.
 **Example**
 
   ```js
-  let dataXml = new ArrayBuffer(256);
-  let pasteDataRecord = pasteboard.createRecord('app/xml', dataXml);
+let dataXml = new ArrayBuffer(256);
+let pasteDataRecord = pasteboard.createRecord('app/xml', dataXml);
   ```
 
 ## pasteboard.getSystemPasteboard
@@ -120,11 +120,11 @@ Enumerates the paste options of data.
 
 **System capability**: SystemCapability.MiscServices.Pasteboard
 
-| Name| Value| Description               |
-| ---- |---|-------------------|
-| InApp | 0 | Only intra-application pasting is allowed.     |
-| LocalDevice | 1 | Paste is allowed in any application on the local device.|
-| CrossDevice | 2 | Paste is allowed in any application across devices. |
+| Name         | Value| Description               |
+|-------------|---|-------------------|
+| INAPP       | 0 | Only intra-application pasting is allowed.     |
+| LOCALDEVICE | 1 | Paste is allowed in any application on the local device.|
+| CROSSDEVICE | 2 | Paste is allowed in any application across devices. |
 
 ## pasteboard.createHtmlData<sup>(deprecated)</sup>
 
@@ -374,14 +374,14 @@ Defines the properties of all data records on the pasteboard, including the time
 
 **System capability**: SystemCapability.MiscServices.Pasteboard
 
-| Name| Type| Readable| Writable| Description|
-| -------- | -------- | -------- | -------- | -------- |
-| additions<sup>7+</sup> | {[key:string]:object} | Yes| Yes| Additional data.|
-| mimeTypes<sup>7+</sup> | Array&lt;string&gt; | Yes| No| Non-repeating data types of the data records on the pasteboard.|
-| tag<sup>7+</sup> | string | Yes| Yes| Custom tag.|
-| timestamp<sup>7+</sup> | number | Yes| No| Timestamp when data is written to the pasteboard (unit: ms).|
+| Name| Type| Readable| Writable| Description                                                                                        |
+| -------- | -------- | -------- | -------- |--------------------------------------------------------------------------------------------|
+| additions<sup>7+</sup> | {[key:string]:object} | Yes| Yes| Additional data.                                                                              |
+| mimeTypes<sup>7+</sup> | Array&lt;string&gt; | Yes| No| Non-repeating data types of the data records on the pasteboard.                                                                    |
+| tag<sup>7+</sup> | string | Yes| Yes| Custom tag.                                                                                  |
+| timestamp<sup>7+</sup> | number | Yes| No| Timestamp when data is written to the pasteboard (unit: ms).                                                                       |
 | 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>
 
@@ -401,38 +401,11 @@ Provides **PasteDataRecord** APIs. A **PasteDataRecord** is an abstract definiti
 | pixelMap<sup>9+</sup> | [image.PixelMap](js-apis-image.md#pixelmap7) | Yes| No| Pixel map.|
 | data<sup>9+</sup> | {[mimeType: string]: ArrayBuffer} | Yes| No| Content of custom data.|
 
-### convertToTextV9<sup>9+</sup>
-
-convertToTextV9(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.
-
-**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.createRecord(pasteboard.MIMETYPE_TEXT_URI, '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}`);
-});
-```
+### toPlainText<sup>9+</sup>
 
-### convertToTextV9<sup>9+</sup>
+toPlainText(): string
 
-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.
 
 **System capability**: SystemCapability.MiscServices.Pasteboard
 
@@ -440,17 +413,14 @@ Forcibly converts the content in a **PasteData** object to text. This API uses a
 
 | Type| Description|
 | -------- | -------- |
-| Promise&lt;string&gt; | Promise used to return the text obtained from the conversion.|
+| string | Plain text.|
 
 **Example**
 
 ```js
 let record = pasteboard.createRecord(pasteboard.MIMETYPE_TEXT_URI, 'dataability:///com.example.myapplication1/user.txt');
-record.convertToTextV9().then((data) => {
-    console.info(`Succeeded in converting to text. Data: ${data}`);
-}).catch((err) => {
-    console.error(`Failed to convert to text. Cause: ${err.message}`);
-});
+let data = record.toPlainText();
+console.info(`Succeeded in converting to text. Data: ${data}`);
 ```
 
 ### convertToText<sup>(deprecated)</sup>
@@ -460,7 +430,7 @@ 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.
 > **NOTE**
 >
-> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [convertToTextV9](#converttotextv99).
+> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [toPlainText](#toplaintext9).
 
 **System capability**: SystemCapability.MiscServices.Pasteboard
 
@@ -490,7 +460,7 @@ 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).
+> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [toPlainText](#toplaintext9).
 
 **System capability**: SystemCapability.MiscServices.Pasteboard
 
@@ -782,7 +752,7 @@ Sets the property (attributes) for the pasteboard data. Currently, only the **sh
 ```js
 let pasteData = pasteboard.createData(pasteboard.MIMETYPE_TEXT_HTML, 'application/xml');
 let prop = pasteData.getProperty();
-prop.shareOption = pasteboard.ShareOption.InApp;
+prop.shareOption = pasteboard.ShareOption.INAPP;
 pasteData.setProperty(prop);
 ```
 

en/release-notes/changelogs/OpenHarmony_4.0.3.2/changelogs-pasteboard.md

+# Pasteboard Subsystem Changelog
+
+OpenHarmony 4.0.3.2 has the following changes in the APIs of the pasteboard subsystem:
+
+## cl.pasteboard.1 convertToTextV9 API Change
+
+Renamed **convertToTextV9** **toPlainText()** and changed the API from asynchronous to synchronous.
+
+**Change Impact**
+
+Applications developed using the **convertToTextV9** API in versions earlier than OpenHarmony 4.0.3.3 cannot be used in OpenHarmony 4.0.3.3 and later versions.
+
+**Key API/Component Changes**
+
+- Involved APIs:
+
+  function convertToTextV9
+
+- Before change:
+
+  ```ts
+  convertToTextV9(callback: AsyncCallback<string>): void;
+  convertToTextV9(): Promise<string>;
+  ```
+
+- After change:
+
+  ```ts
+  toPlainText(): string;
+  ```
+
+
+**Adaptation Guide**
+
+Replace **convertToTextV9**, an asynchronous API, with **toPlainText**, a synchronous API.
+
+## cl.pasteboard.2 ShareOption Enum Name Change
+
+Changed the enum names of **ShareOption** from UpperCamelCase to all caps.
+
+**Change Impact**
+
+Applications developed using the **InApp/LocalDevice/CrossDevice** attributes in versions earlier than OpenHarmony 4.0.3.3 cannot be used in OpenHarmony 4.0.3.3 and later versions.
+
+**Key API/Component Changes**
+
+ShareOption<sup>9+</sup>
+
+Before change:
+| Name| Value| Description               |
+| ---- |---|-------------------|
+| InApp | 0 | Only intra-application pasting is allowed.     |
+| LocalDevice | 1 | Paste is allowed in any application on the local device.|
+| CrossDevice | 2 | Paste is allowed in any application across devices. |
+
+
+After change:
+| Name| Value| Description               |
+| ---- |---|-------------------|
+| INAPP | 0 | Only intra-application pasting is allowed.     |
+| LOCALDEVICE | 1 | Paste is allowed in any application on the local device.|
+| CROSSDEVICE | 2 | Paste is allowed in any application across devices. |
+
+**Adaptation Guide**
+
+Perform adaptation based on the new semantics.