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,