openharmony 鸿蒙 arkts-apis-window-e

2025-06-12 浏览 (1)

Enums

说明：

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

WindowType7+

窗口类型枚举。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称值说明
TYPE_APP0表示应用子窗口。
模型约束： 此接口仅可在FA模型下使用。
TYPE_SYSTEM_ALERT1表示系统告警窗口。
- 说明： 从API version 11开始废弃。
- 从API version 7开始支持。
TYPE_FLOAT9+8表示悬浮窗。
模型约束： 此接口仅可在Stage模型下使用。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
TYPE_DIALOG10+16表示模态窗口。
模型约束： 此接口仅可在Stage模型下使用。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
TYPE_MAIN18+32表示应用主窗口。
此窗口类型不支持在创建窗口时使用，仅可在getWindowProperties接口的返回值中用于读取。

AvoidAreaType7+

窗口内容需要规避区域的类型枚举。

系统能力： SystemCapability.WindowManager.WindowManager.Core

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

名称值说明
TYPE_SYSTEM0表示系统默认区域。包含状态栏和三键导航栏区域。
TYPE_CUTOUT1表示刘海屏区域。
TYPE_SYSTEM_GESTURE9+2表示手势区域。当前，各设备均无此类型避让区域。
TYPE_KEYBOARD9+3表示软键盘区域。
TYPE_NAVIGATION_INDICATOR11+4表示底部导航区域。OpenHarmony各设备不支持此能力。

Orientation9+

窗口显示方向类型枚举。

名称值说明
UNSPECIFIED0表示未定义方向模式，由系统判定。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
PORTRAIT1表示竖屏显示模式。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
LANDSCAPE2表示横屏显示模式。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
PORTRAIT_INVERTED3表示反向竖屏显示模式。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
LANDSCAPE_INVERTED4表示反向横屏显示模式。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
AUTO_ROTATION5跟随传感器自动旋转，可以旋转到竖屏、横屏、反向竖屏、反向横屏四个方向。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
AUTO_ROTATION_PORTRAIT6跟随传感器自动竖向旋转，可以旋转到竖屏、反向竖屏，无法旋转到横屏、反向横屏。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
AUTO_ROTATION_LANDSCAPE7跟随传感器自动横向旋转，可以旋转到横屏、反向横屏，无法旋转到竖屏、反向竖屏。
系统能力： SystemCapability.WindowManager.WindowManager.Core。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
AUTO_ROTATION_RESTRICTED8跟随传感器自动旋转，可以旋转到竖屏、横屏、反向竖屏、反向横屏四个方向，且受控制中心的旋转开关控制。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
AUTO_ROTATION_PORTRAIT_RESTRICTED9跟随传感器自动竖向旋转，可以旋转到竖屏、反向竖屏，无法旋转到横屏、反向横屏，且受控制中心的旋转开关控制。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
AUTO_ROTATION_LANDSCAPE_RESTRICTED10跟随传感器自动横向旋转，可以旋转到横屏、反向横屏，无法旋转到竖屏、反向竖屏，且受控制中心的旋转开关控制。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
LOCKED11表示锁定模式。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
AUTO_ROTATION_UNSPECIFIED12+12跟随传感器自动旋转，受控制中心的旋转开关控制，且可旋转方向受系统判定（如在某种设备，可以旋转到竖屏、横屏、反向横屏三个方向，无法旋转到反向竖屏）。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.Window.SessionManager
USER_ROTATION_PORTRAIT12+13调用时临时旋转到竖屏，之后跟随传感器自动旋转，受控制中心的旋转开关控制，且可旋转方向受系统判定。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.Window.SessionManager
USER_ROTATION_LANDSCAPE12+14调用时临时旋转到横屏，之后跟随传感器自动旋转，受控制中心的旋转开关控制，且可旋转方向受系统判定。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.Window.SessionManager
USER_ROTATION_PORTRAIT_INVERTED12+15调用时临时旋转到反向竖屏，之后跟随传感器自动旋转，受控制中心的旋转开关控制，且可旋转方向受系统判定。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.Window.SessionManager
USER_ROTATION_LANDSCAPE_INVERTED12+16调用时临时旋转到反向横屏，之后跟随传感器自动旋转，受控制中心的旋转开关控制，且可旋转方向受系统判定。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.Window.SessionManager
FOLLOW_DESKTOP12+17表示跟随桌面的旋转模式。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.Window.SessionManager

RectChangeReason12+

窗口矩形（窗口位置及窗口大小）变化的原因。

系统能力： SystemCapability.Window.SessionManager

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

名称值说明
UNDEFINED0默认值。
MAXIMIZE1窗口最大化。
RECOVER2窗口恢复到上一次的状态。
MOVE3窗口拖拽移动。
DRAG4窗口拖拽缩放。
DRAG_START5窗口开始拖拽缩放。
DRAG_END6窗口结束拖拽缩放。

ColorSpace8+

色域模式。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称值说明
DEFAULT0默认SRGB色域模式。
WIDE_GAMUT1广色域模式。

WindowEventType10+

窗口生命周期。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

名称值说明
WINDOW_SHOWN1切到前台。
系统能力： SystemCapability.WindowManager.WindowManager.Core
WINDOW_ACTIVE2获焦状态。
系统能力： SystemCapability.WindowManager.WindowManager.Core
WINDOW_INACTIVE3失焦状态。
系统能力： SystemCapability.WindowManager.WindowManager.Core
WINDOW_HIDDEN4切到后台。
系统能力： SystemCapability.WindowManager.WindowManager.Core
WINDOW_DESTROYED11+7窗口销毁。
系统能力： SystemCapability.Window.SessionManager

