diff --git a/zh-cn/application-dev/reference/apis-arkui/arkts-apis-window-i.md b/zh-cn/application-dev/reference/apis-arkui/arkts-apis-window-i.md index 331fddb1e9dd7667ee56de06eebff8c5eda1fba3..a89ed60fe59d7ebb49034dda8f5146bd7a3404d1 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkts-apis-window-i.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkts-apis-window-i.md @@ -144,26 +144,25 @@ 窗口属性。 -**系统能力:** SystemCapability.WindowManager.WindowManager.Core - | 名称 | 类型 | 只读 | 可选 | 说明 | | ------------------------------------- | ------------------------- | ---- | ---- |--------------------------------------------------------------------------------------------------------| -| windowRect7+ | [Rect](arkts-apis-window-i.md#rect7) | 否 | 否 | 窗口尺寸,可在页面生命周期[onPageShow](./arkui-ts/ts-custom-component-lifecycle.md#onpageshow)或应用生命周期[onForeground](../apis-ability-kit/js-apis-app-ability-uiAbility.md#onforeground)阶段获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| drawableRect11+ | [Rect](arkts-apis-window-i.md#rect7) | 否 | 否 | 窗口内的可绘制区域尺寸,其中左边界上边界是相对于窗口计算。在Stage模型下,需要在调用[loadContent()](arkts-apis-window-Window.md#loadcontent9)或[setUIContent()](arkts-apis-window-Window.md#setuicontent9)加载页面内容后使用该接口。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| type7+ | [WindowType](arkts-apis-window-e.md#windowtype7) | 否 | 否 | 窗口类型。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| isFullScreen | boolean | 否 | 否 | 是否全屏,默认为false。true表示全屏;false表示非全屏。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| isLayoutFullScreen7+ | boolean | 否 | 否 | 窗口是否为沉浸式且处于全屏模式(不在悬浮窗、分屏等场景下),默认为false。true表示沉浸式且处于全屏模式;false表示非沉浸式或非全屏模式。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| focusable7+ | boolean | 是 | 否 | 窗口是否可聚焦,默认为true。true表示可聚焦;false表示不可聚焦。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| touchable7+ | boolean | 是 | 否 | 窗口是否可触摸,默认为true。true表示可触摸;false表示不可触摸。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| brightness | number | 否 | 否 | 屏幕亮度。该参数为浮点数,可设置的亮度范围为[0.0, 1.0],其取1.0时表示最大亮度值。如果窗口没有设置亮度值,表示亮度跟随系统,此时获取到的亮度值为-1。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| dimBehindValue(deprecated) | number | 否 | 否 | 靠后窗口的暗度值。该参数为浮点数,取值范围为[0.0, 1.0],其取1.0表示最暗。
- **说明:** 从API version 9开始废弃。
- 从API version 7开始支持。当前无可替代接口。| -| isKeepScreenOn | boolean | 否 | 否 | 屏幕是否常亮,默认为false。true表示常亮;false表示不常亮。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| isPrivacyMode7+ | boolean | 否 | 否 | 隐私模式,默认为false。true表示模式开启;false表示模式关闭。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| isRoundCorner(deprecated) | boolean | 否 | 否 | 窗口是否为圆角。默认为false。true表示圆角;false表示非圆角。
- **说明:** 从API version 9开始废弃。
- 从API version 7开始支持。当前无可替代接口。| -| isTransparent7+ | boolean | 否 | 否 | 窗口背景是否透明。默认为false。true表示透明;false表示不透明。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| id9+ | number | 是 | 否 | 窗口ID,默认值为0,该参数应为整数。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| displayId12+ | number | 是 | 是 | 窗口所在屏幕ID,默认返回主屏幕ID,该参数应为整数。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| name18+ | string | 是 | 是 | 窗口名字,默认为空字符串。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 | +| windowRect7+ | [Rect](arkts-apis-window-i.md#rect7) | 否 | 否 | 窗口尺寸,可在页面生命周期[onPageShow](./arkui-ts/ts-custom-component-lifecycle.md#onpageshow)或应用生命周期[onForeground](../apis-ability-kit/js-apis-app-ability-uiAbility.md#onforeground)阶段获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| drawableRect11+ | [Rect](arkts-apis-window-i.md#rect7) | 否 | 否 | 窗口内的可绘制区域尺寸,其中左边界上边界是相对于窗口计算。在Stage模型下,需要在调用[loadContent()](arkts-apis-window-Window.md#loadcontent9)或[setUIContent()](arkts-apis-window-Window.md#setuicontent9)加载页面内容后使用该接口。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| type7+ | [WindowType](arkts-apis-window-e.md#windowtype7) | 否 | 否 | 窗口类型。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| isFullScreen | boolean | 否 | 否 | 是否全屏,默认为false。true表示全屏;false表示非全屏。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| isLayoutFullScreen7+ | boolean | 否 | 否 | 窗口是否为沉浸式且处于全屏模式(不在悬浮窗、分屏等场景下),默认为false。true表示沉浸式且处于全屏模式;false表示非沉浸式或非全屏模式。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| focusable7+ | boolean | 是 | 否 | 窗口是否可聚焦,默认为true。true表示可聚焦;false表示不可聚焦。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| touchable7+ | boolean | 是 | 否 | 窗口是否可触摸,默认为true。true表示可触摸;false表示不可触摸。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| brightness | number | 否 | 否 | 屏幕亮度。该参数为浮点数,可设置的亮度范围为[0.0, 1.0],其取1.0时表示最大亮度值。如果窗口没有设置亮度值,表示亮度跟随系统,此时获取到的亮度值为-1。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| dimBehindValue(deprecated) | number | 否 | 否 | 靠后窗口的暗度值。该参数为浮点数,取值范围为[0.0, 1.0],其取1.0表示最暗。
- **说明:** 从API version 9开始废弃。
- 从API version 7开始支持。当前无可替代接口。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| isKeepScreenOn | boolean | 否 | 否 | 屏幕是否常亮,默认为false。true表示常亮;false表示不常亮。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| isPrivacyMode7+ | boolean | 否 | 否 | 隐私模式,默认为false。true表示模式开启;false表示模式关闭。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| isRoundCorner(deprecated) | boolean | 否 | 否 | 窗口是否为圆角。默认为false。true表示圆角;false表示非圆角。
- **说明:** 从API version 9开始废弃。
- 从API version 7开始支持。当前无可替代接口。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| isTransparent7+ | boolean | 否 | 否 | 窗口背景是否透明。默认为false。true表示透明;false表示不透明。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| id9+ | number | 是 | 否 | 窗口ID,默认值为0,该参数应为整数。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| displayId12+ | number | 是 | 是 | 窗口所在屏幕ID,默认返回主屏幕ID,该参数应为整数。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| name18+ | string | 是 | 是 | 窗口名字,默认为空字符串。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core| +| globalDisplayRect20+ | [Rect](arkts-apis-window-i.md#rect7) | 是 | 是 | 全局坐标系下的窗口尺寸。拓展屏场景下以主屏左上角为坐标原点,虚拟屏场景下以所在屏幕组中的主屏左上角为坐标原点。默认值:[0, 0, 0, 0]。
**系统能力:** SystemCapability.Window.SessionManager | ## DecorButtonStyle14+ @@ -303,6 +302,7 @@ | windowId | number | 是 | 否 | 窗口ID。 | | windowStatusType | [WindowStatusType](arkts-apis-window-e.md#windowstatustype11) | 是 | 否 | 窗口模式枚举。 | | isFocused | boolean | 是 | 是 | 窗口是否获焦。true表示窗口获焦;false表示窗口未获焦。 | +| globalDisplayRect20+ | [Rect](arkts-apis-window-i.md#rect7) | 是 | 是 | 全局坐标系下的窗口尺寸。拓展屏场景下以主屏左上角为坐标原点,虚拟屏场景下以所在屏幕组中的主屏左上角为坐标原点。默认值:[0, 0, 0, 0]。| ## TransitionAnimation20+