diff --git a/zh-cn/application-dev/reference/apis/js-apis-window.md b/zh-cn/application-dev/reference/apis/js-apis-window.md
index 57bb4f182698f00f39610cc9282770b82e40fc88..f7a1adc0236b06628f634e85a1bbfaaeb24dcdcd 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-window.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-window.md
@@ -839,7 +839,7 @@ create(id: string, type: WindowType, callback: AsyncCallback<Window>): voi
创建子窗口,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[createWindow()](#windowcreatewindow9)。
**模型约束:** 此接口仅可在FA模型下使用。
@@ -875,7 +875,7 @@ create(id: string, type: WindowType): Promise<Window>
创建子窗口,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[createWindow()](#windowcreatewindow9-1)。
**模型约束:** 此接口仅可在FA模型下使用。
@@ -915,7 +915,7 @@ create(ctx: BaseContext, id: string, type: WindowType, callback: AsyncCallback&l
创建系统窗口,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[createWindow()](#windowcreatewindow9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -951,7 +951,7 @@ create(ctx: BaseContext, id: string, type: WindowType): Promise<Window>
创建系统窗口,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[createWindow()](#windowcreatewindow9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -990,7 +990,7 @@ find(id: string, callback: AsyncCallback<Window>): void
查找id所对应的窗口,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[findWindow()](#windowfindwindow9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -1023,7 +1023,7 @@ find(id: string): Promise<Window>
查找id所对应的窗口,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[findWindow()](#windowfindwindow9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -1060,7 +1060,7 @@ getTopWindow(callback: AsyncCallback<Window>): void
获取当前应用内最后显示的窗口,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[getLastWindow()](#windowgetlastwindow9)。
**模型约束:** 此接口仅可在FA模型下使用。
@@ -1094,7 +1094,7 @@ getTopWindow(): Promise<Window>
获取当前应用内最后显示的窗口,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[getLastWindow()](#windowgetlastwindow9-1)。
**模型约束:** 此接口仅可在FA模型下使用。
@@ -1127,7 +1127,7 @@ getTopWindow(ctx: BaseContext, callback: AsyncCallback<Window>): void
获取当前应用内最后显示的窗口,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 8开始支持,从API version 9开始废弃,推荐使用[getLastWindow()](#windowgetlastwindow9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -1160,7 +1160,7 @@ getTopWindow(ctx: BaseContext): Promise<Window>
获取当前应用内最后显示的窗口,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 8开始支持,从API version 9开始废弃,推荐使用[getLastWindow()](#windowgetlastwindow9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4065,7 +4065,7 @@ controller.animationForHidden = (context : window.TransitionContext) => {
playMode: PlayMode.Normal, // 动画模式
onFinish: ()=> {
context.completeTransition(true)
- }
+ }
}, () => {
let obj : window.TranslateOptions = {
x : 100.0,
@@ -4341,6 +4341,176 @@ promise.then(()=> {
console.error('Failed to raise the window to app top. Cause: ' + JSON.stringify(err));
});
```
+### setAspectRatio10+
+
+setAspectRatio(ratio: number): Promise<void>
+
+设置窗口内容布局的比例,使用Promise异步回调。
+
+仅应用主窗口支持此接口功能,比例参数将持久化保存,关闭应用或重启设备设置的比例仍然生效。
+
+**系统能力:** SystemCapability.WindowManager.WindowManager.Core
+
+**参数:**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------------------ | ------- | ---- | ------------------------------------------------------------ |
+| ratio | number | 是 | 除边框装饰之外的窗口内容布局的宽高比,取值范围为大于0。 |
+
+**返回值:**
+
+| 类型 | 说明 |
+| ------------------- | ------------------------- |
+| Promise<void> | 无返回结果的Promise对象。 |
+
+**错误码:**
+
+以下错误码的详细介绍请参见[窗口错误码](../errorcodes/errorcode-window.md)。
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------------------- |
+| 1300002 | This window state is abnormal. |
+| 1300004 | Unauthorized operation. |
+
+**示例:**
+
+```js
+try {
+ let ratio = 1.0;
+ let promise = windowClass.setAspectRatio(ratio);
+ promise.then(()=> {
+ console.info('Succeeded in setting aspect ratio of window.');
+ }).catch((err)=>{
+ console.error('Failed to set the aspect ratio of window. Cause:' + JSON.stringify(err));
+ });
+} catch (exception) {
+ console.error('Failed to set the aspect ratio of window. Cause: ' + JSON.stringify(exception));
+}
+```
+
+### setAspectRatio10+
+
+setAspectRatio(ratio: number, callback: AsyncCallback<void>): void
+
+设置窗口内容布局的比例,使用callback异步回调。
+
+仅应用主窗口支持此接口功能,比例参数将持久化保存,关闭应用或重启设备设置的比例仍然生效。
+
+**系统能力:** SystemCapability.WindowManager.WindowManager.Core
+
+**参数:**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------------------ | ------- | ---- | ------------------------------------------------------------ |
+| ratio | number | 是 | 除边框装饰之外的窗口内容布局的宽高比,取值范围为大于0。 |
+| callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+**错误码:**
+
+以下错误码的详细介绍请参见[窗口错误码](../errorcodes/errorcode-window.md)。
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------------------- |
+| 1300002 | This window state is abnormal. |
+| 1300004 | Unauthorized operation. |
+
+**示例:**
+
+```js
+try {
+ let ratio = 1.0;
+ windowClass.setAspectRatio(ratio, (err) => {
+ if (err.code) {
+ console.error('Failed to set the aspect ratio of window. Cause:' + JSON.stringify(err));
+ return;
+ }
+ console.error('Failed to set the aspect ratio of window. Cause:' + JSON.stringify(err));
+ });
+} catch (exception) {
+ console.error('Failed to set the aspect ratio of window. Cause: ' + JSON.stringify(exception));
+}
+```
+
+### resetAspectRatio10+
+
+resetAspectRatio(): Promise<void>
+
+取消设置窗口内容布局的比例,使用Promise异步回调。
+
+仅应用主窗口支持此接口功能,调用后将清除持久化储存的比例信息。
+
+**系统能力:** SystemCapability.WindowManager.WindowManager.Core
+
+**返回值:**
+
+| 类型 | 说明 |
+| ------------------- | ------------------------- |
+| Promise<void> | 无返回结果的Promise对象。 |
+
+**错误码:**
+
+以下错误码的详细介绍请参见[窗口错误码](../errorcodes/errorcode-window.md)。
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------------------- |
+| 1300002 | This window state is abnormal. |
+| 1300004 | Unauthorized operation. |
+
+**示例:**
+
+```js
+try {
+ let promise = windowClass.resetAspectRatio();
+ promise.then(()=> {
+ console.info('Succeeded in resetting aspect ratio of window.');
+ }).catch((err)=>{
+ console.error('Failed to reset the aspect ratio of window. Cause:' + JSON.stringify(err));
+ });
+} catch (exception) {
+ console.error('Failed to reset the aspect ratio of window. Cause: ' + JSON.stringify(exception));
+}
+```
+
+### resetAspectRatio10+
+
+resetAspectRatio(callback: AsyncCallback<void>): void
+
+取消设置窗口内容布局的比例,使用callback异步回调。
+
+仅应用主窗口支持此接口功能,调用后将清除持久化储存的比例信息。
+
+**系统能力:** SystemCapability.WindowManager.WindowManager.Core
+
+**参数:**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------------------ | ------- | ---- | ------------------------------------------------------------ |
+| callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+**错误码:**
+
+以下错误码的详细介绍请参见[窗口错误码](../errorcodes/errorcode-window.md)。
+
+| 错误码ID | 错误信息 |
+| ------- | -------------------------------------------- |
+| 1300002 | This window state is abnormal. |
+| 1300004 | Unauthorized operation. |
+
+**示例:**
+
+```js
+try {
+ windowClass.resetAspectRatio((err) => {
+ if (err.code) {
+ console.error('Failed to reset the aspect ratio of window. Cause:' + JSON.stringify(err));
+ return;
+ }
+ console.info('Succeeded in resetting aspect ratio of window.');
+ });
+} catch (exception) {
+ console.error('Failed to reset the aspect ratio of window. Cause: ' + JSON.stringify(exception));
+}
+```
### show(deprecated)
@@ -4349,7 +4519,7 @@ show(callback: AsyncCallback<void>): void
显示当前窗口,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[showWindow()](#showwindow9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4379,7 +4549,7 @@ show(): Promise<void>
显示当前窗口,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[showWindow()](#showwindow9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4408,7 +4578,7 @@ destroy(callback: AsyncCallback<void>): void
销毁当前窗口,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[destroyWindow()](#destroywindow9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4438,7 +4608,7 @@ destroy(): Promise<void>
销毁当前窗口,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[destroyWindow()](#destroywindow9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4469,7 +4639,7 @@ moveTo(x: number, y: number, callback: AsyncCallback<void>): void
全屏模式窗口不支持该操作。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[moveWindowTo()](#movewindowto9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4503,7 +4673,7 @@ moveTo(x: number, y: number): Promise<void>
全屏模式窗口不支持该操作。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[moveWindowTo()](#movewindowto9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4547,7 +4717,7 @@ resetSize(width: number, height: number, callback: AsyncCallback<void>): v
全屏模式窗口不支持该操作。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[resize()](#resize9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4587,7 +4757,7 @@ resetSize(width: number, height: number): Promise<void>
全屏模式窗口不支持该操作。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[resize()](#resize9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4625,7 +4795,7 @@ setWindowType(type: WindowType, callback: AsyncCallback<void>): void
**系统接口:** 此接口为系统接口。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4659,7 +4829,7 @@ setWindowType(type: WindowType): Promise<void>
**系统接口:** 此接口为系统接口。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4695,7 +4865,7 @@ getProperties(callback: AsyncCallback<WindowProperties>): void
获取当前窗口的属性,使用callback异步回调,返回WindowProperties。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[getWindowProperties()](#getwindowproperties9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4725,7 +4895,7 @@ getProperties(): Promise<WindowProperties>
获取当前窗口的属性,使用Promise异步回调,返回WindowProperties。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[getWindowProperties()](#getwindowproperties9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4754,7 +4924,7 @@ getAvoidArea(type: [AvoidAreaType](#avoidareatype7), callback: AsyncCallback<
获取窗口内容规避的区域;如系统栏区域、刘海屏区域、手势区域、软键盘区域等与窗口内容重叠时,需要窗口内容避让的区域。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[getWindowAvoidArea()](#getwindowavoidarea9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4786,7 +4956,7 @@ getAvoidArea(type: [AvoidAreaType](#avoidareatype7)): Promise<[AvoidArea](#av
获取窗口内容规避的区域;如系统栏区域、刘海屏区域、手势区域、软键盘区域等与窗口内容重叠时,需要窗口内容避让的区域。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[getWindowAvoidArea()](#getwindowavoidarea9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4822,7 +4992,7 @@ setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void
设置是否为全屏状态,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowSystemBarEnable()](#setwindowsystembarenable9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4854,7 +5024,7 @@ setFullScreen(isFullScreen: boolean): Promise<void>
设置是否为全屏状态,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowSystemBarEnable()](#setwindowsystembarenable9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4890,7 +5060,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void
设置窗口的布局是否为全屏显示状态,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowLayoutFullScreen()](#setwindowlayoutfullscreen9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4922,7 +5092,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void>
设置窗口的布局是否为全屏显示状态,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowLayoutFullScreen()](#setwindowlayoutfullscreen9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4958,7 +5128,7 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallbac
设置导航栏、状态栏的可见模式,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowSystemBarEnable()](#setwindowsystembarenable9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -4991,7 +5161,7 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void>
设置导航栏、状态栏的可见模式,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowSystemBarEnable()](#setwindowsystembarenable9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5028,7 +5198,7 @@ setSystemBarProperties(systemBarProperties: SystemBarProperties, callback: Async
设置窗口内导航栏、状态栏的属性,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowSystemBarProperties()](#setwindowsystembarproperties9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5066,7 +5236,7 @@ setSystemBarProperties(systemBarProperties: SystemBarProperties): Promise<voi
设置窗口内导航栏、状态栏的属性,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowSystemBarProperties()](#setwindowsystembarproperties9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5108,7 +5278,7 @@ loadContent(path: string, callback: AsyncCallback<void>): void
为当前窗口加载具体页面内容,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setUIContent()](#setuicontent9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5139,7 +5309,7 @@ loadContent(path: string): Promise<void>
为当前窗口加载具体页面内容,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setUIContent()](#setuicontent9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5174,7 +5344,7 @@ isShowing(callback: AsyncCallback<boolean>): void
判断当前窗口是否已显示,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[isWindowShowing()](#iswindowshowing9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5204,7 +5374,7 @@ isShowing(): Promise<boolean>
判断当前窗口是否已显示,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[isWindowShowing()](#iswindowshowing9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5233,7 +5403,7 @@ on(type: 'systemAvoidAreaChange', callback: Callback<AvoidArea>): void
开启系统规避区变化的监听。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[on('avoidAreaChange')](#onavoidareachange9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5260,7 +5430,7 @@ off(type: 'systemAvoidAreaChange', callback?: Callback<AvoidArea>): void
关闭系统规避区变化的监听。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[off('avoidAreaChange')](#offavoidareachange9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5285,7 +5455,7 @@ isSupportWideGamut(callback: AsyncCallback<boolean>): void
判断当前窗口是否支持广色域模式,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 8开始支持,从API version 9开始废弃,推荐使用[isWindowSupportWideGamut()](#iswindowsupportwidegamut9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5315,7 +5485,7 @@ isSupportWideGamut(): Promise<boolean>
判断当前窗口是否支持广色域模式,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 8开始支持,从API version 9开始废弃,推荐使用[isWindowSupportWideGamut()](#iswindowsupportwidegamut9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5344,7 +5514,7 @@ setColorSpace(colorSpace:ColorSpace, callback: AsyncCallback<void>): void
设置当前窗口为广色域模式或默认色域模式,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 8开始支持,从API version 9开始废弃,推荐使用[setWindowColorSpace()](#setwindowcolorspace9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5375,7 +5545,7 @@ setColorSpace(colorSpace:ColorSpace): Promise<void>
设置当前窗口为广色域模式或默认色域模式,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 8开始支持,从API version 9开始废弃,推荐使用[setWindowColorSpace()](#setwindowcolorspace9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5410,7 +5580,7 @@ getColorSpace(callback: AsyncCallback<ColorSpace>): void
获取当前窗口色域模式,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 8开始支持,从API version 9开始废弃,推荐使用[getWindowColorSpace()](#getwindowcolorspace9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5440,7 +5610,7 @@ getColorSpace(): Promise<ColorSpace>
获取当前窗口色域模式,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 8开始支持,从API version 9开始废弃,推荐使用[getWindowColorSpace()](#getwindowcolorspace9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5469,7 +5639,7 @@ setBackgroundColor(color: string, callback: AsyncCallback<void>): void
设置窗口的背景色,使用callback异步回调。Stage模型下,该接口需要在[loadContent](#loadcontent9)或[setUIContent()](#setuicontent9)之后使用。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowBackgroundColor()](#setwindowbackgroundcolor9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5501,7 +5671,7 @@ setBackgroundColor(color: string): Promise<void>
设置窗口的背景色,使用Promise异步回调。Stage模型下,该接口需要在[loadContent](#loadcontent9)或[setUIContent()](#setuicontent9)之后使用。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowBackgroundColor()](#setwindowbackgroundcolor9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5537,7 +5707,7 @@ setBrightness(brightness: number, callback: AsyncCallback<void>): void
设置屏幕亮度值,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowBrightness()](#setwindowbrightness9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5569,7 +5739,7 @@ setBrightness(brightness: number): Promise<void>
设置屏幕亮度值,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowBrightness()](#setwindowbrightness9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5605,7 +5775,7 @@ setDimBehind(dimBehindValue: number, callback: AsyncCallback<void>): void
窗口叠加时,设备有子窗口的情况下设置靠后的窗口的暗度值,使用callback异步回调。
> **说明:**
->
+>
> 该接口不支持使用。从 API version 7开始支持,从API version 9开始废弃。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5636,7 +5806,7 @@ setDimBehind(dimBehindValue: number): Promise<void>
窗口叠加时,设备有子窗口的情况下设置靠后的窗口的暗度值,使用Promise异步回调。
> **说明:**
->
+>
> 该接口不支持使用。从 API version 7开始支持,从API version 9开始废弃。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5671,7 +5841,7 @@ setFocusable(isFocusable: boolean, callback: AsyncCallback<void>): void
设置点击时是否支持切换焦点窗口,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowFocusable()](#setwindowfocusable9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5703,7 +5873,7 @@ setFocusable(isFocusable: boolean): Promise<void>
设置点击时是否支持切换焦点窗口,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowFocusable()](#setwindowfocusable9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5739,7 +5909,7 @@ setKeepScreenOn(isKeepScreenOn: boolean, callback: AsyncCallback<void>): v
设置屏幕是否为常亮状态,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowKeepScreenOn()](#setwindowkeepscreenon9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5771,7 +5941,7 @@ setKeepScreenOn(isKeepScreenOn: boolean): Promise<void>
设置屏幕是否为常亮状态,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 6开始支持,从API version 9开始废弃,推荐使用[setWindowKeepScreenOn()](#setwindowkeepscreenon9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5807,7 +5977,7 @@ setOutsideTouchable(touchable: boolean, callback: AsyncCallback<void>): vo
设置是否允许可点击子窗口之外的区域,使用callback异步回调。
> **说明:**
->
+>
> 该接口不支持使用。从 API version 7开始支持,从API version 9开始废弃。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5838,7 +6008,7 @@ setOutsideTouchable(touchable: boolean): Promise<void>
设置是否允许可点击子窗口之外的区域,使用Promise异步回调。。
> **说明:**
->
+>
> 该接口不支持使用。从 API version 7开始支持,从API version 9开始废弃。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5873,7 +6043,7 @@ setPrivacyMode(isPrivacyMode: boolean, callback: AsyncCallback<void>): voi
设置窗口是否为隐私模式,使用callback异步回调。设置为隐私模式的窗口,窗口内容将无法被截屏或录屏。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowPrivacyMode()](#setwindowprivacymode9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5905,7 +6075,7 @@ setPrivacyMode(isPrivacyMode: boolean): Promise<void>
设置窗口是否为隐私模式,使用Promise异步回调。设置为隐私模式的窗口,窗口内容将无法被截屏或录屏。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowPrivacyMode()](#setwindowprivacymode9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5941,7 +6111,7 @@ setTouchable(isTouchable: boolean, callback: AsyncCallback<void>): void
设置窗口是否为可触状态,使用callback异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowTouchable()](#setwindowtouchable9)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -5973,7 +6143,7 @@ setTouchable(isTouchable: boolean): Promise<void>
设置窗口是否为可触状态,使用Promise异步回调。
> **说明:**
->
+>
> 从 API version 7开始支持,从API version 9开始废弃,推荐使用[setWindowTouchable()](#setwindowtouchable9-1)。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
@@ -6801,7 +6971,7 @@ controller.animationForShown = (context : window.TransitionContext) => {
playMode: PlayMode.Normal, // 动画模式
onFinish: ()=> {
context.completeTransition(true)
- }
+ }
}, () => {
let obj : window.TranslateOptions = {
x : 100.0,
@@ -6847,7 +7017,7 @@ controller.animationForHidden = (context : window.TransitionContext) => {
playMode: PlayMode.Normal, // 动画模式
onFinish: ()=> {
context.completeTransition(true)
- }
+ }
}, () => {
let obj : window.TranslateOptions = {
x : 100.0,