!13945 新增接口raiseToAppTop说明

Merge pull request !13945 from 张凯/add_raisetoapptop_desc

zh-cn/application-dev/reference/apis/js-apis-window.md

@@ -4265,6 +4265,83 @@ try {
 }
 ```
 
+### raiseToAppTop<sup>10+</sup>
+
+raiseToAppTop(callback: AsyncCallback&lt;void&gt;): void
+
+提升应用子窗口到应用顶层。使用callback异步回调。
+
+**系统接口：** 此接口为系统接口。
+
+**系统能力：** SystemCapability.WindowManager.WindowManager.Core
+
+**参数：**
+
+| 参数名   | 类型                      | 必填 | 说明       |
+| -------- | ------------------------- | ---- | ---------- |
+| callback | AsyncCallback&lt;void&gt; | 是   | 回调函数。 |
+
+**错误码：**
+
+以下错误码的详细介绍请参见[窗口错误码](../errorcodes/errorcode-window.md)。
+
+| 错误码ID | 错误信息 |
+| ------- | ------------------------------ |
+| 1300002 | This window state is abnormal. |
+| 1300003 | This window manager service works abnormally. |
+| 1300004 | Unauthorized operation. |
+| 1300009 | The parent window is invalid. |
+
+**示例：**
+
+```js
+windowClass.raiseToAppTop((err) => {
+    if (err.code) {
+        console.error('Failed to raise the window to app top. Cause: ' + JSON.stringify(err));
+        return;
+    }
+    console.info('Succeeded in raising the window to app top.');
+});
+```
+
+### raiseToAppTop<sup>10+</sup>
+
+raiseToAppTop(): Promise&lt;void&gt;
+
+提升应用子窗口到应用顶层。使用Promise异步回调。
+
+**系统接口：** 此接口为系统接口。
+
+**系统能力：** SystemCapability.WindowManager.WindowManager.Core
+
+**返回值：**
+
+| 类型                | 说明                      |
+| ------------------- | ------------------------- |
+| Promise&lt;void&gt; | 无返回结果的Promise对象。 |
+
+**错误码：**
+
+以下错误码的详细介绍请参见[窗口错误码](../errorcodes/errorcode-window.md)。
+
+| 错误码ID | 错误信息 |
+| ------- | ------------------------------ |
+| 1300002 | This window state is abnormal. |
+| 1300003 | This window manager service works abnormally. |
+| 1300004 | Unauthorized operation. |
+| 1300009 | The parent window is invalid. |
+
+**示例：**
+
+```js
+let promise = windowClass.raiseToAppTop();
+promise.then(()=> {
+    console.info('Succeeded in raising the window to app top.');
+}).catch((err)=>{
+    console.error('Failed to raise the window to app top. Cause: ' + JSON.stringify(err));
+});
+```
+
 ### show<sup>(deprecated)</sup>
 
 show(callback: AsyncCallback&lt;void&gt;): void

zh-cn/application-dev/reference/errorcodes/errorcode-window.md

@@ -77,3 +77,58 @@ This window context is abnormal.
 
 **处理步骤**<br>
 在对窗口上下文进行操作前，检查该窗口上下文是否存在，确保其未被销毁，再进行相关操作。
+
+## 1300007 WindowExtension拉起应用失败
+
+**错误信息**<br>
+Start ability failed.
+
+**错误描述**<br>
+WindowExtension拉起应用失败。
+
+**可能原因**<br>
+WindowExtension拉起应用的参数异常。
+
+**处理步骤**<br>
+检查WindowExtension参数是否被异常修改，确保其参数合法，再进行相关操作。
+
+## 1300008 显示设备异常
+
+**错误信息**<br>The operation is on invalid display.
+
+**错误描述**<br>显示设备异常。
+
+**可能原因**<br>
+1. 显示设备没有准备好。<br>
+2. 显示设备被移除。<br>
+3. 显示设备被损坏。
+
+**处理步骤**<br>确保显示设备正常，再进行相关开发。
+
+## 1300009 父窗口无效
+
+**错误信息**<br>The parent window is invalid.
+
+**错误描述**<br>父窗口无效。
+
+**可能原因**<br>
+1. 子窗口没有绑定父窗口。<br>
+2. 子窗口绑定的父窗口异常，如父窗口已被销毁等。
+
+**处理步骤**<br>
+1. 检查确保子窗口成功绑定父窗口。<br>
+2. 检查子窗口绑定的父窗口状态，确保父窗口状态正常。
+
+## 1300010 全屏窗口的无效操作
+
+**错误信息**<br>This operation is not support in fullscreen.
+
+**错误描述**<br>全屏窗口下的无效操作。
+
+**可能原因**<br>
+1. 对全屏窗口进行move操作。<br>
+2. 对全屏窗口进行resize操作。
+
+**处理步骤**<br>
+1. 不要对全屏窗口进行move操作。<br>
+2. 不要对全屏窗口进行resize操作。
\ No newline at end of file