Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
未验证 提交 eeccf80a 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!17911 翻译完成：17140+17469 修改translate接口描述 

Merge pull request !17911 from wusongqing/TR17140
上级 14f67a02 526f04e2
显示空白变更内容
内联 并排
Showing with 434 addition and 434 deletion
en/application-dev/reference/apis/js-apis-window.md
浏览文件 @ eeccf80a
...@@ -54,7 +54,7 @@ Defines the parameters for creating a subwindow or system window. ...@@ -54,7 +54,7 @@ Defines the parameters for creating a subwindow or system window.
| ---------- | -------------------------- | -- | ----------------------------------- | | ---------- | -------------------------- | -- | ----------------------------------- |
| name | string | Yes| Name of the window. | | name | string | Yes| Name of the window. |
| windowType | [WindowType](#windowtype7) | Yes| Type of the window. | | windowType | [WindowType](#windowtype7) | Yes| Type of the window. |
| ctx | [BaseContext](js-apis-inner-application-baseContext.md) | No| Current application context. If this parameter is not set, no context is used.<br>You do not need to set this parameter to create a subwindow in the FA model or a system window in the stage model. | | ctx | [BaseContext](js-apis-inner-application-baseContext.md) | No| Current application context. If this parameter is not set, no context is used.<br>You do not need to set this parameter to create a subwindow in the FA model or a system window in the stage model.|
| displayId | number | No| ID of the current physical screen. If this parameter is not set, the default value **-1** is used.| | displayId | number | No| ID of the current physical screen. If this parameter is not set, the default value **-1** is used.|
| parentId | number | No| ID of the parent window. If this parameter is not set, the default value **-1** is used. | | parentId | number | No| ID of the parent window. If this parameter is not set, the default value **-1** is used. |
...@@ -66,7 +66,7 @@ Enumerates the types of the area where the window cannot be displayed. ...@@ -66,7 +66,7 @@ Enumerates the types of the area where the window cannot be displayed.
| Name | Value | Description | | Name | Value | Description |
| -------------------------------- | ---- | ------------------------------------------------------------ | | -------------------------------- | ---- | ------------------------------------------------------------ |
| TYPE_SYSTEM | 0 | Default area of the system. Generally, the status bar, navigation bar, and Dock bar are included. The default area may vary according to the device in use.| | TYPE_SYSTEM | 0 | Default area of the system. Generally, the status bar and navigation bar are included. The default area may vary according to the device in use.|
| TYPE_CUTOUT | 1 | Notch. | | TYPE_CUTOUT | 1 | Notch. |
| TYPE_SYSTEM_GESTURE<sup>9+</sup> | 2 | Gesture area. | | TYPE_SYSTEM_GESTURE<sup>9+</sup> | 2 | Gesture area. |
| TYPE_KEYBOARD<sup>9+</sup> | 3 | Soft keyboard area. | | TYPE_KEYBOARD<sup>9+</sup> | 3 | Soft keyboard area. |
...@@ -108,10 +108,10 @@ Describes the properties of the status bar and navigation bar. ...@@ -108,10 +108,10 @@ Describes the properties of the status bar and navigation bar.
| Name | Type| Mandatory| Description | | Name | Type| Mandatory| Description |
| -------------------------------------- | -------- | ---- | ------------------------------------------------------------ | | -------------------------------------- | -------- | ---- | ------------------------------------------------------------ |
| statusBarColor | string | No | Background color of the status bar. The value is a hexadecimal RGB or ARGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**. The default value is **#0x66000000**. | | statusBarColor | string | No | Background color of the status bar. The value is a hexadecimal RGB or aRGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**. The default value is **#0x66000000**.|
| isStatusBarLightIcon<sup>7+</sup> | boolean | No | Whether any icon on the status bar is highlighted. The value **true** means that the icon is highlighted, and **false** means the opposite. The default value is **false**.| | isStatusBarLightIcon<sup>7+</sup> | boolean | No | Whether any icon on the status bar is highlighted. The value **true** means that the icon is highlighted, and **false** means the opposite. The default value is **false**.|
| statusBarContentColor<sup>8+</sup> | string | No | Color of the text on the status bar. After this property is set, the setting of **isStatusBarLightIcon** is invalid. The default value is **0xE5FFFFFF**.| | statusBarContentColor<sup>8+</sup> | string | No | Color of the text on the status bar. After this property is set, the setting of **isStatusBarLightIcon** is invalid. The default value is **0xE5FFFFFF**.|
| navigationBarColor | string | No | Background color of the navigation bar. The value is a hexadecimal RGB or ARGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**. The default value is **#0x66000000**. | | navigationBarColor | string | No | Background color of the navigation bar. The value is a hexadecimal RGB or aRGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**. The default value is **#0x66000000**.|
| isNavigationBarLightIcon<sup>7+</sup> | boolean | No | Whether any icon on the navigation bar is highlighted. The value **true** means that the icon is highlighted, and **false** means the opposite. The default value is **false**.| | isNavigationBarLightIcon<sup>7+</sup> | boolean | No | Whether any icon on the navigation bar is highlighted. The value **true** means that the icon is highlighted, and **false** means the opposite. The default value is **false**.|
| navigationBarContentColor<sup>8+</sup> | string | No | Color of the text on the navigation bar. After this property is set, the setting of **isNavigationBarLightIcon** is invalid. The default value is **0xE5FFFFFF**.| | navigationBarContentColor<sup>8+</sup> | string | No | Color of the text on the navigation bar. After this property is set, the setting of **isNavigationBarLightIcon** is invalid. The default value is **0xE5FFFFFF**.|
...@@ -164,7 +164,7 @@ Describes the callback for a single system bar. ...@@ -164,7 +164,7 @@ Describes the callback for a single system bar.
| type | [WindowType](#windowtype7) | Yes | No | Type of the system bar whose properties are changed. Only the status bar and navigation bar are supported.| | type | [WindowType](#windowtype7) | Yes | No | Type of the system bar whose properties are changed. Only the status bar and navigation bar are supported.|
| isEnable | boolean | Yes | No | Whether the system bar is displayed. The value **true** means that the system bar is displayed, and **false** means the opposite.| | isEnable | boolean | Yes | No | Whether the system bar is displayed. The value **true** means that the system bar is displayed, and **false** means the opposite.|
| region | [Rect](#rect7) | Yes | No | Current position and size of the system bar. | | region | [Rect](#rect7) | Yes | No | Current position and size of the system bar. |
| backgroundColor | string | Yes | No | Background color of the system bar. The value is a hexadecimal RGB or ARGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**. | | backgroundColor | string | Yes | No | Background color of the system bar. The value is a hexadecimal RGB or aRGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**.|
| contentColor | string | Yes | No | Color of the text on the system bar. | | contentColor | string | Yes | No | Color of the text on the system bar. |
## SystemBarTintState<sup>8+</sup> ## SystemBarTintState<sup>8+</sup>
...@@ -2346,7 +2346,7 @@ Loads content from a page associated with a local storage to this window. This A ...@@ -2346,7 +2346,7 @@ Loads content from a page associated with a local storage to this window. This A
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------- | ---- | ------------------------------------------------------------ | | -------- | ----------------------------------------------- | ---- | ------------------------------------------------------------ |
| path | string | Yes | Path of the page from which the content will be loaded. | | path | string | Yes | Path of the page from which the content will be loaded. |
| storage | [LocalStorage](../../quick-start/arkts-state-mgmt-application-level.md#localstorage) | Yes | A storage unit, which provides storage for variable state properties and non-variable state properties of an application.| | storage | [LocalStorage](../../quick-start/arkts-localstorage.md) | Yes | A storage unit, which provides storage for variable state properties and non-variable state properties of an application.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Error codes** **Error codes**
...@@ -2392,7 +2392,7 @@ Loads content from a page associated with a local storage to this window. This A ...@@ -2392,7 +2392,7 @@ Loads content from a page associated with a local storage to this window. This A
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| ------- | ----------------------------------------------- | ---- | ------------------------------------------------------------ | | ------- | ----------------------------------------------- | ---- | ------------------------------------------------------------ |
| path | string | Yes | Path of the page from which the content will be loaded. | | path | string | Yes | Path of the page from which the content will be loaded. |
| storage | [LocalStorage](../../quick-start/arkts-state-mgmt-application-level.md#localstorage) | Yes | A storage unit, which provides storage for variable state properties and non-variable state properties of an application.| | storage | [LocalStorage](../../quick-start/arkts-localstorage.md) | Yes | A storage unit, which provides storage for variable state properties and non-variable state properties of an application.|
**Return value** **Return value**
...@@ -3064,7 +3064,7 @@ Sets the background color for this window. In the stage model, this API must be ...@@ -3064,7 +3064,7 @@ Sets the background color for this window. In the stage model, this API must be
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| ----- | ------ | -- | ----------------------------------------------------------------------- | | ----- | ------ | -- | ----------------------------------------------------------------------- |
| color | string | Yes| Background color to set. The value is a hexadecimal RGB or ARGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**. | | color | string | Yes| Background color to set. The value is a hexadecimal RGB or ARGB color code and is case insensitive, for example, **#00FF00** or **#FF00FF00**.|
**Error codes** **Error codes**
...@@ -3685,15 +3685,15 @@ Captures this window. This API uses an asynchronous callback to return the resul ...@@ -3685,15 +3685,15 @@ Captures this window. This API uses an asynchronous callback to return the resul
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------------------ | --------- | ----------------------------------- | | ----------- | ------------------------- | ---- | -------------------- |
| callback | AsyncCallback&lt;[image.PixelMap](js-apis-image.md#pixelmap7)&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;[image.PixelMap](js-apis-image.md#pixelmap7)&gt; | Yes | Callback used to return the result. |
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
...@@ -3721,14 +3721,14 @@ Captures this window. This API uses a promise to return the result. ...@@ -3721,14 +3721,14 @@ Captures this window. This API uses a promise to return the result.
**Return value** **Return value**
| Type | Description | | Type | Description |
| ----------------------------------------------------------- | --------------------------------------------- | | ------------------- | ------------------------- |
| Promise&lt;[image.PixelMap](js-apis-image.md#pixelmap7)&gt; | Promise used to return the window screenshot. | | Promise&lt;[image.PixelMap](js-apis-image.md#pixelmap7)&gt; | Promise used to return the window screenshot.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
...@@ -3748,7 +3748,7 @@ promise.then((pixelMap)=> { ...@@ -3748,7 +3748,7 @@ promise.then((pixelMap)=> {
opacity(opacity: number): void opacity(opacity: number): void
Sets the opacity for this window. Sets the opacity for this window. This API can be used only when you [customize an animation to be played during the display or hiding of a system window](../../windowmanager/system-window-stage.md#customizing-an-animation-to-be-played-during-the-display-or-hiding-of-a-system-window).
**System API**: This is a system API. **System API**: This is a system API.
...@@ -3756,15 +3756,15 @@ Sets the opacity for this window. ...@@ -3756,15 +3756,15 @@ Sets the opacity for this window.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------- | ------ | --------- | ------------------------------------------------- | | ------- | ------ | ---- | ----------------------------------------------------------- |
| opacity | number | Yes | Opacity to set. The value ranges from 0.0 to 1.0. | | opacity | number | Yes | Opacity to set. The value ranges from 0.0 to 1.0. The value **0.0** means completely transparent, and **1.0** means completely opaque.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -3783,7 +3783,7 @@ try { ...@@ -3783,7 +3783,7 @@ try {
scale(scaleOptions: ScaleOptions): void scale(scaleOptions: ScaleOptions): void
Sets the scale parameters for this window. Sets the scale parameters for this window. This API can be used only when you [customize an animation to be played during the display or hiding of a system window](../../windowmanager/system-window-stage.md#customizing-an-animation-to-be-played-during-the-display-or-hiding-of-a-system-window).
**System API**: This is a system API. **System API**: This is a system API.
...@@ -3791,15 +3791,15 @@ Sets the scale parameters for this window. ...@@ -3791,15 +3791,15 @@ Sets the scale parameters for this window.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------ | ------------------------------ | --------- | ------------------------ | | ------------ | ------------------------------ | ---- | ---------- |
| scaleOptions | [ScaleOptions](#scaleoptions9) | Yes | Scale parameters to set. | | scaleOptions | [ScaleOptions](#scaleoptions9) | Yes | Scale parameters to set.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -3824,7 +3824,7 @@ try { ...@@ -3824,7 +3824,7 @@ try {
rotate(rotateOptions: RotateOptions): void rotate(rotateOptions: RotateOptions): void
Sets the rotation parameters for this window. Sets the rotation parameters for this window. This API can be used only when you [customize an animation to be played during the display or hiding of a system window](../../windowmanager/system-window-stage.md#customizing-an-animation-to-be-played-during-the-display-or-hiding-of-a-system-window).
**System API**: This is a system API. **System API**: This is a system API.
...@@ -3832,15 +3832,15 @@ Sets the rotation parameters for this window. ...@@ -3832,15 +3832,15 @@ Sets the rotation parameters for this window.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------- | -------------------------------- | --------- | --------------------------- | | ------------- | -------------------------------- | ---- | ---------- |
| rotateOptions | [RotateOptions](#rotateoptions9) | Yes | Rotation parameters to set. | | rotateOptions | [RotateOptions](#rotateoptions9) | Yes | Rotation parameters to set.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -3866,7 +3866,7 @@ try { ...@@ -3866,7 +3866,7 @@ try {
translate(translateOptions: TranslateOptions): void translate(translateOptions: TranslateOptions): void
Sets the translation parameters for this window. Sets the translation parameters for this window. This API can be used only when you [customize an animation to be played during the display or hiding of a system window](../../windowmanager/system-window-stage.md#customizing-an-animation-to-be-played-during-the-display-or-hiding-of-a-system-window).
**System API**: This is a system API. **System API**: This is a system API.
...@@ -3874,15 +3874,15 @@ Sets the translation parameters for this window. ...@@ -3874,15 +3874,15 @@ Sets the translation parameters for this window.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ---------------- | -------------------------------------- | --------- | ------------------------------ | | ---------------- | -------------------------------------- | ---- | -------------------- |
| translateOptions | [TranslateOptions](#translateoptions9) | Yes | Translation parameters to set. | | translateOptions | [TranslateOptions](#translateoptions9) | Yes | Translation parameters. The unit is pixels.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -3915,14 +3915,14 @@ Obtains the transition animation controller. ...@@ -3915,14 +3915,14 @@ Obtains the transition animation controller.
**Return value** **Return value**
| Type | Description | | Type | Description |
| ---------------------------------------------- | -------------------------------- | | ---------------------------------------------- | ---------------- |
| [TransitionController](#transitioncontroller9) | Transition animation controller. | | [TransitionController](#transitioncontroller9) | Transition animation controller.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -3976,15 +3976,15 @@ Blurs this window. ...@@ -3976,15 +3976,15 @@ Blurs this window.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ------ | ------ | --------- | ------------------------------------------------------------ | | ------ | ------ | ---- | ------------------------------------------------------------ |
| radius | number | Yes | Radius of the blur. The value is greater than or equal to 0. The value **0** means that the blur is disabled for the window. | | radius | number | Yes | Radius of the blur. The value is greater than or equal to 0. The value **0** means that the blur is disabled for the window.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -4011,15 +4011,15 @@ Blurs the background of this window. ...@@ -4011,15 +4011,15 @@ Blurs the background of this window.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ------ | ------ | --------- | ------------------------------------------------------------ | | ------ | ------ | ---- | ------------------------------------------------------------ |
| radius | number | Yes | Radius of the blur. The value is greater than or equal to 0. The value **0** means that the blur is disabled for the background of the window. | | radius | number | Yes | Radius of the blur. The value is greater than or equal to 0. The value **0** means that the blur is disabled for the background of the window.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -4046,15 +4046,15 @@ Sets the blur style for the background of this window. ...@@ -4046,15 +4046,15 @@ Sets the blur style for the background of this window.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| --------- | ------------------------ | --------- | --------------------------------------------------- | | --------- | --------- | ---- | ---------------------- |
| blurStyle | [BlurStyle](#blurstyle9) | Yes | Blur style to set for the background of the window. | | blurStyle | [BlurStyle](#blurstyle9) | Yes | Blur style to set for the background of the window.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -4081,10 +4081,10 @@ Sets the shadow for the window borders. ...@@ -4081,10 +4081,10 @@ Sets the shadow for the window borders.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------- | ------ | --------- | ------------------------------------------------------------ | | ------- | ------ | ---- | ------------------------------------------------------------ |
| radius | number | Yes | Radius of the shadow. The value is greater than or equal to 0. The value **0** means that the shadow is disabled for the window borders. | | radius | number | Yes | Radius of the shadow. The value is greater than or equal to 0. The value **0** means that the shadow is disabled for the window borders.|
| color | string | No | Color of the shadow. The value is a hexadecimal RGB or ARGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**. | | color | string | No | Color of the shadow. The value is a hexadecimal RGB or ARGB color code and is case insensitive, for example, **#00FF00** or **#FF00FF00**.|
| offsetX | number | No | Offset of the shadow along the x-axis, in pixels. | | offsetX | number | No | Offset of the shadow along the x-axis, in pixels. |
| offsetY | number | No | Offset of the shadow along the y-axis, in pixels. | | offsetY | number | No | Offset of the shadow along the y-axis, in pixels. |
...@@ -4092,7 +4092,7 @@ Sets the shadow for the window borders. ...@@ -4092,7 +4092,7 @@ Sets the shadow for the window borders.
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -4119,15 +4119,15 @@ Sets the radius of the rounded corners for this window. ...@@ -4119,15 +4119,15 @@ Sets the radius of the rounded corners for this window.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------ | ------ | --------- | ------------------------------------------------------------ | | ----------- | ------- | ---- | -------------------- |
| radius | number | Yes | Radius of the rounded corners. The value is greater than or equal to 0. The value **0** means that the window does not use rounded corners. | | radius | number | Yes | Radius of the rounded corners. The value is greater than or equal to 0. The value **0** means that the window does not use rounded corners.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300004 | Unauthorized operation. | | 1300004 | Unauthorized operation. |
...@@ -4156,9 +4156,9 @@ Shows this window. This API uses an asynchronous callback to return the result. ...@@ -4156,9 +4156,9 @@ Shows this window. This API uses an asynchronous callback to return the result.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------- | --------- | ----------------------------------- | | -------- | ------------------------- | ---- | ---------- |
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result.|
**Example** **Example**
...@@ -4187,8 +4187,8 @@ Shows this window. This API uses a promise to return the result. ...@@ -4187,8 +4187,8 @@ Shows this window. This API uses a promise to return the result.
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4215,9 +4215,9 @@ Destroys this window. This API uses an asynchronous callback to return the resul ...@@ -4215,9 +4215,9 @@ Destroys this window. This API uses an asynchronous callback to return the resul
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------- | --------- | ----------------------------------- | | -------- | ------------------------- | ---- | ---------- |
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result.|
**Example** **Example**
...@@ -4246,8 +4246,8 @@ Destroys this window. This API uses a promise to return the result. ...@@ -4246,8 +4246,8 @@ Destroys this window. This API uses a promise to return the result.
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4276,10 +4276,10 @@ This operation is not supported in a window in full-screen mode. ...@@ -4276,10 +4276,10 @@ This operation is not supported in a window in full-screen mode.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------- | --------- | ------------------------------------------------------------ | | -------- | ------------------------- | ---- | ------------------------------------------------- |
| x | number | Yes | Distance that the window moves along the x-axis, in px. A positive value indicates that the window moves to the right. | | x | number | Yes | Distance that the window moves along the x-axis, in px. A positive value indicates that the window moves to the right.|
| y | number | Yes | Distance that the window moves along the y-axis, in px. A positive value indicates that the window moves downwards. | | y | number | Yes | Distance that the window moves along the y-axis, in px. A positive value indicates that the window moves downwards.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -4310,16 +4310,16 @@ This operation is not supported in a window in full-screen mode. ...@@ -4310,16 +4310,16 @@ This operation is not supported in a window in full-screen mode.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ---- | ------ | --------- | ------------------------------------------------------------ | | ------ | ------ | ---- | ------------------------------------------------- |
| x | number | Yes | Distance that the window moves along the x-axis, in px. A positive value indicates that the window moves to the right. | | x | number | Yes | Distance that the window moves along the x-axis, in px. A positive value indicates that the window moves to the right.|
| y | number | Yes | Distance that the window moves along the y-axis, in px. A positive value indicates that the window moves downwards. | | y | number | Yes | Distance that the window moves along the y-axis, in px. A positive value indicates that the window moves downwards.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4354,10 +4354,10 @@ This operation is not supported in a window in full-screen mode. ...@@ -4354,10 +4354,10 @@ This operation is not supported in a window in full-screen mode.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------- | --------- | ----------------------------------- | | -------- | ------------------------- | ---- | -------------------------- |
| width | number | Yes | New width of the window, in px. | | width | number | Yes | New width of the window, in px.|
| height | number | Yes | New height of the window, in px. | | height | number | Yes | New height of the window, in px.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -4394,16 +4394,16 @@ This operation is not supported in a window in full-screen mode. ...@@ -4394,16 +4394,16 @@ This operation is not supported in a window in full-screen mode.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ------ | ------ | --------- | -------------------------------- | | ------ | ------ | ---- | -------------------------- |
| width | number | Yes | New width of the window, in px. | | width | number | Yes | New width of the window, in px.|
| height | number | Yes | New height of the window, in px. | | height | number | Yes | New height of the window, in px.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4432,10 +4432,10 @@ Sets the type of this window. This API uses an asynchronous callback to return t ...@@ -4432,10 +4432,10 @@ Sets the type of this window. This API uses an asynchronous callback to return t
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | -------------------------- | --------- | ----------------------------------- | | -------- | ------------------------- | ---- | ---------- |
| type | [WindowType](#windowtype7) | Yes | Window type. | | type | [WindowType](#windowtype7) | Yes | Window type.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result.|
**Example** **Example**
...@@ -4466,15 +4466,15 @@ Sets the type of this window. This API uses a promise to return the result. ...@@ -4466,15 +4466,15 @@ Sets the type of this window. This API uses a promise to return the result.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ---- | -------------------------- | --------- | ------------ | | ------ | ------------------------- | ---- | ---------- |
| type | [WindowType](#windowtype7) | Yes | Window type. | | type | [WindowType](#windowtype7) | Yes | Window type.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4502,9 +4502,9 @@ Obtains the properties of this window. This API uses an asynchronous callback to ...@@ -4502,9 +4502,9 @@ Obtains the properties of this window. This API uses an asynchronous callback to
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ---------------------------------------------------------- | --------- | ---------------------------------------------- | | -------- | ---------------------------------------------------------- | ---- | ---------------------------- |
| callback | AsyncCallback&lt;[WindowProperties](#windowproperties)&gt; | Yes | Callback used to return the window properties. | | callback | AsyncCallback&lt;[WindowProperties](#windowproperties)&gt; | Yes | Callback used to return the window properties.|
**Example** **Example**
...@@ -4533,8 +4533,8 @@ Obtains the properties of this window. This API uses a promise to return the res ...@@ -4533,8 +4533,8 @@ Obtains the properties of this window. This API uses a promise to return the res
**Return value** **Return value**
| Type | Description | | Type | Description |
| ---------------------------------------------------- | --------------------------------------------- | | ---------------------------------------------------- | ------------------------------- |
| Promise&lt;[WindowProperties](#windowproperties)&gt; | Promise used to return the window properties. | | Promise&lt;[WindowProperties](#windowproperties)&gt; | Promise used to return the window properties.|
**Example** **Example**
...@@ -4561,9 +4561,9 @@ Obtains the area where this window cannot be displayed, for example, the system ...@@ -4561,9 +4561,9 @@ Obtains the area where this window cannot be displayed, for example, the system
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | --------------------------------------------- | --------- | --------------------------------- | | -------- |-----------------------------------------------| ---- | ------------------------------------------------------------ |
| type | [AvoidAreaType](#avoidareatype7) | Yes | Type of the area. | | type | [AvoidAreaType](#avoidareatype7) | Yes | Type of the area.|
| callback | AsyncCallback&lt;[AvoidArea](#avoidarea7)&gt; | Yes | Callback used to return the area. | | callback | AsyncCallback&lt;[AvoidArea](#avoidarea7)&gt; | Yes | Callback used to return the area. |
**Example** **Example**
...@@ -4593,15 +4593,15 @@ Obtains the area where this window cannot be displayed, for example, the system ...@@ -4593,15 +4593,15 @@ Obtains the area where this window cannot be displayed, for example, the system
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ---- | -------------------------------- | --------- | ----------------- | | ------ |----------------------------------| ---- | ------------------------------------------------------------ |
| type | [AvoidAreaType](#avoidareatype7) | Yes | Type of the area. | | type | [AvoidAreaType](#avoidareatype7) | Yes | Type of the area.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| --------------------------------------- | -------------------------------- | |-----------------------------------------| ----------------------------------- |
| Promise&lt;[AvoidArea](#avoidarea7)&gt; | Promise used to return the area. | | Promise&lt;[AvoidArea](#avoidarea7)&gt; | Promise used to return the area.|
**Example** **Example**
...@@ -4629,9 +4629,9 @@ Sets whether to enable the full-screen mode for this window. This API uses an as ...@@ -4629,9 +4629,9 @@ Sets whether to enable the full-screen mode for this window. This API uses an as
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------ | ------------------------- | --------- | ------------------------------------------------------------ | | ------------ | ------------------------- | ---- | ---------------------------------------------- |
| isFullScreen | boolean | Yes | Whether to enable the full-screen mode, in which the status bar and navigation bar are hidden. The value **true** means to enable the full-screen mode, and **false** means the opposite. | | isFullScreen | boolean | Yes | Whether to enable the full-screen mode, in which the status bar and navigation bar are hidden. The value **true** means to enable the full-screen mode, and **false** means the opposite.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -4661,15 +4661,15 @@ Sets whether to enable the full-screen mode for this window. This API uses a pro ...@@ -4661,15 +4661,15 @@ Sets whether to enable the full-screen mode for this window. This API uses a pro
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------ | ------- | --------- | ------------------------------------------------------------ | | ------------ | ------- | ---- | ---------------------------------------------- |
| isFullScreen | boolean | Yes | Whether to enable the full-screen mode, in which the status bar and navigation bar are hidden. The value **true** means to enable the full-screen mode, and **false** means the opposite. | | isFullScreen | boolean | Yes | Whether to enable the full-screen mode, in which the status bar and navigation bar are hidden. The value **true** means to enable the full-screen mode, and **false** means the opposite.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4697,9 +4697,9 @@ Sets whether to enable the full-screen mode for the window layout. This API uses ...@@ -4697,9 +4697,9 @@ Sets whether to enable the full-screen mode for the window layout. This API uses
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------------ | ------------------------- | --------- | ------------------------------------------------------------ | | ------------------ | ------------------------- | ---- | ------------------------------------------------------------ |
| isLayoutFullScreen | boolean | Yes | Whether to enable the full-screen mode for the window layout, in which the status bar and navigation bar are displayed. The value **true** means to enable the full-screen mode for the window layout, and **false** means the opposite. | | isLayoutFullScreen | boolean | Yes | Whether to enable the full-screen mode for the window layout, in which the status bar and navigation bar are displayed. The value **true** means to enable the full-screen mode for the window layout, and **false** means the opposite.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -4729,15 +4729,15 @@ Sets whether to enable the full-screen mode for the window layout. This API uses ...@@ -4729,15 +4729,15 @@ Sets whether to enable the full-screen mode for the window layout. This API uses
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------------ | ------- | --------- | ------------------------------------------------------------ | | ------------------ | ------- | ---- | ------------------------------------------------------------ |
| isLayoutFullScreen | boolean | Yes | Whether to enable the full-screen mode for the window layout, in which the status bar and navigation bar are displayed. The value **true** means to enable the full-screen mode for the window layout, and **false** means the opposite. | | isLayoutFullScreen | boolean | Yes | Whether to enable the full-screen mode for the window layout, in which the status bar and navigation bar are displayed. The value **true** means to enable the full-screen mode for the window layout, and **false** means the opposite.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4765,9 +4765,9 @@ Sets whether to display the status bar and navigation bar in this window. This A ...@@ -4765,9 +4765,9 @@ Sets whether to display the status bar and navigation bar in this window. This A
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------- | --------- | ------------------------------------------------------------ | | -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| names | Array<'status'\|'navigation'> | Yes | Whether to display the status bar and navigation bar.<br>For example, to display the status bar and navigation bar, set this parameter to **['status', 'navigation']**. By default, they are not displayed. | | names | Array<'status'\|'navigation'> | Yes | Whether to display the status bar and navigation bar.<br>For example, to display the status bar and navigation bar, set this parameter to **['status', 'navigation']**. By default, they are not displayed.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -4798,15 +4798,15 @@ Sets whether to display the status bar and navigation bar in this window. This A ...@@ -4798,15 +4798,15 @@ Sets whether to display the status bar and navigation bar in this window. This A
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ----- | ----------------------------- | --------- | ------------------------------------------------------------ | | ------ | ---------------------------- | ---- | ------------------------ |
| names | Array<'status'\|'navigation'> | Yes | Whether to display the status bar and navigation bar.<br>For example, to display the status bar and navigation bar, set this parameter to **['status', 'navigation']**. By default, they are not displayed. | | names | Array<'status'\|'navigation'> | Yes | Whether to display the status bar and navigation bar.<br>For example, to display the status bar and navigation bar, set this parameter to **['status', 'navigation']**. By default, they are not displayed.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4835,9 +4835,9 @@ Sets the properties of the status bar and navigation bar in this window. This AP ...@@ -4835,9 +4835,9 @@ Sets the properties of the status bar and navigation bar in this window. This AP
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------------- | ------------------------------------------- | --------- | ------------------------------------------------ | | ------------------- | ------------------------------------------- | ---- | ---------------------- |
| SystemBarProperties | [SystemBarProperties](#systembarproperties) | Yes | Properties of the status bar and navigation bar. | | SystemBarProperties | [SystemBarProperties](#systembarproperties) | Yes | Properties of the status bar and navigation bar.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -4873,15 +4873,15 @@ Sets the properties of the status bar and navigation bar in this window. This AP ...@@ -4873,15 +4873,15 @@ Sets the properties of the status bar and navigation bar in this window. This AP
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------------- | ------------------------------------------- | --------- | ------------------------------------------------ | | ------------------- | ------------------------------------------- | ---- | ---------------------- |
| SystemBarProperties | [SystemBarProperties](#systembarproperties) | Yes | Properties of the status bar and navigation bar. | | SystemBarProperties | [SystemBarProperties](#systembarproperties) | Yes | Properties of the status bar and navigation bar.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4915,9 +4915,9 @@ Loads content from a page to this window. This API uses an asynchronous callback ...@@ -4915,9 +4915,9 @@ Loads content from a page to this window. This API uses an asynchronous callback
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------- | --------- | ------------------------------------------------------- | | -------- | ------------------------- | ---- | -------------------- |
| path | string | Yes | Path of the page from which the content will be loaded. | | path | string | Yes | Path of the page from which the content will be loaded.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -4946,15 +4946,15 @@ Loads content from a page to this window. This API uses a promise to return the ...@@ -4946,15 +4946,15 @@ Loads content from a page to this window. This API uses a promise to return the
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ---- | ------ | --------- | ------------------------------------------------------- | | ------ | ------ | ---- | -------------------- |
| path | string | Yes | Path of the page from which the content will be loaded. | | path | string | Yes | Path of the page from which the content will be loaded.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -4981,9 +4981,9 @@ Checks whether this window is displayed. This API uses an asynchronous callback ...@@ -4981,9 +4981,9 @@ Checks whether this window is displayed. This API uses an asynchronous callback
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ---------------------------- | --------- | ------------------------------------------------------------ | | -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback&lt;boolean&gt; | Yes | Callback used to return the result. The value **true** means that the window is displayed, and **false** means the opposite. | | callback | AsyncCallback&lt;boolean&gt; | Yes | Callback used to return the result. The value **true** means that the window is displayed, and **false** means the opposite.|
**Example** **Example**
...@@ -5013,7 +5013,7 @@ Checks whether this window is displayed. This API uses a promise to return the r ...@@ -5013,7 +5013,7 @@ Checks whether this window is displayed. This API uses a promise to return the r
| Type | Description | | Type | Description |
| ---------------------- | ------------------------------------------------------------ | | ---------------------- | ------------------------------------------------------------ |
| Promise&lt;boolean&gt; | Promise used to return the result. The value **true** means that the window is displayed, and **false** means the opposite. | | Promise&lt;boolean&gt; | Promise used to return the result. The value **true** means that the window is displayed, and **false** means the opposite.|
**Example** **Example**
...@@ -5040,9 +5040,9 @@ Enables listening for changes to the area where the window cannot be displayed. ...@@ -5040,9 +5040,9 @@ Enables listening for changes to the area where the window cannot be displayed.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ---------------------------------------- | --------- | ------------------------------------------------------------ | | -------- |------------------------------------------| ---- | ------------------------------------------------------- |
| type | string | Yes | Event type. The value is fixed at **'systemAvoidAreaChange'**, indicating the event of changes to the area where the window cannot be displayed. | | type | string | Yes | Event type. The value is fixed at **'systemAvoidAreaChange'**, indicating the event of changes to the area where the window cannot be displayed.|
| callback | Callback&lt;[AvoidArea](#avoidarea7)&gt; | Yes | Callback used to return the area. | | callback | Callback&lt;[AvoidArea](#avoidarea7)&gt; | Yes | Callback used to return the area. |
**Example** **Example**
...@@ -5067,9 +5067,9 @@ Disables listening for changes to the area where the window cannot be displayed. ...@@ -5067,9 +5067,9 @@ Disables listening for changes to the area where the window cannot be displayed.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ---------------------------------------- | --------- | ------------------------------------------------------------ | | -------- |------------------------------------------| ---- | ------------------------------------------------------- |
| type | string | Yes | Event type. The value is fixed at **'systemAvoidAreaChange'**, indicating the event of changes to the area where the window cannot be displayed. | | type | string | Yes | Event type. The value is fixed at **'systemAvoidAreaChange'**, indicating the event of changes to the area where the window cannot be displayed.|
| callback | Callback&lt;[AvoidArea](#avoidarea7)&gt; | No | Callback used to return the area. | | callback | Callback&lt;[AvoidArea](#avoidarea7)&gt; | No | Callback used to return the area. |
**Example** **Example**
...@@ -5092,9 +5092,9 @@ Checks whether this window supports the wide-gamut color space. This API uses an ...@@ -5092,9 +5092,9 @@ Checks whether this window supports the wide-gamut color space. This API uses an
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ---------------------------- | --------- | ------------------------------------------------------------ | | -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback&lt;boolean&gt; | Yes | Callback used to return the result. The value **true** means that the wide-gamut color space is supported, and **false** means the opposite. | | callback | AsyncCallback&lt;boolean&gt; | Yes | Callback used to return the result. The value **true** means that the wide-gamut color space is supported, and **false** means the opposite.|
**Example** **Example**
...@@ -5124,7 +5124,7 @@ Checks whether this window supports the wide-gamut color space. This API uses a ...@@ -5124,7 +5124,7 @@ Checks whether this window supports the wide-gamut color space. This API uses a
| Type | Description | | Type | Description |
| ---------------------- | ------------------------------------------------------------ | | ---------------------- | ------------------------------------------------------------ |
| Promise&lt;boolean&gt; | Promise used to return the result. The value **true** means that the wide-gamut color space is supported, and **false** means the opposite. | | Promise&lt;boolean&gt; | Promise used to return the result. The value **true** means that the wide-gamut color space is supported, and **false** means the opposite.|
**Example** **Example**
...@@ -5151,9 +5151,9 @@ Sets a color space for this window. This API uses an asynchronous callback to re ...@@ -5151,9 +5151,9 @@ Sets a color space for this window. This API uses an asynchronous callback to re
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ---------- | -------------------------- | --------- | ----------------------------------- | | ---------- | ------------------------- | ---- | ------------ |
| colorSpace | [ColorSpace](#colorspace8) | Yes | Color space to set. | | colorSpace | [ColorSpace](#colorspace8) | Yes | Color space to set.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -5182,15 +5182,15 @@ Sets a color space for this window. This API uses a promise to return the result ...@@ -5182,15 +5182,15 @@ Sets a color space for this window. This API uses a promise to return the result
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ---------- | -------------------------- | --------- | ------------------- | | ---------- | ------------------------- | ---- | -------------- |
| colorSpace | [ColorSpace](#colorspace8) | Yes | Color space to set. | | colorSpace | [ColorSpace](#colorspace8) | Yes | Color space to set.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -5217,9 +5217,9 @@ Obtains the color space of this window. This API uses an asynchronous callback t ...@@ -5217,9 +5217,9 @@ Obtains the color space of this window. This API uses an asynchronous callback t
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------- | --------- | ------------------------------------------------------------ | | -------- | ---------------------------------------------- | ---- | ---------------------------------------------------------- |
| callback | AsyncCallback&lt;[ColorSpace](#colorspace8)&gt; | Yes | Callback used to return the result. When the color space is obtained successfully, **err** is **undefined**, and **data** is the current color space. | | callback | AsyncCallback&lt;[ColorSpace](#colorspace8)&gt; | Yes | Callback used to return the result. When the color space is obtained successfully, **err** is **undefined**, and **data** is the current color space.|
**Example** **Example**
...@@ -5248,8 +5248,8 @@ Obtains the color space of this window. This API uses a promise to return the re ...@@ -5248,8 +5248,8 @@ Obtains the color space of this window. This API uses a promise to return the re
**Return value** **Return value**
| Type | Description | | Type | Description |
| ----------------------------------------- | ----------------------------------------------- | | ---------------------------------------- | ------------------------------- |
| Promise&lt;[ColorSpace](#colorspace8)&gt; | Promise used to return the current color space. | | Promise&lt;[ColorSpace](#colorspace8)&gt; | Promise used to return the current color space.|
**Example** **Example**
...@@ -5276,9 +5276,9 @@ Sets the background color for this window. This API uses an asynchronous callbac ...@@ -5276,9 +5276,9 @@ Sets the background color for this window. This API uses an asynchronous callbac
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------- | --------- | ------------------------------------------------------------ | | -------- | ------------------------- | ---- | ------------------------------------------------------------ |
| color | string | Yes | Background color to set. The value is a hexadecimal RGB or ARGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**. | | color | string | Yes | Background color to set. The value is a hexadecimal RGB or ARGB color code and is case insensitive, for example, **#00FF00** or **#FF00FF00**.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -5308,15 +5308,15 @@ Sets the background color for this window. This API uses a promise to return the ...@@ -5308,15 +5308,15 @@ Sets the background color for this window. This API uses a promise to return the
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ----- | ------ | --------- | ------------------------------------------------------------ | | ------ | ------ | ---- | ------------------------------------------------------------ |
| color | string | Yes | Background color to set. The value is a hexadecimal RGB or ARGB color value and is case insensitive, for example, **#00FF00** or **#FF00FF00**. | | color | string | Yes | Background color to set. The value is a hexadecimal RGB or ARGB color code and is case insensitive, for example, **#00FF00** or **#FF00FF00**.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -5344,9 +5344,9 @@ Sets the screen brightness for this window. This API uses an asynchronous callba ...@@ -5344,9 +5344,9 @@ Sets the screen brightness for this window. This API uses an asynchronous callba
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ---------- | ------------------------- | --------- | ------------------------------------------------------------ | | ---------- | ------------------------- | ---- | ------------------------------------ |
| brightness | number | Yes | Brightness to set, which ranges from 0 to 1. The value **1** indicates the brightest. | | brightness | number | Yes | Brightness to set, which ranges from 0 to 1. The value **1** indicates the brightest.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -5376,15 +5376,15 @@ Sets the screen brightness for this window. This API uses a promise to return th ...@@ -5376,15 +5376,15 @@ Sets the screen brightness for this window. This API uses a promise to return th
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ---------- | ------ | --------- | ------------------------------------------------------------ | | ---------- | ------ | ---- | ------------------------------------ |
| brightness | number | Yes | Brightness to set, which ranges from 0 to 1. The value **1** indicates the brightest. | | brightness | number | Yes | Brightness to set, which ranges from 0 to 1. The value **1** indicates the brightest.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -5412,9 +5412,9 @@ Sets the dimness of the window that is not on top. This API uses an asynchronous ...@@ -5412,9 +5412,9 @@ Sets the dimness of the window that is not on top. This API uses an asynchronous
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------------- | ------------------------- | --------- | ------------------------------------------------------------ | | -------------- | ------------------------- | ---- | -------------------------------------------------- |
| dimBehindValue | number | Yes | Dimness of the window to set. The value ranges from 0 to 1. The value **1** indicates the dimmest. | | dimBehindValue | number | Yes | Dimness of the window to set. The value ranges from 0 to 1. The value **1** indicates the dimmest.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -5443,15 +5443,15 @@ Sets the dimness of the window that is not on top. This API uses a promise to re ...@@ -5443,15 +5443,15 @@ Sets the dimness of the window that is not on top. This API uses a promise to re
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------------- | ------ | --------- | ------------------------------------------------------------ | | -------------- | ------ | ---- | -------------------------------------------------- |
| dimBehindValue | number | Yes | Dimness of the window to set. The value ranges from 0 to 1. The value **1** indicates the dimmest. | | dimBehindValue | number | Yes | Dimness of the window to set. The value ranges from 0 to 1. The value **1** indicates the dimmest.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -5478,9 +5478,9 @@ Sets whether this window can gain focus. This API uses an asynchronous callback ...@@ -5478,9 +5478,9 @@ Sets whether this window can gain focus. This API uses an asynchronous callback
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ----------- | ------------------------- | --------- | ------------------------------------------------------------ | | ----------- | ------------------------- | ---- | ---------------------------- |
| isFocusable | boolean | Yes | Whether the window can gain focus. The value **true** means that the window can gain focus, and **false** means the opposite. | | isFocusable | boolean | Yes | Whether the window can gain focus. The value **true** means that the window can gain focus, and **false** means the opposite.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -5510,15 +5510,15 @@ Sets whether this window can gain focus. This API uses a promise to return the r ...@@ -5510,15 +5510,15 @@ Sets whether this window can gain focus. This API uses a promise to return the r
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ----------- | ------- | --------- | ------------------------------------------------------------ | | ----------- | ------- | ---- | ---------------------------- |
| isFocusable | boolean | Yes | Whether the window can gain focus. The value **true** means that the window can gain focus, and **false** means the opposite. | | isFocusable | boolean | Yes | Whether the window can gain focus. The value **true** means that the window can gain focus, and **false** means the opposite.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -5546,9 +5546,9 @@ Sets whether to keep the screen always on. This API uses an asynchronous callbac ...@@ -5546,9 +5546,9 @@ Sets whether to keep the screen always on. This API uses an asynchronous callbac
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------------- | ------------------------- | --------- | ------------------------------------------------------------ | | -------------- | ------------------------- | ---- | ------------------------ |
| isKeepScreenOn | boolean | Yes | Whether to keep the screen always on. The value **true** means to keep the screen always on, and **false** means the opposite. | | isKeepScreenOn | boolean | Yes | Whether to keep the screen always on. The value **true** means to keep the screen always on, and **false** means the opposite.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -5578,15 +5578,15 @@ Sets whether to keep the screen always on. This API uses a promise to return the ...@@ -5578,15 +5578,15 @@ Sets whether to keep the screen always on. This API uses a promise to return the
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------------- | ------- | --------- | ------------------------------------------------------------ | | -------------- | ------- | ---- | ------------------------ |
| isKeepScreenOn | boolean | Yes | Whether to keep the screen always on. The value **true** means to keep the screen always on, and **false** means the opposite. | | isKeepScreenOn | boolean | Yes | Whether to keep the screen always on. The value **true** means to keep the screen always on, and **false** means the opposite.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -5614,9 +5614,9 @@ Sets whether the area outside the subwindow is touchable. This API uses an async ...@@ -5614,9 +5614,9 @@ Sets whether the area outside the subwindow is touchable. This API uses an async
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| --------- | ------------------------- | --------- | ------------------------------------------------------------ | | --------- | ------------------------- | ---- | ---------------- |
| touchable | boolean | Yes | Whether the area outside the subwindow is touchable. The value **true** means the area outside the subwindow is touchable, and **false** means the opposite. | | touchable | boolean | Yes | Whether the area outside the subwindow is touchable. The value **true** means the area outside the subwindow is touchable, and **false** means the opposite.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -5645,15 +5645,15 @@ Sets whether the area outside the subwindow is touchable. This API uses a promis ...@@ -5645,15 +5645,15 @@ Sets whether the area outside the subwindow is touchable. This API uses a promis
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| --------- | ------- | --------- | ------------------------------------------------------------ | | --------- | ------- | ---- | ---------------- |
| touchable | boolean | Yes | Whether the area outside the subwindow is touchable. The value **true** means the area outside the subwindow is touchable, and **false** means the opposite. | | touchable | boolean | Yes | Whether the area outside the subwindow is touchable. The value **true** means the area outside the subwindow is touchable, and **false** means the opposite.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -5680,9 +5680,9 @@ Sets whether this window is in privacy mode. This API uses an asynchronous callb ...@@ -5680,9 +5680,9 @@ Sets whether this window is in privacy mode. This API uses an asynchronous callb
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------- | ------------------------- | --------- | ------------------------------------------------------------ | | ------------- | ------------------------- | ---- | -------------------- |
| isPrivacyMode | boolean | Yes | Whether the window is in privacy mode. The value **true** means that the window is in privacy mode, and **false** means the opposite. | | isPrivacyMode | boolean | Yes | Whether the window is in privacy mode. The value **true** means that the window is in privacy mode, and **false** means the opposite.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -5712,15 +5712,15 @@ Sets whether this window is in privacy mode. This API uses a promise to return t ...@@ -5712,15 +5712,15 @@ Sets whether this window is in privacy mode. This API uses a promise to return t
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------------- | ------- | --------- | ------------------------------------------------------------ | | ------------- | ------- | ---- | -------------------- |
| isPrivacyMode | boolean | Yes | Whether the window is in privacy mode. The value **true** means that the window is in privacy mode, and **false** means the opposite. | | isPrivacyMode | boolean | Yes | Whether the window is in privacy mode. The value **true** means that the window is in privacy mode, and **false** means the opposite.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -5748,9 +5748,9 @@ Sets whether this window is touchable. This API uses an asynchronous callback to ...@@ -5748,9 +5748,9 @@ Sets whether this window is touchable. This API uses an asynchronous callback to
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ----------- | ------------------------- | --------- | ------------------------------------------------------------ | | ----------- | ------------------------- | ---- | -------------------- |
| isTouchable | boolean | Yes | Whether the window is touchable. The value **true** means that the window is touchable, and **false** means the opposite. | | isTouchable | boolean | Yes | Whether the window is touchable. The value **true** means that the window is touchable, and **false** means the opposite.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -5780,15 +5780,15 @@ Sets whether this window is touchable. This API uses a promise to return the res ...@@ -5780,15 +5780,15 @@ Sets whether this window is touchable. This API uses a promise to return the res
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ----------- | ------- | --------- | ------------------------------------------------------------ | | ----------- | ------- | ---- | -------------------- |
| isTouchable | boolean | Yes | Whether the window is touchable. The value **true** means that the window is touchable, and **false** means the opposite. | | isTouchable | boolean | Yes | Whether the window is touchable. The value **true** means that the window is touchable, and **false** means the opposite.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Example** **Example**
...@@ -5810,12 +5810,12 @@ Describes the lifecycle of a window stage. ...@@ -5810,12 +5810,12 @@ Describes the lifecycle of a window stage.
**System capability**: SystemCapability.WindowManager.WindowManager.Core **System capability**: SystemCapability.WindowManager.WindowManager.Core
| Name | Value | Description | | Name | Value| Description |
| -------- | ----- | ---------------------------------------------- | | ---------- | ------ | ---------- |
| SHOWN | 1 | The window stage is running in the foreground. | | SHOWN | 1 | The window stage is running in the foreground.|
| ACTIVE | 2 | The window stage gains focus. | | ACTIVE | 2 | The window stage gains focus.|
| INACTIVE | 3 | The window stage loses focus. | | INACTIVE | 3 | The window stage loses focus.|
| HIDDEN | 4 | The window stage is running in the background. | | HIDDEN | 4 | The window stage is running in the background.|
## WindowStage<sup>9+</sup> ## WindowStage<sup>9+</sup>
...@@ -5835,15 +5835,15 @@ Obtains the main window of this window stage. This API uses an asynchronous call ...@@ -5835,15 +5835,15 @@ Obtains the main window of this window stage. This API uses an asynchronous call
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | -------------------------------------- | --------- | ---------------------------------------- | | -------- | -------------------------------------- | ---- | --------------------------------------------- |
| callback | AsyncCallback&lt;[Window](#window)&gt; | Yes | Callback used to return the main window. | | callback | AsyncCallback&lt;[Window](#window)&gt; | Yes | Callback used to return the main window.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -5882,14 +5882,14 @@ Obtains the main window of this window stage. This API uses a promise to return ...@@ -5882,14 +5882,14 @@ Obtains the main window of this window stage. This API uses a promise to return
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------------------------- | --------------------------------------- | | -------------------------------- | ------------------------------------------------ |
| Promise&lt;[Window](#window)&gt; | Promise used to return the main window. | | Promise&lt;[Window](#window)&gt; | Promise used to return the main window.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -5926,15 +5926,15 @@ Obtains the main window of this window stage. ...@@ -5926,15 +5926,15 @@ Obtains the main window of this window stage.
**Return value** **Return value**
| Type | Description | | Type| Description|
| ----------------- | ----------------------- | | ----------------- | --------------------------------- |
| [Window](#window) | return the main window. | | [Window](#window) | return the main window.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -5968,16 +5968,16 @@ Creates a subwindow for this window stage. This API uses an asynchronous callbac ...@@ -5968,16 +5968,16 @@ Creates a subwindow for this window stage. This API uses an asynchronous callbac
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | -------------------------------------- | --------- | -------------------------------------- | | -------- | -------------------------------------- | ---- | --------------------------------------------- |
| name | string | Yes | Name of the subwindow. | | name | string | Yes | Name of the subwindow. |
| callback | AsyncCallback&lt;[Window](#window)&gt; | Yes | Callback used to return the subwindow. | | callback | AsyncCallback&lt;[Window](#window)&gt; | Yes | Callback used to return the subwindow.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6019,21 +6019,21 @@ Creates a subwindow for this window stage. This API uses a promise to return the ...@@ -6019,21 +6019,21 @@ Creates a subwindow for this window stage. This API uses a promise to return the
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name| Type | Mandatory| Description |
| ---- | ------ | --------- | ---------------------- | | ------ | ------ | ---- | -------------- |
| name | string | Yes | Name of the subwindow. | | name | string | Yes | Name of the subwindow.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------------------------- | ------------------------------------- | | -------------------------------- | ------------------------------------------------ |
| Promise&lt;[Window](#window)&gt; | Promise used to return the subwindow. | | Promise&lt;[Window](#window)&gt; | Promise used to return the subwindow.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6074,15 +6074,15 @@ Obtains all the subwindows of this window stage. This API uses an asynchronous c ...@@ -6074,15 +6074,15 @@ Obtains all the subwindows of this window stage. This API uses an asynchronous c
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | --------------------------------------------------- | --------- | ------------------------------------------- | | -------- | --------------------------------------------------- | ---- | ------------------------------------------------- |
| callback | AsyncCallback&lt;Array&lt;[Window](#window)&gt;&gt; | Yes | Callback used to return all the subwindows. | | callback | AsyncCallback&lt;Array&lt;[Window](#window)&gt;&gt; | Yes | Callback used to return all the subwindows.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6119,14 +6119,14 @@ Obtains all the subwindows of this window stage. This API uses a promise to retu ...@@ -6119,14 +6119,14 @@ Obtains all the subwindows of this window stage. This API uses a promise to retu
**Return value** **Return value**
| Type | Description | | Type | Description |
| --------------------------------------------- | ------------------------------------------ | | --------------------------------------------- | ---------------------------------------------------- |
| Promise&lt;Array&lt;[Window](#window)&gt;&gt; | Promise used to return all the subwindows. | | Promise&lt;Array&lt;[Window](#window)&gt;&gt; | Promise used to return all the subwindows.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6161,17 +6161,17 @@ Loads content from a page associated with a local storage to the main window in ...@@ -6161,17 +6161,17 @@ Loads content from a page associated with a local storage to the main window in
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------------------ | --------- | ------------------------------------------------------------ | | -------- | ----------------------------------------------- | ---- | ------------------------------------------------------------ |
| path | string | Yes | Path of the page from which the content will be loaded. | | path | string | Yes | Path of the page from which the content will be loaded. |
| storage | [LocalStorage](../../quick-start/arkts-state-mgmt-application-level.md#localstorage) | Yes | A storage unit, which provides storage for variable state properties and non-variable state properties of an application. | | storage | [LocalStorage](../../quick-start/arkts-localstorage.md) | Yes | A storage unit, which provides storage for variable state properties and non-variable state properties of an application.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6214,22 +6214,22 @@ Loads content from a page associated with a local storage to the main window in ...@@ -6214,22 +6214,22 @@ Loads content from a page associated with a local storage to the main window in
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------- | ------------------------------------------------------------ | --------- | ------------------------------------------------------------ | | ------- | ----------------------------------------------- | ---- | ------------------------------------------------------------ |
| path | string | Yes | Path of the page from which the content will be loaded. | | path | string | Yes | Path of the page from which the content will be loaded. |
| storage | [LocalStorage](../../quick-start/arkts-state-mgmt-application-level.md#localstorage) | No | A storage unit, which provides storage for variable state properties and non-variable state properties of an application. | | storage | [LocalStorage](../../quick-start/arkts-localstorage.md) | No | A storage unit, which provides storage for variable state properties and non-variable state properties of an application.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | ------------------------------ | | ------------------- | ------------------------- |
| Promise&lt;void&gt; | Promise that returns no value. | | Promise&lt;void&gt; | Promise that returns no value.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6271,16 +6271,16 @@ Loads content from a page to this window stage. This API uses an asynchronous ca ...@@ -6271,16 +6271,16 @@ Loads content from a page to this window stage. This API uses an asynchronous ca
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------- | --------- | ------------------------------------------------------- | | -------- | ------------------------- | ---- | -------------------- |
| path | string | Yes | Path of the page from which the content will be loaded. | | path | string | Yes | Path of the page from which the content will be loaded.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. |
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6320,16 +6320,16 @@ Enables listening for window stage lifecycle changes. ...@@ -6320,16 +6320,16 @@ Enables listening for window stage lifecycle changes.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------------------ | --------- | ------------------------------------------------------------ | | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | Yes | Event type. The value is fixed at **'windowStageEvent'**, indicating the window stage lifecycle change event. | | type | string | Yes | Event type. The value is fixed at **'windowStageEvent'**, indicating the window stage lifecycle change event.|
| callback | Callback&lt;[WindowStageEventType](#windowstageeventtype9)&gt; | Yes | Callback used to return the window stage lifecycle state. | | callback | Callback&lt;[WindowStageEventType](#windowstageeventtype9)&gt; | Yes | Callback used to return the window stage lifecycle state. |
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6367,16 +6367,16 @@ Disables listening for window stage lifecycle changes. ...@@ -6367,16 +6367,16 @@ Disables listening for window stage lifecycle changes.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------------------ | --------- | ------------------------------------------------------------ | | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | Yes | Event type. The value is fixed at **'windowStageEvent'**, indicating the window stage lifecycle change event. | | type | string | Yes | Event type. The value is fixed at **'windowStageEvent'**, indicating the window stage lifecycle change event.|
| callback | Callback&lt;[WindowStageEventType](#windowstageeventtype9)&gt; | No | Callback used to return the window stage lifecycle state. | | callback | Callback&lt;[WindowStageEventType](#windowstageeventtype9)&gt; | No | Callback used to return the window stage lifecycle state. |
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6415,7 +6415,7 @@ Disables window decorators. ...@@ -6415,7 +6415,7 @@ Disables window decorators.
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6447,15 +6447,15 @@ Sets whether to display the window of the application on the lock screen. ...@@ -6447,15 +6447,15 @@ Sets whether to display the window of the application on the lock screen.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ---------------- | ------- | --------- | ------------------------------------------------------------ | | ---------------- | ------- | ---- | ---------------------------- |
| showOnLockScreen | boolean | Yes | Whether to display the window on the lock screen. The value **true** means to display the window on the lock screen, and **false** means the opposite. | | showOnLockScreen | boolean | Yes | Whether to display the window on the lock screen. The value **true** means to display the window on the lock screen, and **false** means the opposite.|
**Error codes** **Error codes**
For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md). For details about the error codes, see [Window Error Codes](../errorcodes/errorcode-window.md).
| ID | Error Message | | ID| Error Message|
| ------- | ------------------------------ | | ------- | ------------------------------ |
| 1300002 | This window state is abnormal. | | 1300002 | This window state is abnormal. |
| 1300005 | This window stage is abnormal. | | 1300005 | This window stage is abnormal. |
...@@ -6486,9 +6486,9 @@ Provides the context for the transition animation. ...@@ -6486,9 +6486,9 @@ Provides the context for the transition animation.
**System capability**: SystemCapability.WindowManager.WindowManager.Core **System capability**: SystemCapability.WindowManager.WindowManager.Core
| Name | Type | Readable | Writable | Description | | Name | Type | Readable| Writable| Description |
| --------------------- | ----------------- | -------- | -------- | --------------------------------------- | | --------------------- | ----------------- | ---- | ---- | ---------------- |
| toWindow<sup>9+</sup> | [Window](#window) | Yes | Yes | Target window to display the animation. | | toWindow<sup>9+</sup> | [Window](#window) | Yes | Yes | Target window to display the animation.|
### completeTransition<sup>9+</sup> ### completeTransition<sup>9+</sup>
...@@ -6502,9 +6502,9 @@ Completes the transition. This API can be called only after [animateTo()](../ark ...@@ -6502,9 +6502,9 @@ Completes the transition. This API can be called only after [animateTo()](../ark
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ----------- | ------- | --------- | ------------------------------------------------------------ | | ----------- | ------- | ---- | ------------------------------------------------------------ |
| isCompleted | boolean | Yes | Whether the transition is complete. The value **true** means that the transition is complete, and **false** means the opposite. | | isCompleted | boolean | Yes | Whether the transition is complete. The value **true** means that the transition is complete, and **false** means the opposite.|
**Example** **Example**
...@@ -6554,9 +6554,9 @@ Customizes the animation for the scenario when the window is shown. ...@@ -6554,9 +6554,9 @@ Customizes the animation for the scenario when the window is shown.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------- | ---------------------------------------- | --------- | ------------------------------------ | | ------- | ---------------------------------------- | ---- | -------------------- |
| context | [TransitionContext](#transitioncontext9) | Yes | Context of the transition animation. | | context | [TransitionContext](#transitioncontext9) | Yes | Context of the transition animation.|
**Example** **Example**
...@@ -6600,9 +6600,9 @@ Customizes the animation for the scenario when the window is hidden. ...@@ -6600,9 +6600,9 @@ Customizes the animation for the scenario when the window is hidden.
**Parameters** **Parameters**
| Name | Type | Mandatory | Description | | Name | Type | Mandatory| Description |
| ------- | ---------------------------------------- | --------- | ------------------------------------ | | ------- | ---------------------------------------- | ---- | -------------------- |
| context | [TransitionContext](#transitioncontext9) | Yes | Context of the transition animation. | | context | [TransitionContext](#transitioncontext9) | Yes | Context of the transition animation.|
**Example** **Example**
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或