WindowStatusType11+

窗口模式枚举。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Window.SessionManager

名称值说明
UNDEFINED0表示APP未定义窗口模式。
FULL_SCREEN1表示APP全屏模式。
MAXIMIZE2表示APP窗口最大化模式。
MINIMIZE3表示APP窗口最小化模式。
FLOATING4表示APP自由悬浮形式窗口模式。
SPLIT_SCREEN5表示APP分屏模式。

MaximizePresentation12+

窗口最大化时的布局枚举。

系统能力： SystemCapability.Window.SessionManager

名称值说明
FOLLOW_APP_IMMERSIVE_SETTING0最大化时，跟随应用app当前设置的沉浸式布局。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
EXIT_IMMERSIVE1最大化时，如果当前窗口设置了沉浸式布局会退出沉浸式布局。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
ENTER_IMMERSIVE2最大化时，进入沉浸式布局，鼠标Hover在热区上显示窗口标题栏和dock栏。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
ENTER_IMMERSIVE_DISABLE_TITLE_AND_DOCK_HOVER14+3最大化时，进入沉浸式布局，鼠标Hover在热区上不显示窗口标题栏和dock栏。
原子化服务API： 从API version 14开始，该接口支持在原子化服务中使用。

WindowAnimationCurve20+

窗口动画曲线类型。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Window.SessionManager

名称值说明
LINEAR0表示动画从头到尾的速度都是相同的。
使用该曲线类型时WindowAnimationConfig中duration必填。
使用该曲线类型时WindowAnimationConfig中param选填，且不生效。
INTERPOLATION_SPRING1表示插值器弹簧曲线，一条从0到1的动画曲线，实际动画值根据曲线进行插值计算。动画时间由曲线参数决定，不受WindowAnimationConfig中的duration参数控制。
使用该曲线类型时WindowAnimationConfig中duration选填，且不生效。
使用该曲线类型时WindowAnimationConfig中param必填。

WindowTransitionType20+

窗口转场动画类型枚举。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Window.SessionManager

名称值说明
DESTROY0表示窗口销毁时的转场动画。

WindowAnchor20+

窗口锚点枚举。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Window.SessionManager

名称值说明
TOP_START0窗口左上角。
TOP1窗口上边界横向居中点。
TOP_END2窗口右上角。
START3窗口左边界纵向居中点。
CENTER4窗口横向和纵向居中点。
END5窗口右边界纵向居中点。
BOTTOM_START6窗口左下角。
BOTTOM7窗口下边界横向居中点。
BOTTOM_END8窗口右下角。

RotationChangeType19+

窗口旋转事件类型。

原子化服务API： 从API version 19开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Window.SessionManager

名称值说明
WINDOW_WILL_ROTATE0窗口即将旋转。
WINDOW_DID_ROTATE1窗口旋转结束。

RectType19+

窗口矩形区域坐标系类型。

原子化服务API： 从API version 19开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Window.SessionManager

名称值说明
RELATIVE_TO_SCREEN0窗口矩形区域相对于屏幕坐标系。
RELATIVE_TO_PARENT_WINDOW1窗口矩形区域相对于父窗口坐标系。

GlobalWindowMode20+

窗口模式。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Window.SessionManager

名称值说明
FULLSCREEN1全屏窗口。
SPLIT1 << 1分屏窗口。
FLOAT1 << 2悬浮窗。
PIP1 << 3画中画。

WindowStageEventType9+

WindowStage生命周期。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

名称值说明
SHOWN1切到前台，例如点击应用图标启动，无论是首次启动还是从后台启动均会触发。
ACTIVE2获焦状态，例如应用窗口处理点击事件后的状态、应用启动后的状态。
INACTIVE3失焦状态，例如打开新应用或点击其他窗口后，原获焦窗口的状态。
HIDDEN4切到后台，例如应用上滑退出、应用窗口关闭。
RESUMED11+5前台可交互状态，例如应用打开后，可以与用户交互的状态。
PAUSED11+6前台不可交互状态，例如从屏幕底部上划，应用进入到多任务界面后的状态。

ModalityType14+

子窗口模态类型枚举。

系统能力： SystemCapability.Window.SessionManager

原子化服务API： 从API version 14开始，该接口支持在原子化服务中使用。

名称值说明
WINDOW_MODALITY0模态子窗类型为模窗口子窗，当仅需要其父级窗口不响应用户操作时，可选此参数。
APPLICATION_MODALITY1模态子窗类型为模应用子窗，除其父级窗口外还需要该应用其他实例的窗口不响应用户操作时，可选此参数。
此接口仅支持在2in1设备下使用。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkUI（方舟UI框架）

harmony 鸿蒙ARKUI_TextPickerCascadeRangeContent

harmony 鸿蒙ARKUI_TextPickerRangeContent

harmony 鸿蒙ArkUI_AnimateCompleteCallback

harmony 鸿蒙ArkUI_AttributeItem

harmony 鸿蒙ArkUI_ColorStop

harmony 鸿蒙ArkUI_ContextCallback

harmony 鸿蒙ArkUI_EventModule

harmony 鸿蒙ArkUI_ExpectedFrameRateRange

harmony 鸿蒙ArkUI_IntOffset

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/VRnNGu