From 3845f9d3d55db4890275dee0d18dbf1b544435fb Mon Sep 17 00:00:00 2001 From: ge-yafang Date: Fri, 20 May 2022 16:32:07 +0800 Subject: [PATCH] update docs Signed-off-by: ge-yafang --- .../quick-start/start-with-ets-low-code.md | 8 +- .../quick-start/start-with-ets.md | 6 +- .../quick-start/start-with-js-low-code.md | 6 +- .../quick-start/start-with-js.md | 5 +- .../reference/apis/js-apis-window.md | 1302 ++++++++--------- 5 files changed, 588 insertions(+), 739 deletions(-) diff --git a/zh-cn/application-dev/quick-start/start-with-ets-low-code.md b/zh-cn/application-dev/quick-start/start-with-ets-low-code.md index 9bc7dff91d..81e1cf99a9 100644 --- a/zh-cn/application-dev/quick-start/start-with-ets-low-code.md +++ b/zh-cn/application-dev/quick-start/start-with-ets-low-code.md @@ -17,7 +17,7 @@ OpenHarmony低代码开发方式具有丰富的UI界面编辑功能，通过可 - 直接创建一个支持低代码开发的新工程以进行开发。本文以此方式为例进行说明。 -- 在已有工程中，创建Visual文件来进行开发。 +- 在已有工程中，创建visual文件来进行开发。 ## 创建新工程支持低代码开发 @@ -46,9 +46,9 @@ OpenHarmony低代码开发方式具有丰富的UI界面编辑功能，通过可 ## 构建第一个页面 -工程同步完成后，第一个页面已有一个容器、文本（Hello World）显示。为了更详细地了解低代码开发，我们将删除画布原有模板组件，从零开始完成页面的添加、设置。 +工程同步完成后，第一个页面已有一个容器、一段文本（Hello World）显示。为了更详细地了解低代码开发，我们将删除画布原有模板组件，从零开始完成页面的添加、设置。 -第一个页面内有一个容器、文本和一个按钮，通过Column、Text和Button组件来实现。其中，Column为沿垂直方向布局的容器组件，具体使用请见[Column](../reference/arkui-ts/ts-container-column.md)。 +第一个页面内有一个容器、一段文本和一个按钮，通过Column、Text和Button组件来实现。其中，Column为沿垂直方向布局的容器组件，具体使用请见[Column](../reference/arkui-ts/ts-container-column.md)。 1. 删除画布原有模板组件。 打开index.visual文件，选中画布中的组件，单击鼠标右键，选择Delete删除画布原有模板组件。操作如下所示： @@ -107,7 +107,7 @@ OpenHarmony低代码开发方式具有丰富的UI界面编辑功能，通过可 ``` - 选中Text组件，将其拖至画布，再拖至Column组件的中央区域。点击右侧属性样式栏中的图标![zh-cn_image_0000001277488985](figures/zh-cn_image_0000001277488985.png)（Feature），设置Text组件的Content属性为“this.message”（即“Hi there”）；设置Text组件的FontSize样式为30fp；设置组件的TextAlign样式为center。再选中画布上的Text组件，拖动放大。操作如下所示： - ![zh-cn_image_0000001280255513](figures/zh-cn_image_0000001277608817.gif) + ![zh-cn_image_0000001280255513](figures/zh-cn_image_0000001277608817.gif) 5. 添加按钮。 选中UI Control中的Button组件，将其拖至画布，再拖至Text组件下面。点击右侧属性样式栏中的图标![zh-cn_image_0000001233528160](figures/zh-cn_image_0000001233528160.png)（General），设置Button组件的Height为40vp；点击右侧属性样式栏中的图标![zh-cn_image_0000001277728597](figures/zh-cn_image_0000001277728597.png)（Feature），设置Button组件的Value属性为“Back”；设置组件的FontSize样式为25fp，使得其文字放大。操作如下所示： diff --git a/zh-cn/application-dev/quick-start/start-with-ets.md b/zh-cn/application-dev/quick-start/start-with-ets.md index 0b84c9b3f6..8f85148746 100644 --- a/zh-cn/application-dev/quick-start/start-with-ets.md +++ b/zh-cn/application-dev/quick-start/start-with-ets.md @@ -64,7 +64,7 @@ ``` 2. 添加按钮。 - 在默认页面基础上，我们添加一个Button组件，作为按钮接收用户点击的动作，从而实现跳转到另一个页面。“**index.ets**”文件的示例如下： + 在默认页面基础上，我们添加一个Button组件，作为按钮响应用户点击，从而实现跳转到另一个页面。“**index.ets**”文件的示例如下： ``` @@ -79,7 +79,7 @@ Text(this.message) .fontSize(50) .fontWeight(FontWeight.Bold) - // 添加按钮，以接收用户点击 + // 添加按钮，以响应用户点击 Button() { Text('Next') .fontSize(30) @@ -171,7 +171,7 @@ Text(this.message) .fontSize(50) .fontWeight(FontWeight.Bold) - // 添加按钮，以接收用户点击 + // 添加按钮，以响应用户点击 Button() { Text('Next') .fontSize(30) diff --git a/zh-cn/application-dev/quick-start/start-with-js-low-code.md b/zh-cn/application-dev/quick-start/start-with-js-low-code.md index f8b9a22bda..4b7db2ab59 100644 --- a/zh-cn/application-dev/quick-start/start-with-js-low-code.md +++ b/zh-cn/application-dev/quick-start/start-with-js-low-code.md @@ -15,7 +15,7 @@ OpenHarmony低代码开发方式具有丰富的UI界面编辑功能，通过可 - 直接创建一个支持低代码开发的新工程以进行开发。本文以此方式为例进行说明。 -- 在已有工程中，创建Visual文件来进行开发。 +- 在已有工程中，创建visual文件来进行开发。 ## 创建新工程支持低代码开发 @@ -50,9 +50,9 @@ OpenHarmony低代码开发方式具有丰富的UI界面编辑功能，通过可 ## 构建第一个页面 -工程同步完成后，第一个页面已有一个容器、文本（Hello World）显示。为了更详细地了解低代码开发，我们将删除画布原有模板组件，从零开始完成页面的添加、设置。 +工程同步完成后，第一个页面已有一个容器、一段文本（Hello World）显示。为了更详细地了解低代码开发，我们将删除画布原有模板组件，从零开始完成页面的添加、设置。 -第一个页面内有一个容器、文本和一个按钮，通过Div、Text和Button组件来实现。 +第一个页面内有一个容器、一段文本和一个按钮，通过Div、Text和Button组件来实现。 1. 删除画布原有模板组件。 打开index.visual文件，选中画布中的组件，单击鼠标右键，选择Delete删除画布原有模板组件。操作如下所示： diff --git a/zh-cn/application-dev/quick-start/start-with-js.md b/zh-cn/application-dev/quick-start/start-with-js.md index 92c118691f..0d41f5245e 100644 --- a/zh-cn/application-dev/quick-start/start-with-js.md +++ b/zh-cn/application-dev/quick-start/start-with-js.md @@ -52,7 +52,7 @@ ``` 2. 添加按钮，并绑定onclick方法。 - 在默认页面基础上，我们添加一个button类型的input组件，作为按钮接收用户点击的动作，从而实现跳转到另一个页面。“**index.hml**”文件的示例代码如下： + 在默认页面基础上，我们添加一个button类型的input组件，作为按钮响应用户点击，从而实现跳转到另一个页面。“**index.hml**”文件的示例代码如下： ``` @@ -102,6 +102,7 @@ 4. 在编辑窗口右上角的侧边工具栏，点击Previewer，打开预览器。第一个页面效果如下图所示： + ![zh-cn_image_0000001216084724](figures/zh-cn_image_0000001216084724.png) @@ -214,4 +215,4 @@ 恭喜您已经使用JS语言开发（传统代码方式）完成了第一个OpenHarmony应用，快来[探索更多的OpenHarmony功能](../application-dev-guide.md)吧。 ## 相关实例 针对使用JS语言（传统代码方式）开发快速入门，有以下相关实例可供参考： -- [`JsHelloWorld`：你好世界（JS）（API8）](https://gitee.com/openharmony/app_samples/tree/master/common/JsHelloWorld) \ No newline at end of file +- [`JsHelloWorld`：你好世界（JS）（API8）](https://gitee.com/openharmony/app_samples/tree/master/common/JsHelloWorld) diff --git a/zh-cn/application-dev/reference/apis/js-apis-window.md b/zh-cn/application-dev/reference/apis/js-apis-window.md index 23128940e0..2e230b1e5c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-window.md +++ b/zh-cn/application-dev/reference/apis/js-apis-window.md @@ -2,10 +2,11 @@ 窗口提供管理窗口的一些基础能力，包括对窗口的创建、销毁，以及对窗口的属性设置等各项功能。 -> **说明：** -> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：** > -> API 9当前为Canary版本，仅供试用，不保证接口可稳定调用。 +> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> +> API 9当前为Canary版本，仅供试用，不保证接口可稳定调用。 ## 导入模块 @@ -110,7 +111,7 @@ import window from '@ohos.window'; ## AvoidArea7+ -表示窗口内容规避区域。 +窗口内容规避区域。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.WindowManager.WindowManager.Core。 @@ -138,20 +139,19 @@ import window from '@ohos.window'; **系统能力：** 以下各项对应的系统能力均为SystemCapability.WindowManager.WindowManager.Core。 -| 名称 | 参数类型 | 可读 | 可写 | 说明 | -| ------------------------------- | ------------------------- | ---- | ---- | ------------------------------------------------------------ | -| windowRect7+ | [Rect](#rect) | 是 | 是 | 窗口尺寸。 | -| type7+ | [WindowType](#windowtype) | 是 | 是 | 窗口类型。 | -| isFullScreen | boolean | 是 | 是 | 是否全屏，默认为false。 | -| isLayoutFullScreen7+ | boolean | 是 | 是 | 窗口是否为沉浸式，默认为false。 | -| focusable7+ | boolean | 是 | 否 | 窗口是否可聚焦，默认为true。 | -| touchable7+ | boolean | 是 | 否 | 窗口是否可触摸，默认为true。 | -| brightness | number | 是 | 是 | 屏幕亮度， 取值范围为0~1，1表示最大亮度值。
本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 | -| dimBehindValue7+ | number | 是 | 是 | 靠后窗口的暗度值，取值范围为0~1，1表示最暗。
本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 | -| isKeepScreenOn | boolean | 是 | 是 | 屏幕是否常亮，默认为false。
本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 | -| isPrivacyMode7+ | boolean | 是 | 是 | 隐私模式，默认为false。
本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 | -| isRoundCorner7+ | boolean | 是 | 是 | 窗口是否为圆角。默认为false。
本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 | -| isTransparent7+ | boolean | 是 | 是 | 窗口是否透明。默认为false。
本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 | +| 名称 | 参数类型 | 可读 | 可写 | 说明 | +| ------------------------------- | ------------------------- | ---- | ---- | -------------------------------------------- | +| windowRect7+ | [Rect](#rect) | 是 | 是 | 窗口尺寸。 | +| type7+ | [WindowType](#windowtype) | 是 | 是 | 窗口类型。 | +| isFullScreen | boolean | 是 | 是 | 是否全屏，默认为false。 | +| isLayoutFullScreen7+ | boolean | 是 | 是 | 窗口是否为沉浸式，默认为false。 | +| focusable7+ | boolean | 是 | 否 | 窗口是否可聚焦，默认为true。 | +| touchable7+ | boolean | 是 | 否 | 窗口是否可触摸，默认为true。 | +| brightness | number | 是 | 是 | 屏幕亮度， 取值范围为0~1，1表示最大亮度值。 | +| isKeepScreenOn | boolean | 是 | 是 | 屏幕是否常亮，默认为false。 | +| isPrivacyMode7+ | boolean | 是 | 是 | 隐私模式，默认为false。 | +| isRoundCorner7+ | boolean | 是 | 是 | 窗口是否为圆角。默认为false。 | +| isTransparent7+ | boolean | 是 | 是 | 窗口是否透明。默认为false。 | ## ColorSpace8+ @@ -168,21 +168,21 @@ import window from '@ohos.window'; create(id: string, type: WindowType, callback: AsyncCallback<Window>): void -创建子窗口，使用callback方式作为异步方法。 +创建子窗口，使用callback异步回调。 从API version 8开始，此接口废弃，推荐使用[window.create8+](#windowcreate8)接口。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------------------------------------- | ---- | -------------------------- | - | id | string | 是 | 窗口id。 | - | type | [WindowType](#windowtype) | 是 | 窗口类型。 | - | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回创建的子窗口对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------- | ---- | -------------------------- | +| id | string | 是 | 窗口id。 | +| type | [WindowType](#windowtype) | 是 | 窗口类型。 | +| callback | AsyncCallback<[Window](#window)> | 是 | 回调返回创建的子窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -201,26 +201,26 @@ create(id: string, type: WindowType, callback: AsyncCallback<Window>): voi create(id: string, type: WindowType): Promise<Window> -创建子窗口，使用Promise方式作为异步方法。 +创建子窗口，使用Promise异步回调。 从API version 8开始，此接口废弃，推荐使用[window.create8+](#windowcreate8)接口。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------------------------- | ---- | ---------- | - | id | string | 是 | 窗口id。 | - | type | [WindowType](#windowtype) | 是 | 窗口类型。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------------------------- | ---- | ---------- | +| id | string | 是 | 窗口id。 | +| type | [WindowType](#windowtype) | 是 | 窗口类型。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | -------------------------------- | ------------------------------------------------- | - | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前创建的子窗口对象。 | +| 类型 | 说明 | +| -------------------------------- | ------------------------------------------------- | +| Promise<[Window](#window)> | 以Promise形式返回结果，返回当前创建的子窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -237,22 +237,22 @@ create(id: string, type: WindowType): Promise<Window> create(ctx: Context, id: string, type: WindowType, callback: AsyncCallback<Window>): void -创建子窗口，使用callback方式作为异步方法，其中Context详见[Context](js-apis-Context.md)。 +创建子窗口，使用callback异步回调，其中Context详见[Context](js-apis-Context.md)。 -从API version 9开始，当Context为[ServiceExtensionContext](js-apis-service-extension-context.md)时，创建系统窗口，使用callback方式作为异步方法。 +从API version 9开始，当Context为[ServiceExtensionContext](js-apis-service-extension-context.md)时，创建系统窗口，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------------------------------------- | ---- | ------------------------------------------------------------ | - | ctx | Context | 是 | 当前应用上下文信息。
API version 8的Context定义见[Context](js-apis-Context.md)。
API version 9的Context定义见[Context](js-apis-service-extension-context.md)。 | - | id | string | 是 | 窗口id。 | - | type | [WindowType](#windowtype) | 是 | 窗口类型。 | - | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前窗口对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------- | ---- | ------------------------------------------------------------ | +| ctx | Context | 是 | 当前应用上下文信息。
API version 8的Context定义见[Context](js-apis-Context.md)。
API version 9的Context定义见[Context](js-apis-service-extension-context.md)。 | +| id | string | 是 | 窗口id。 | +| type | [WindowType](#windowtype) | 是 | 窗口类型。 | +| callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -271,27 +271,27 @@ create(ctx: Context, id: string, type: WindowType, callback: AsyncCallback<Wi create(ctx: Context, id: string, type: WindowType): Promise<Window> -创建子窗口，使用Promise方式作为异步方法，其中Context详见[Context](js-apis-Context.md)。 +创建子窗口，使用Promise异步回调，其中Context详见[Context](js-apis-Context.md)。 -从API version 9开始，当Context为[ServiceExtensionContext](js-apis-service-extension-context.md)时，创建系统窗口，使用Promise方式作为异步方法。 +从API version 9开始，当Context为[ServiceExtensionContext](js-apis-service-extension-context.md)时，创建系统窗口，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------------------------- | ---- | ------------------------------------------------------------ | - | ctx | Context | 是 | 当前应用上下文信息。
API version 8的Context定义见[Context](js-apis-Context.md)。
API version 9的Context定义见[Context](js-apis-service-extension-context.md)。 | - | id | string | 是 | 窗口id。 | - | type | [WindowType](#windowtype) | 是 | 窗口类型。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------------------------- | ---- | ------------------------------------------------------------ | +| ctx | Context | 是 | 当前应用上下文信息。
API version 8的Context定义见[Context](js-apis-Context.md)。
API version 9的Context定义见[Context](js-apis-service-extension-context.md)。 | +| id | string | 是 | 窗口id。 | +| type | [WindowType](#windowtype) | 是 | 窗口类型。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | -------------------------------- | ----------------------------------------------- | - | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前创建的窗口对象。 | +| 类型 | 说明 | +| -------------------------------- | ----------------------------------------------- | +| Promise<[Window](#window)> | 以Promise形式返回结果，返回当前创建的窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -308,18 +308,18 @@ create(ctx: Context, id: string, type: WindowType): Promise<Window> find(id: string, callback: AsyncCallback<Window>): void -查找id所对应的窗口，使用callback方式作为异步方法。 +查找id所对应的窗口，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------------------------------------- | ---- | ---------------------------- | - | id | string | 是 | 窗口id。 | - | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前查找的窗口对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------- | ---- | ---------------------------- | +| id | string | 是 | 窗口id。 | +| callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前查找的窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -337,23 +337,23 @@ find(id: string, callback: AsyncCallback<Window>): void find(id: string): Promise<Window> -查找id所对应的窗口，使用Promise方式作为异步方法。 +查找id所对应的窗口，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------ | ---- | -------- | - | id | string | 是 | 窗口id。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------- | +| id | string | 是 | 窗口id。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | -------------------------------- | ----------------------------------------------- | - | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前查找的窗口对象。 | +| 类型 | 说明 | +| -------------------------------- | ----------------------------------------------- | +| Promise<[Window](#window)> | 以Promise形式返回结果，返回当前查找的窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -370,19 +370,19 @@ find(id: string): Promise<Window> getTopWindow(callback: AsyncCallback<Window>): void -获取当前应用内最后显示的窗口，使用callback方式作为异步方法。 +获取当前应用内最后显示的窗口，使用callback异步回调。 从API version 8开始，此接口废弃，推荐使用[window.getTopWindow8+](#windowgettopwindow8)接口。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------------------------------------- | ---- | -------------------------------------- | - | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前应用内最后显示的窗口对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------- | ---- | -------------------------------------- | +| callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前应用内最后显示的窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -400,19 +400,19 @@ getTopWindow(callback: AsyncCallback<Window>): void getTopWindow(): Promise<Window> -获取当前应用内最后显示的窗口，使用Promise方式作为异步方法。 +获取当前应用内最后显示的窗口，使用Promise异步回调。 从API version 8开始，此接口废弃，推荐使用[window.getTopWindow8+](#windowgettopwindow8)接口。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | -------------------------------- | --------------------------------------------------------- | - | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前应用内最后显示的窗口对象。 | +| 类型 | 说明 | +| -------------------------------- | --------------------------------------------------------- | +| Promise<[Window](#window)> | 以Promise形式返回结果，返回当前应用内最后显示的窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -429,18 +429,18 @@ getTopWindow(): Promise<Window> getTopWindow(ctx: Context, callback: AsyncCallback<Window>): void -获取当前应用内最后显示的窗口，使用callback方式作为异步方法。 +获取当前应用内最后显示的窗口，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------------------------------------- | ---- | ------------------------------------------------------------ | - | ctx | Context | 是 | 当前应用上下文信息。
API version 8的Context定义见[Context](js-apis-Context.md)。
API version 9的Context定义见[Context](js-apis-ability-context.md)。 | - | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前应用内最后显示的窗口对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------- | ---- | ------------------------------------------------------------ | +| ctx | Context | 是 | 当前应用上下文信息。
API version 8的Context定义见[Context](js-apis-Context.md)。
API version 9的Context定义见[Context](js-apis-ability-context.md)。 | +| callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前应用内最后显示的窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -458,23 +458,23 @@ getTopWindow(ctx: Context, callback: AsyncCallback<Window>): void getTopWindow(ctx: Context): Promise<Window> -获取当前应用内最后显示的窗口，使用Promise方式作为异步方法。 +获取当前应用内最后显示的窗口，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------- | ---- | ------------------------------------------------------------ | - | ctx | Context | 是 | 当前应用上下文信息。
API version 8的Context定义见[Context](js-apis-Context.md)。
API version 9的Context定义见[Context](js-apis-ability-context.md)。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------- | ---- | ------------------------------------------------------------ | +| ctx | Context | 是 | 当前应用上下文信息。
API version 8的Context定义见[Context](js-apis-Context.md)。
API version 9的Context定义见[Context](js-apis-ability-context.md)。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | -------------------------------- | --------------------------------------------------------- | - | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前应用内最后显示的窗口对象。 | +| 类型 | 说明 | +| -------------------------------- | --------------------------------------------------------- | +| Promise<[Window](#window)> | 以Promise形式返回结果，返回当前应用内最后显示的窗口对象。 | -**示例：** +**示例：** ```js var windowClass = null; @@ -497,14 +497,14 @@ on(type: 'systemBarTintChange', callback: Callback<SystemBarTintState>): v **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | --------------------------------------------------------- | ---- | ------------------------------------------------------------ | - | type | string | 是 | 监听事件，固定为'systemBarTintChange'，即导航栏、状态栏属性变化事件。 | - | callback | Callback<[SystemBarTintState](#systembartintstate)> | 是 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------------------------- | ---- | ------------------------------------------------------------ | +| type | string | 是 | 监听事件，固定为'systemBarTintChange'，即导航栏、状态栏属性变化事件。 | +| callback | Callback<[SystemBarTintState](#systembartintstate)> | 是 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```js var type = 'systemBarTintChange'; @@ -523,14 +523,14 @@ off(type: 'systemBarTintChange', callback?: Callback<SystemBarTintState >) **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | --------------------------------------------------------- | ---- | ------------------------------------------------------------ | - | type | string | 是 | 监听事件，固定为'systemBarTintChange'，即导航栏、状态栏属性变化事件。 | - | callback | Callback<[SystemBarTintState](#systembartintstate)> | 否 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------------------------- | ---- | ------------------------------------------------------------ | +| type | string | 是 | 监听事件，固定为'systemBarTintChange'，即导航栏、状态栏属性变化事件。 | +| callback | Callback<[SystemBarTintState](#systembartintstate)> | 否 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```js var type = 'systemBarTintChange'; @@ -539,25 +539,25 @@ off(type: 'systemBarTintChange', callback?: Callback<SystemBarTintState >) ## Window -下列API示例中都需使用[getTopWindow()](#windowgettopwindow)、[create()](#windowcreate7)、[find()](#windowfind7)等先获取到Window实例，再通过此实例调用对应方法。 +下列API示例中都需先使用[getTopWindow()](#windowgettopwindow)、[create()](#windowcreate7)、[find()](#windowfind7)中的任一方法获取到Window实例，再通过此实例调用对应方法。 ### hide7+ hide (callback: AsyncCallback<void>): void -隐藏当前窗口，使用callback方式作为异步方法。 +隐藏当前窗口，使用callback异步回调。 此接口为系统接口，三方应用不支持调用。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------- | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ---------- | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js windowClass.hide((err, data) => { @@ -573,19 +573,19 @@ hide (callback: AsyncCallback<void>): void hide(): Promise<void> -隐藏当前窗口，使用Promise方式作为异步方法。 +隐藏当前窗口，使用Promise异步回调。 此接口为系统接口，三方应用不支持调用。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js let promise = windowClass.hide(); @@ -600,17 +600,17 @@ hide(): Promise<void> show(callback: AsyncCallback<void>): void -显示当前窗口，使用callback方式作为异步方法。 +显示当前窗口，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------- | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ---------- | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js windowClass.show((err, data) => { @@ -626,17 +626,17 @@ show(callback: AsyncCallback<void>): void show(): Promise<void> -显示当前窗口，使用Promise方式作为异步方法。 +显示当前窗口，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js let promise = windowClass.show(); @@ -651,17 +651,17 @@ show(): Promise<void> destroy(callback: AsyncCallback<void>): void -销毁当前窗口，使用callback方式作为异步方法。 +销毁当前窗口，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------- | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ---------- | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js windowClass.destroy((err, data) => { @@ -677,17 +677,17 @@ destroy(callback: AsyncCallback<void>): void destroy(): Promise<void> -销毁当前窗口，使用Promise方式作为异步方法。 +销毁当前窗口，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js let promise = windowClass.destroy(); @@ -702,19 +702,19 @@ destroy(): Promise<void> moveTo(x: number, y: number, callback: AsyncCallback<void>): void -移动窗口位置，使用callback方式作为异步方法。 +移动窗口位置，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | --------------------------------------- | - | x | number | 是 | 窗口在x轴方向移动的值，值为正表示右移。 | - | y | number | 是 | 窗口在y轴方向移动的值，值为正表示下移。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | --------------------------------------- | +| x | number | 是 | 窗口在x轴方向移动的值，值为正表示右移。 | +| y | number | 是 | 窗口在y轴方向移动的值，值为正表示下移。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js windowClass.moveTo(300, 300, (err, data)=>{ @@ -731,24 +731,24 @@ moveTo(x: number, y: number, callback: AsyncCallback<void>): void moveTo(x: number, y: number): Promise<void> -移动窗口位置，使用Promise方式作为异步方法。 +移动窗口位置，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------ | ---- | --------------------------------------- | - | x | number | 是 | 窗口在x轴方向移动的值，值为正表示右移。 | - | y | number | 是 | 窗口在y轴方向移动的值，值为正表示下移。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | --------------------------------------- | +| x | number | 是 | 窗口在x轴方向移动的值，值为正表示右移。 | +| y | number | 是 | 窗口在y轴方向移动的值，值为正表示下移。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js let promise = windowClass.moveTo(300, 300); @@ -763,19 +763,19 @@ moveTo(x: number, y: number): Promise<void> resetSize(width: number, height: number, callback: AsyncCallback<void>): void -改变当前窗口大小，使用callback方式作为异步方法。 +改变当前窗口大小，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------------- | - | width | number | 是 | 目标窗口的宽度。 | - | height | number | 是 | 目标窗口的高度。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ---------------- | +| width | number | 是 | 目标窗口的宽度。 | +| height | number | 是 | 目标窗口的高度。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js windowClass.resetSize(500, 1000, (err, data) => { @@ -791,24 +791,24 @@ resetSize(width: number, height: number, callback: AsyncCallback<void>): v resetSize(width: number, height: number): Promise<void> -改变当前窗口大小，使用Promise方式作为异步方法。 +改变当前窗口大小，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------ | ---- | ---------------- | - | width | number | 是 | 目标窗口的宽度。 | - | height | number | 是 | 目标窗口的高度。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ---------------- | +| width | number | 是 | 目标窗口的宽度。 | +| height | number | 是 | 目标窗口的高度。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js let promise = windowClass.resetSize(500, 1000); @@ -823,20 +823,20 @@ resetSize(width: number, height: number): Promise<void> setWindowType(type: WindowType, callback: AsyncCallback<void>): void -设置窗口类型，使用callback方式作为异步方法。 +设置窗口类型，使用callback异步回调。 此接口为系统接口，三方应用不支持调用。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------- | - | type | [WindowType](#windowtype) | 是 | 窗口类型。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ---------- | +| type | [WindowType](#windowtype) | 是 | 窗口类型。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var type = window.TYPE_APP; @@ -853,25 +853,25 @@ setWindowType(type: WindowType, callback: AsyncCallback<void>): void setWindowType(type: WindowType): Promise<void> -设置窗口类型，使用Promise方式作为异步方法。 +设置窗口类型，使用Promise异步回调。 此接口为系统接口，三方应用不支持调用。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------------------------- | ---- | ---------- | - | type | [WindowType](#windowtype) | 是 | 窗口类型。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------------------------- | ---- | ---------- | +| type | [WindowType](#windowtype) | 是 | 窗口类型。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var type = window.TYPE_APP; @@ -887,17 +887,17 @@ setWindowType(type: WindowType): Promise<void> getProperties(callback: AsyncCallback<WindowProperties>): void -获取当前窗口的属性，使用callback方式作为异步方法返回WindowProperties。 +获取当前窗口的属性，使用callback异步回调，返回WindowProperties。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ---------------------------------------------------------- | ---- | ------------------ | - | callback | AsyncCallback<[WindowProperties](#windowproperties)> | 是 | 回调返回窗口属性。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------------------------------------------- | ---- | ------------------ | +| callback | AsyncCallback<[WindowProperties](#windowproperties)> | 是 | 回调返回窗口属性。 | -**示例：** +**示例：** ```js windowClass.getProperties((err, data) => { @@ -913,17 +913,17 @@ getProperties(callback: AsyncCallback<WindowProperties>): void getProperties(): Promise<WindowProperties> -获取当前窗口的属性，使用promise方式作为异步方法返回WindowProperties。 +获取当前窗口的属性，使用Promise异步回调，返回WindowProperties。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | ---------------------------------------------------- | ------------------------------------- | - | Promise<[WindowProperties](#windowproperties)> | 以Promise形式返回结果，返回窗口属性。 | +| 类型 | 说明 | +| ---------------------------------------------------- | ------------------------------------- | +| Promise<[WindowProperties](#windowproperties)> | 以Promise形式返回结果，返回窗口属性。 | -**示例：** +**示例：** ```js let promise = windowClass.getProperties(); @@ -938,18 +938,18 @@ getProperties(): Promise<WindowProperties> getAvoidArea(type: AvoidAreaType, callback: AsyncCallback<AvoidArea>): void -获取窗口内容规避的区域，如系统的系统栏区域、凹凸区域。使用callback方式作为异步方法。 +获取窗口内容规避的区域，如系统的系统栏区域、凹凸区域。使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------------------------------------------- | ---- | ------------------------------------------------------------ | - | type | [AvoidAreaType](#avoidareatype) | 是 | 表示规避区类型。type为TYPE_SYSTEM，表示系统默认区域。type为TYPE_CUTOUT，表示刘海屏区域。 | - | callback | AsyncCallback<[AvoidArea](#avoidarea)> | 是 | 回调返回窗口内容规避区域。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------------- | ---- | ------------------------------------------------------------ | +| type | [AvoidAreaType](#avoidareatype) | 是 | 表示规避区类型。type为TYPE_SYSTEM，表示系统默认区域。type为TYPE_CUTOUT，表示刘海屏区域。 | +| callback | AsyncCallback<[AvoidArea](#avoidarea)> | 是 | 回调返回窗口内容规避区域。 | -**示例：** +**示例：** ```js var type = window.AvoidAreaType.TYPE_SYSTEM; @@ -966,23 +966,23 @@ getAvoidArea(type: AvoidAreaType, callback: AsyncCallback<AvoidArea>): voi getAvoidArea(type: AvoidAreaType): Promise<AvoidArea> -获取窗口内容规避的区域，如系统的系统栏区域、凹凸区域。使用promise方式作为异步方法。 +获取窗口内容规避的区域，如系统的系统栏区域、凹凸区域。使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------------------------------- | ---- | ------------------------------------------------------------ | - | type | [AvoidAreaType](#avoidareatype) | 是 | 表示规避区类型。type为TYPE_SYSTEM，表示系统默认区域。type为TYPE_CUTOUT，表示刘海屏区域。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------------------------------- | ---- | ------------------------------------------------------------ | +| type | [AvoidAreaType](#avoidareatype) | 是 | 表示规避区类型。type为TYPE_SYSTEM，表示系统默认区域。type为TYPE_CUTOUT，表示刘海屏区域。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | -------------------------------------- | --------------------------------------------- | - | Promise<[AvoidArea](#avoidarea)> | 以Promise形式返回结果，返回窗口内容规避区域。 | +| 类型 | 说明 | +| -------------------------------------- | --------------------------------------------- | +| Promise<[AvoidArea](#avoidarea)> | 以Promise形式返回结果，返回窗口内容规避区域。 | -**示例：** +**示例：** ```js let promise = windowClass.getAvoidArea(); @@ -997,18 +997,18 @@ getAvoidArea(type: AvoidAreaType): Promise<AvoidArea> setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void -设置是否为全屏状态，使用callback方式作为异步方法。 +设置是否为全屏状态，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------------ | ------------------------- | ---- | ---------------------------------------------- | - | isFullScreen | boolean | 是 | 是否设为全屏状态，且全屏状态隐藏状态栏导航栏。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------------ | ------------------------- | ---- | ---------------------------------------------- | +| isFullScreen | boolean | 是 | 是否设为全屏状态，且全屏状态隐藏状态栏导航栏。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var isFullScreen = true; @@ -1025,23 +1025,23 @@ setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void setFullScreen(isFullScreen: boolean): Promise<void> -设置是否为全屏状态，使用Promise方式作为异步方法。 +设置是否为全屏状态，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------------ | ------- | ---- | ---------------------------------------------- | - | isFullScreen | boolean | 是 | 是否设为全屏状态，且全屏状态隐藏状态栏导航栏。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------------ | ------- | ---- | ---------------------------------------------- | +| isFullScreen | boolean | 是 | 是否设为全屏状态，且全屏状态隐藏状态栏导航栏。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var isFullScreen = true; @@ -1057,18 +1057,18 @@ setFullScreen(isFullScreen: boolean): Promise<void> setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void>): void -设置窗口的布局是否为全屏显示状态，使用callback方式作为异步方法。 +设置窗口的布局是否为全屏显示状态，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------------------ | ------------------------- | ---- | ------------------------------------------------------------ | - | isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态，且全屏状态下状态栏、导航栏仍然显示。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------------------ | ------------------------- | ---- | ------------------------------------------------------------ | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态，且全屏状态下状态栏、导航栏仍然显示。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var isLayoutFullScreen= true; @@ -1085,23 +1085,23 @@ setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void setLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void> -设置窗口的布局是否为全屏显示状态，使用Promise方式作为异步方法。 +设置窗口的布局是否为全屏显示状态，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------------------ | ------- | ---- | ------------------------------------------------------------ | - | isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态，且全屏状态下状态栏、导航栏仍然显示。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------------------ | ------- | ---- | ------------------------------------------------------------ | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态，且全屏状态下状态栏、导航栏仍然显示。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var isLayoutFullScreen = true; @@ -1117,18 +1117,18 @@ setLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void> setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallback<void>): void -设置导航栏、状态栏的可见模式，使用callback方式作为异步方法。 +设置导航栏、状态栏的可见模式，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ------------------------------------------------------------ | - | names | Array | 是 | 设置状态栏和导航栏是否显示。例如，需全部显示，该参数设置为["status", "navigation"], 不设置，则默认不显示。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ------------------------------------------------------------ | +| names | Array | 是 | 设置状态栏和导航栏是否显示。例如，需全部显示，该参数设置为["status", "navigation"], 不设置，则默认不显示。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var names = ["status", "navigation"]; @@ -1145,23 +1145,23 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallbac setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void> -设置导航栏、状态栏的可见模式，使用Promise方式作为异步方法。 +设置导航栏、状态栏的可见模式，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ----- | ---- | ------------------------------------------------------------ | - | names | Array | 是 | 设置状态栏和导航栏是否显示。例如，需全部显示，该参数设置为["status", "navigation"], 不设置，则默认不显示。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ----- | ---- | ------------------------------------------------------------ | +| names | Array | 是 | 设置状态栏和导航栏是否显示。例如，需全部显示，该参数设置为["status", "navigation"], 不设置，则默认不显示。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var names = ["status", "navigation"]; @@ -1177,18 +1177,18 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void> setSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback<void>): void -设置窗口内导航栏、状态栏的属性，使用callback方式作为异步方法。 +设置窗口内导航栏、状态栏的属性，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------------------- | ------------------------------------------- | ---- | -------------------- | - | SystemBarProperties | [SystemBarProperties](#systembarproperties) | 是 | 导航栏状态栏的属性。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------------------- | ------------------------------------------- | ---- | -------------------- | +| SystemBarProperties | [SystemBarProperties](#systembarproperties) | 是 | 导航栏状态栏的属性。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var SystemBarProperties={ @@ -1214,23 +1214,23 @@ setSystemBarProperties(systemBarProperties: SystemBarProperties, callback: Async setSystemBarProperties(systemBarProperties: SystemBarProperties): Promise<void> -设置窗口内导航栏、状态栏的属性，使用Promise方式作为异步方法。 +设置窗口内导航栏、状态栏的属性，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------------------- | ------------------------------------------- | ---- | -------------------- | - | SystemBarProperties | [SystemBarProperties](#systembarproperties) | 是 | 导航栏状态栏的属性。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------------------- | ------------------------------------------- | ---- | -------------------- | +| SystemBarProperties | [SystemBarProperties](#systembarproperties) | 是 | 导航栏状态栏的属性。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var SystemBarProperties={ @@ -1255,18 +1255,18 @@ setSystemBarProperties(systemBarProperties: SystemBarProperties): Promise<voi loadContent(path: string, callback: AsyncCallback<void>): void -当前窗口加载具体页面内容，使用callback方式作为异步方法。 +当前窗口加载具体页面内容，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | -------------------- | - | path | string | 是 | 设置加载页面的路径。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | -------------------- | +| path | string | 是 | 设置加载页面的路径。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js windowClass.loadContent("pages/page2/page2", (err, data) => { @@ -1282,23 +1282,23 @@ loadContent(path: string, callback: AsyncCallback<void>): void loadContent(path: string): Promise<void> -当前窗口加载具体页面内容，使用Promise方式作为异步方法。 +当前窗口加载具体页面内容，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------ | ---- | -------------------- | - | path | string | 是 | 设置加载页面的路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------- | +| path | string | 是 | 设置加载页面的路径。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js let promise = windowClass.loadContent("pages/page2/page2"); @@ -1313,17 +1313,17 @@ loadContent(path: string): Promise<void> isShowing(callback: AsyncCallback<boolean>): void -判断当前窗口是否已显示，使用callback方式作为异步方法。 +判断当前窗口是否已显示，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ---------------------------- | ---- | -------------------------------- | - | callback | AsyncCallback<boolean> | 是 | 回调函数返回是否显示子窗口结果。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------------- | ---- | -------------------------------- | +| callback | AsyncCallback<boolean> | 是 | 回调函数返回是否显示子窗口结果。 | -**示例：** +**示例：** ```js windowClass.isShowing((err, data) => { @@ -1339,17 +1339,17 @@ isShowing(callback: AsyncCallback<boolean>): void isShowing(): Promise<boolean> -判断当前窗口是否已显示，使用Promise方式作为异步方法。 +判断当前窗口是否已显示，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | ---------------------- | ----------------------------------------------------- | - | Promise<boolean> | 以Promise形式返回结果，返回当前窗口是否已显示的结果。 | +| 类型 | 说明 | +| ---------------------- | ----------------------------------------------------- | +| Promise<boolean> | 以Promise形式返回结果，返回当前窗口是否已显示的结果。 | -**示例：** +**示例：** ```js let promise = windowClass.isShowing(); @@ -1368,14 +1368,14 @@ on(type: 'windowSizeChange', callback: Callback<Size>): void **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ----------------------------- | ---- | -------------------------------------------------------- | - | type | string | 是 | 监听事件，固定为'windowSizeChange'，即窗口尺寸变化事件。 | - | callback | Callback<[Size](#size)> | 是 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ----------------------------- | ---- | -------------------------------------------------------- | +| type | string | 是 | 监听事件，固定为'windowSizeChange'，即窗口尺寸变化事件。 | +| callback | Callback<[Size](#size)> | 是 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```js var type = 'windowSizeChange'; @@ -1392,14 +1392,14 @@ off(type: 'windowSizeChange', callback?: Callback<Size >): void **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ----------------------------- | ---- | -------------------------------------------------------- | - | type | string | 是 | 监听事件，固定为'windowSizeChange'，即窗口尺寸变化事件。 | - | callback | Callback<[Size](#size)> | 否 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ----------------------------- | ---- | -------------------------------------------------------- | +| type | string | 是 | 监听事件，固定为'windowSizeChange'，即窗口尺寸变化事件。 | +| callback | Callback<[Size](#size)> | 否 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```js var type = 'windowSizeChange'; @@ -1414,14 +1414,14 @@ on(type: 'systemAvoidAreaChange', callback: Callback<AvoidArea>): void **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | --------------------------------------- | ---- | ------------------------------------------------------------ | - | type | string | 是 | 监听事件，固定为'systemAvoidAreaChange'，即系统窗口规避区变化事件。 | - | callback | Callback<[AvoidArea](#avoidarea)> | 是 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------- | ---- | ------------------------------------------------------------ | +| type | string | 是 | 监听事件，固定为'systemAvoidAreaChange'，即系统窗口规避区变化事件。 | +| callback | Callback<[AvoidArea](#avoidarea)> | 是 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```js var type = 'systemAvoidAreaChange'; @@ -1438,14 +1438,14 @@ off(type: 'systemAvoidAreaChange', callback?: Callback<AvoidArea>): void **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | --------------------------------------- | ---- | ------------------------------------------------------------ | - | type | string | 是 | 监听事件，固定为'systemAvoidAreaChange'，即系统窗口规避区变化事件。 | - | callback | Callback<[AvoidArea](#avoidarea)> | 否 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------- | ---- | ------------------------------------------------------------ | +| type | string | 是 | 监听事件，固定为'systemAvoidAreaChange'，即系统窗口规避区变化事件。 | +| callback | Callback<[AvoidArea](#avoidarea)> | 否 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```js var type = 'systemAvoidAreaChange'; @@ -1458,18 +1458,16 @@ on(type: 'keyboardHeightChange', callback: Callback<number>): void 开启键盘高度变化的监听。 -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 - **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------ | ---- | ------------------------------------------------------------ | - | type | string | 是 | 监听事件，固定为'keyboardHeightChange'，即键盘高度变化事件。 | - | callback | Callbacknumber> | 是 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------ | ---- | ------------------------------------------------------------ | +| type | string | 是 | 监听事件，固定为'keyboardHeightChange'，即键盘高度变化事件。 | +| callback | Callbacknumber> | 是 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```js var type = 'keyboardHeightChange'; @@ -1484,18 +1482,16 @@ off(type: 'keyboardHeightChange', callback?: Callback<number>): void 关闭键盘高度变化的监听。 -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 - **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ---------------------- | ---- | ------------------------------------------------------------ | - | type | string | 是 | 监听事件，固定为'keyboardHeightChange'，即键盘高度变化事件。 | - | callback | Callback<number> | 否 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------- | ---- | ------------------------------------------------------------ | +| type | string | 是 | 监听事件，固定为'keyboardHeightChange'，即键盘高度变化事件。 | +| callback | Callback<number> | 否 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```js var type = 'keyboardHeightChange'; @@ -1506,17 +1502,17 @@ off(type: 'keyboardHeightChange', callback?: Callback<number>): void isSupportWideGamut(callback: AsyncCallback<boolean>): void -判断当前窗口是否支持广色域模式，使用callback方式作为异步方法。 +判断当前窗口是否支持广色域模式，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ---------------------------- | ---- | -------------------------------- | - | callback | AsyncCallback<boolean> | 是 | 回调函数返回是否支持广色域模式。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------------- | ---- | -------------------------------- | +| callback | AsyncCallback<boolean> | 是 | 回调函数返回是否支持广色域模式。 | -**示例：** +**示例：** ```js windowClass.isSupportWideGamut((err, data) => { @@ -1532,17 +1528,17 @@ isSupportWideGamut(callback: AsyncCallback<boolean>): void isSupportWideGamut(): Promise<boolean> -判断当前窗口是否支持广色域模式，使用Promise方式作为异步方法。 +判断当前窗口是否支持广色域模式，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | ---------------------- | ------------------------------------------------------------ | - | Promise<boolean> | 以Promise形式返回结果，返回当前窗口是否支持广色域模式的结果。 | +| 类型 | 说明 | +| ---------------------- | ------------------------------------------------------------ | +| Promise<boolean> | 以Promise形式返回结果，返回当前窗口是否支持广色域模式的结果。 | -**示例：** +**示例：** ```js let promise = windowClass.isSupportWideGamut(); @@ -1557,18 +1553,18 @@ isSupportWideGamut(): Promise<boolean> setColorSpace(colorSpace:ColorSpace, callback: AsyncCallback<void>): void -设置当前窗口为广色域模式或默认色域模式，使用callback方式作为异步方法。 +设置当前窗口为广色域模式或默认色域模式，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---------- | ------------------------- | ---- | ------------ | - | colorSpace | [ColorSpace](#colorspace) | 是 | 设置色域模式 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------------------------- | ---- | ------------ | +| colorSpace | [ColorSpace](#colorspace) | 是 | 设置色域模式 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js windowClass.setColorSpace(window.ColorSpace.WIDE_GAMUT, (err, data) => { @@ -1584,23 +1580,23 @@ setColorSpace(colorSpace:ColorSpace, callback: AsyncCallback<void>): void setColorSpace(colorSpace:ColorSpace): Promise<void> -设置当前窗口为广色域模式或默认色域模式，使用Promise方式作为异步方法。 +设置当前窗口为广色域模式或默认色域模式，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---------- | ------------------------- | ---- | ------------ | - | colorSpace | [ColorSpace](#colorspace) | 是 | 设置色域模式 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------------------------- | ---- | ------------ | +| colorSpace | [ColorSpace](#colorspace) | 是 | 设置色域模式 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js let promise = windowClass.isSupportWideGamut(window.ColorSpace.WIDE_GAMUT); @@ -1615,17 +1611,17 @@ setColorSpace(colorSpace:ColorSpace): Promise<void> getColorSpace(callback: AsyncCallback<ColorSpace>): void -获取当前窗口色域模式，使用callback方式作为异步方法。 +获取当前窗口色域模式，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ---------------------------------------------- | ---- | -------------------------- | - | callback | AsyncCallback<[ColorSpace](#colorspace)> | 是 | 回调函数返回当前色域模式。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------------------------------- | ---- | -------------------------- | +| callback | AsyncCallback<[ColorSpace](#colorspace)> | 是 | 回调函数返回当前色域模式。 | -**示例：** +**示例：** ```js windowClass.getColorSpace((err, data) => { @@ -1641,17 +1637,17 @@ getColorSpace(callback: AsyncCallback<ColorSpace>): void getColorSpace(): Promise<ColorSpace> -获取当前窗口色域模式，使用Promise方式作为异步方法。 +获取当前窗口色域模式，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | ---------------------------------------- | ----------------------------------------- | - | Promise<[ColorSpace](#colorspace)> | 以Promise形式返回结果，返回当前色域模式。 | +| 类型 | 说明 | +| ---------------------------------------- | ----------------------------------------- | +| Promise<[ColorSpace](#colorspace)> | 以Promise形式返回结果，返回当前色域模式。 | -**示例：** +**示例：** ```js let promise = windowClass.getColorSpace(); @@ -1666,20 +1662,18 @@ getColorSpace(): Promise<ColorSpace> setBackgroundColor(color: string, callback: AsyncCallback<void>): void -设置窗口的背景色，使用callback方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置窗口的背景色，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ------------------------------------------------------------ | - | color | string | 是 | 需要设置的背景色，为16进制颜色，例如"#00FF00"或"#FF00FF00"。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ------------------------------------------------------------ | +| color | string | 是 | 需要设置的背景色，为16进制颜色，例如"#00FF00"或"#FF00FF00"。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var color = '#00ff33'; @@ -1696,25 +1690,23 @@ setBackgroundColor(color: string, callback: AsyncCallback<void>): void setBackgroundColor(color: string): Promise<void> -设置窗口的背景色，使用Promise方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置窗口的背景色，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------ | ---- | ------------------------------------------------------------ | - | color | string | 是 | 需要设置的背景色，为16进制颜色，例如"#00FF00"或"#FF00FF00"。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| color | string | 是 | 需要设置的背景色，为16进制颜色，例如"#00FF00"或"#FF00FF00"。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var color = '#00ff33'; @@ -1730,20 +1722,18 @@ setBackgroundColor(color: string): Promise<void> setBrightness(brightness: number, callback: AsyncCallback<void>): void -设置屏幕亮度值，使用callback方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置屏幕亮度值，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---------- | ------------------------- | ---- | ------------------------------------ | - | brightness | number | 是 | 屏幕亮度值，值为0-1之间。1表示最亮。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------------------------- | ---- | ------------------------------------ | +| brightness | number | 是 | 屏幕亮度值，值为0-1之间。1表示最亮。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var brightness = 1; @@ -1760,25 +1750,23 @@ setBrightness(brightness: number, callback: AsyncCallback<void>): void setBrightness(brightness: number): Promise<void> -设置屏幕亮度值，使用Promise方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置屏幕亮度值，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---------- | ------ | ---- | ------------------------------------ | - | brightness | number | 是 | 屏幕亮度值，值为0-1之间。1表示最亮。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------ | ---- | ------------------------------------ | +| brightness | number | 是 | 屏幕亮度值，值为0-1之间。1表示最亮。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var brightness = 1; @@ -1790,86 +1778,22 @@ setBrightness(brightness: number): Promise<void> }); ``` -### setDimBehind7+ - -setDimBehind(dimBehindValue: number, callback: AsyncCallback<void>): void - -窗口叠加时，设备有子窗口的情况下设置靠后的窗口的暗度值，使用callback方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 - -**系统能力：** SystemCapability.WindowManager.WindowManager.Core - -**参数：** - - | 参数名 | 类型 | 必填 | 说明 | - | -------------- | ------------------------- | ---- | -------------------------------------------------- | - | dimBehindValue | number | 是 | 表示靠后的窗口的暗度值，取值范围为0-1，1表示最暗。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | - -**示例：** - - ```js - windowClass.setDimBehind(0.5, (err, data) => { - if (err.code) { - console.error('Failed to set the dimness. Cause: ' + JSON.stringify(err)); - return; - } - console.info('Succeeded in setting the dimness. Data:' + JSON.stringify(data)); - }); - ``` - -### setDimBehind7+ - -setDimBehind(dimBehindValue: number): Promise<void> - -窗口叠加时，设备有子窗口的情况下设置靠后的窗口的暗度值，使用Promise方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 - -**系统能力：** SystemCapability.WindowManager.WindowManager.Core - -**参数：** - - | 参数名 | 类型 | 必填 | 说明 | - | -------------- | ------ | ---- | -------------------------------------------------- | - | dimBehindValue | number | 是 | 表示靠后的窗口的暗度值，取值范围为0-1，1表示最暗。 | - -**返回值：** - - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | - -**示例：** - - ```js - let promise = windowClass.setDimBehind(0.5); - promise.then((data)=> { - console.info('Succeeded in setting the dimness. Data: ' + JSON.stringify(data)) - }).catch((err)=>{ - console.error('Failed to set the dimness. Cause: ' + JSON.stringify(err)); - }); - ``` - ### setFocusable7+ setFocusable(isFocusable: boolean, callback: AsyncCallback<void>): void -设置点击时是否支持切换焦点窗口，使用callback方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置点击时是否支持切换焦点窗口，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ----------- | ------------------------- | ---- | ---------------------------- | - | isFocusable | boolean | 是 | 点击时是否支持切换焦点窗口。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ------------------------- | ---- | ---------------------------- | +| isFocusable | boolean | 是 | 点击时是否支持切换焦点窗口。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var isFocusable= true; @@ -1886,25 +1810,23 @@ setFocusable(isFocusable: boolean, callback: AsyncCallback<void>): void setFocusable(isFocusable: boolean): Promise<void> -设置点击时是否支持切换焦点窗口，使用Promise方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置点击时是否支持切换焦点窗口，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ----------- | ------- | ---- | ---------------------------- | - | isFocusable | boolean | 是 | 点击时是否支持切换焦点窗口。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ------- | ---- | ---------------------------- | +| isFocusable | boolean | 是 | 点击时是否支持切换焦点窗口。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var isFocusable= true; @@ -1920,20 +1842,18 @@ setFocusable(isFocusable: boolean): Promise<void> setKeepScreenOn(isKeepScreenOn: boolean, callback: AsyncCallback<void>): void -设置屏幕是否为常亮状态，使用callback方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置屏幕是否为常亮状态，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------------- | ------------------------- | ---- | ------------------------ | - | isKeepScreenOn | boolean | 是 | 是否设置为屏幕常亮状态。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------------- | ------------------------- | ---- | ------------------------ | +| isKeepScreenOn | boolean | 是 | 是否设置为屏幕常亮状态。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var isKeepScreenOn = true; @@ -1950,25 +1870,23 @@ setKeepScreenOn(isKeepScreenOn: boolean, callback: AsyncCallback<void>): v setKeepScreenOn(isKeepScreenOn: boolean): Promise<void> -设置屏幕是否为常亮状态，使用Promise方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置屏幕是否为常亮状态，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------------- | ------- | ---- | ------------------------ | - | isKeepScreenOn | boolean | 是 | 是否设置为屏幕常亮状态。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------------- | ------- | ---- | ------------------------ | +| isKeepScreenOn | boolean | 是 | 是否设置为屏幕常亮状态。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var isKeepScreenOn= true; @@ -1980,86 +1898,22 @@ setKeepScreenOn(isKeepScreenOn: boolean): Promise<void> }); ``` -### setOutsideTouchable7+ - -setOutsideTouchable(touchable: boolean, callback: AsyncCallback<void>): void - -设置是否允许可点击子窗口以外的区域，使用callback方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 - -**系统能力：** SystemCapability.WindowManager.WindowManager.Core - -**参数：** - - | 参数名 | 类型 | 必填 | 说明 | - | --------- | ------------------------- | ---- | ---------------- | - | touchable | boolean | 是 | 设置是否可点击。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | - -**示例：** - - ```js - windowClass.setOutsideTouchable(true, (err, data) => { - if (err.code) { - console.error('Failed to set the area to be touchable. Cause: ' + JSON.stringify(err)); - return; - } - console.info('Succeeded in setting the area to be touchable. Data: ' + JSON.stringify(data)) - }) - ``` - -### setOutsideTouchable7+ - -setOutsideTouchable(touchable: boolean): Promise<void> - -设置是否允许可点击子窗口以外的区域，使用Promise方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 - -**系统能力：** SystemCapability.WindowManager.WindowManager.Core - -**参数：** - - | 参数名 | 类型 | 必填 | 说明 | - | --------- | ------- | ---- | ---------------- | - | touchable | boolean | 是 | 设置是否可点击。 | - -**返回值：** - - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | - -**示例：** - - ```js - let promise = windowClass.setOutsideTouchable(true); - promise.then((data)=> { - console.info('Succeeded in setting the area to be touchable. Data: ' + JSON.stringify(data)) - }).catch((err)=>{ - console.error('Failed to set the area to be touchable. Cause: ' + JSON.stringify(err)); - }); - ``` - ### setPrivacyMode7+ setPrivacyMode(isPrivacyMode: boolean, callback: AsyncCallback<void>): void -设置窗口是否为隐私模式，使用callback方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置窗口是否为隐私模式，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------------- | ------------------------- | ---- | -------------------- | - | isPrivacyMode | boolean | 是 | 窗口是否为隐私模式。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------------- | ------------------------- | ---- | -------------------- | +| isPrivacyMode | boolean | 是 | 窗口是否为隐私模式。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var isPrivacyMode = true; @@ -2077,25 +1931,23 @@ setPrivacyMode(isPrivacyMode: boolean, callback: AsyncCallback<void>): voi setPrivacyMode(isPrivacyMode: boolean): Promise<void> -设置窗口是否为隐私模式，使用Promise方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置窗口是否为隐私模式，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------------- | ------- | ---- | -------------------- | - | isPrivacyMode | boolean | 是 | 窗口是否为隐私模式。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------------- | ------- | ---- | -------------------- | +| isPrivacyMode | boolean | 是 | 窗口是否为隐私模式。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var isPrivacyMode = true; @@ -2111,20 +1963,18 @@ setPrivacyMode(isPrivacyMode: boolean): Promise<void> setTouchable(isTouchable: boolean, callback: AsyncCallback<void>): void -设置窗口是否为可触状态，使用callback方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置窗口是否为可触状态，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ----------- | ------------------------- | ---- | -------------------- | - | isTouchable | boolean | 是 | 窗口是否为可触状态。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ------------------------- | ---- | -------------------- | +| isTouchable | boolean | 是 | 窗口是否为可触状态。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```js var isTouchable = true; @@ -2142,25 +1992,23 @@ setTouchable(isTouchable: boolean, callback: AsyncCallback<void>): void setTouchable(isTouchable: boolean): Promise<void> -设置窗口是否为可触状态，使用Promise方式作为异步方法。 - -本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 +设置窗口是否为可触状态，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ----------- | ------- | ---- | -------------------- | - | isTouchable | boolean | 是 | 窗口是否为可触状态。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ------- | ---- | -------------------- | +| isTouchable | boolean | 是 | 窗口是否为可触状态。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | ------------------- | ----------------------------------------------- | - | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | +| 类型 | 说明 | +| ------------------- | ----------------------------------------------- | +| Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 | -**示例：** +**示例：** ```js var isTouchable = true; @@ -2193,17 +2041,17 @@ WindowStage生命周期。 getMainWindow(): Promise<Window> -获取该WindowStage实例下的主窗口，使用Promise方式作为异步方法。 +获取该WindowStage实例下的主窗口，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | -------------------------------- | ---------------------------------------------------------- | - | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前WindowStage下的主窗口对象。 | +| 类型 | 说明 | +| -------------------------------- | ---------------------------------------------------------- | +| Promise<[Window](#window)> | 以Promise形式返回结果，返回当前WindowStage下的主窗口对象。 | -**示例：** +**示例：** ```ts class myAbility extends Ability { @@ -2225,17 +2073,17 @@ getMainWindow(): Promise<Window> getMainWindow(callback: AsyncCallback<Window>): void -获取该WindowStage实例下的主窗口，使用callback方式作为异步方法。 +获取该WindowStage实例下的主窗口，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------------------------------------- | ---- | --------------------------------------- | - | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前WindowStage下的主窗口对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------- | ---- | --------------------------------------- | +| callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前WindowStage下的主窗口对象。 | -**示例：** +**示例：** ```ts class myAbility extends Ability { @@ -2258,23 +2106,23 @@ getMainWindow(callback: AsyncCallback<Window>): void createSubWindow(name: string): Promise<Window> -创建该WindowStage实例下的子窗口，使用Promise方式作为异步方法。 +创建该WindowStage实例下的子窗口，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------ | ------ | ---- | -------------- | - | name | String | 是 | 子窗口的名字。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------- | +| name | String | 是 | 子窗口的名字。 | -**返回值：** +**返回值：** - | 类型 | 说明 | - | -------------------------------- | ------------------------------------------------- | - | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前创建的子窗口对象。 | +| 类型 | 说明 | +| -------------------------------- | ------------------------------------------------- | +| Promise<[Window](#window)> | 以Promise形式返回结果，返回当前创建的子窗口对象。 | -**示例：** +**示例：** ```ts class myAbility extends Ability { @@ -2296,18 +2144,18 @@ createSubWindow(name: string): Promise<Window> createSubWindow(name: string, callback: AsyncCallback<Window>): void -创建该WindowStage实例下的子窗口，使用callback方式作为异步方法。 +创建该WindowStage实例下的子窗口，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------------------------------------- | ---- | ------------------------------ | - | name | String | 是 | 子窗口的名字。 | - | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前创建的子窗口对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------------- | ---- | ------------------------------ | +| name | String | 是 | 子窗口的名字。 | +| callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前创建的子窗口对象。 | -**示例：** +**示例：** ```ts class myAbility extends Ability { @@ -2331,17 +2179,17 @@ createSubWindow(name: string, callback: AsyncCallback<Window>): void getSubWindow(): Promise<Array<Window>> -获取该WindowStage实例下的所有子窗口，使用Promise方式作为异步方法。 +获取该WindowStage实例下的所有子窗口，使用Promise异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**返回值：** +**返回值：** - | 类型 | 说明 | - | --------------------------------------------- | ------------------------------------------------------------ | - | Promise<Array<[Window](#window)>> | 以Promise形式返回结果，返回当前WindowStage下的所有子窗口对象。 | +| 类型 | 说明 | +| --------------------------------------------- | ------------------------------------------------------------ | +| Promise<Array<[Window](#window)>> | 以Promise形式返回结果，返回当前WindowStage下的所有子窗口对象。 | -**示例：** +**示例：** ```ts class myAbility extends Ability { @@ -2363,17 +2211,17 @@ getSubWindow(): Promise<Array<Window>> getSubWindow(callback: AsyncCallback<Array<Window>>): void -获取该WindowStage实例下的所有子窗口，使用callback方式作为异步方法。 +获取该WindowStage实例下的所有子窗口，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | --------------------------------------------------- | ---- | ------------------------------------------- | - | callback | AsyncCallback<Array<[Window](#window)>> | 是 | 回调返回当前WindowStage下的所有子窗口对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------------------- | ---- | ------------------------------------------- | +| callback | AsyncCallback<Array<[Window](#window)>> | 是 | 回调返回当前WindowStage下的所有子窗口对象。 | -**示例：** +**示例：** ```ts class myAbility extends Ability { @@ -2396,18 +2244,18 @@ getSubWindow(callback: AsyncCallback<Array<Window>>): void loadContent(path: string, callback: AsyncCallback<void>): void -为当前WindowStage的主窗口加载具体页面内容，使用callback方式作为异步方法。 +为当前WindowStage的主窗口加载具体页面内容，使用callback异步回调。 **系统能力：** SystemCapability.WindowManager.WindowManager.Coretype为'windowSizeChange' -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | -------------------- | - | path | string | 是 | 设置加载页面的路径。 | - | callback | AsyncCallback<void> | 是 | 回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | -------------------- | +| path | string | 是 | 设置加载页面的路径。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | -**示例：** +**示例：** ```ts class myAbility extends Ability { @@ -2432,14 +2280,14 @@ on(eventType: 'windowStageEvent', callback: Callback<WindowStageEventType> **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | - | type | string | 是 | 监听事件，固定为'windowStageEvent'，即WindowStage生命周期变化事件。 | - | callback | Callback<[WindowStageEventType](#windowstageeventtype9)> | 是 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| type | string | 是 | 监听事件，固定为'windowStageEvent'，即WindowStage生命周期变化事件。 | +| callback | Callback<[WindowStageEventType](#windowstageeventtype9)> | 是 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```ts class myAbility extends Ability { @@ -2461,14 +2309,14 @@ off(eventType: 'windowStageEvent', callback?: Callback<WindowStageEventType&g **系统能力：** SystemCapability.WindowManager.WindowManager.Core -**参数：** +**参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | - | type | string | 是 | 监听事件，固定为'windowStageEvent'，即WindowStage生命周期变化事件。 | - | callback | Callback<[WindowStageEventType](#windowstageeventtype9)> | 否 | 回调返回监听到的信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| type | string | 是 | 监听事件，固定为'windowStageEvent'，即WindowStage生命周期变化事件。 | +| callback | Callback<[WindowStageEventType](#windowstageeventtype9)> | 否 | 回调返回监听到的信息。 | -**示例：** +**示例：** ```ts class myAbility extends Ability { -- GitLab