harmony 鸿蒙Enums

  • 2025-06-12
  • 浏览 (4)

Enums

说明：

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

WindowType7+

窗口类型枚举。

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

名称 值 说明
TYPE_APP 0 表示应用子窗口。
模型约束： 此接口仅可在FA模型下使用。
TYPE_SYSTEM_ALERT 1 表示系统告警窗口。
- 说明： 从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_SYSTEM 0 表示系统默认区域。包含状态栏和三键导航栏区域。
TYPE_CUTOUT 1 表示刘海屏区域。
TYPE_SYSTEM_GESTURE9+ 2 表示手势区域。当前，各设备均无此类型避让区域。
TYPE_KEYBOARD9+ 3 表示软键盘区域。
TYPE_NAVIGATION_INDICATOR11+ 4 表示底部导航区域。OpenHarmony各设备不支持此能力。

Orientation9+

窗口显示方向类型枚举。

名称 值 说明
UNSPECIFIED 0 表示未定义方向模式，由系统判定。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
PORTRAIT 1 表示竖屏显示模式。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
LANDSCAPE 2 表示横屏显示模式。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
PORTRAIT_INVERTED 3 表示反向竖屏显示模式。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
LANDSCAPE_INVERTED 4 表示反向横屏显示模式。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
AUTO_ROTATION 5 跟随传感器自动旋转，可以旋转到竖屏、横屏、反向竖屏、反向横屏四个方向。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
AUTO_ROTATION_PORTRAIT 6 跟随传感器自动竖向旋转，可以旋转到竖屏、反向竖屏，无法旋转到横屏、反向横屏。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
AUTO_ROTATION_LANDSCAPE 7 跟随传感器自动横向旋转，可以旋转到横屏、反向横屏，无法旋转到竖屏、反向竖屏。
系统能力： SystemCapability.WindowManager.WindowManager.Core。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
AUTO_ROTATION_RESTRICTED 8 跟随传感器自动旋转，可以旋转到竖屏、横屏、反向竖屏、反向横屏四个方向，且受控制中心的旋转开关控制。
系统能力： SystemCapability.WindowManager.WindowManager.Core
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
AUTO_ROTATION_PORTRAIT_RESTRICTED 9 跟随传感器自动竖向旋转，可以旋转到竖屏、反向竖屏，无法旋转到横屏、反向横屏，且受控制中心的旋转开关控制。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
AUTO_ROTATION_LANDSCAPE_RESTRICTED 10 跟随传感器自动横向旋转，可以旋转到横屏、反向横屏，无法旋转到竖屏、反向竖屏，且受控制中心的旋转开关控制。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
系统能力： SystemCapability.WindowManager.WindowManager.Core
LOCKED 11 表示锁定模式。
原子化服务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开始，该接口支持在原子化服务中使用。

名称 值 说明
UNDEFINED 0 默认值。
MAXIMIZE 1 窗口最大化。
RECOVER 2 窗口恢复到上一次的状态。
MOVE 3 窗口拖拽移动。
DRAG 4 窗口拖拽缩放。
DRAG_START 5 窗口开始拖拽缩放。
DRAG_END 6 窗口结束拖拽缩放。

ColorSpace8+

色域模式。

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

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

名称 值 说明
DEFAULT 0 默认SRGB色域模式。
WIDE_GAMUT 1 广色域模式。

WindowEventType10+

窗口生命周期。

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

名称 值 说明
WINDOW_SHOWN 1 切到前台。
系统能力： SystemCapability.WindowManager.WindowManager.Core
WINDOW_ACTIVE 2 获焦状态。
系统能力： SystemCapability.WindowManager.WindowManager.Core
WINDOW_INACTIVE 3 失焦状态。
系统能力： SystemCapability.WindowManager.WindowManager.Core
WINDOW_HIDDEN 4 切到后台。
系统能力： SystemCapability.WindowManager.WindowManager.Core
WINDOW_DESTROYED11+ 7 窗口销毁。
系统能力： SystemCapability.Window.SessionManager

WindowStatusType11+

窗口模式枚举。

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

系统能力： SystemCapability.Window.SessionManager

名称 值 说明
UNDEFINED 0 表示APP未定义窗口模式。
FULL_SCREEN 1 表示APP全屏模式。
MAXIMIZE 2 表示APP窗口最大化模式。
MINIMIZE 3 表示APP窗口最小化模式。
FLOATING 4 表示APP自由悬浮形式窗口模式。
SPLIT_SCREEN 5 表示APP分屏模式。

MaximizePresentation12+

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

系统能力： SystemCapability.Window.SessionManager

名称 值 说明
FOLLOW_APP_IMMERSIVE_SETTING 0 最大化时，跟随应用app当前设置的沉浸式布局。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
EXIT_IMMERSIVE 1 最大化时，如果当前窗口设置了沉浸式布局会退出沉浸式布局。
原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
ENTER_IMMERSIVE 2 最大化时，进入沉浸式布局，鼠标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

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

WindowTransitionType20+

窗口转场动画类型枚举。

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

系统能力： SystemCapability.Window.SessionManager

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

WindowAnchor20+

窗口锚点枚举。

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

系统能力： SystemCapability.Window.SessionManager

名称 值 说明
TOP_START 0 窗口左上角。
TOP 1 窗口上边界横向居中点。
TOP_END 2 窗口右上角。
START 3 窗口左边界纵向居中点。
CENTER 4 窗口横向和纵向居中点。
END 5 窗口右边界纵向居中点。
BOTTOM_START 6 窗口左下角。
BOTTOM 7 窗口下边界横向居中点。
BOTTOM_END 8 窗口右下角。

RotationChangeType19+

窗口旋转事件类型。

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

系统能力： SystemCapability.Window.SessionManager

名称 值 说明
WINDOW_WILL_ROTATE 0 窗口即将旋转。
WINDOW_DID_ROTATE 1 窗口旋转结束。

RectType19+

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

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

系统能力： SystemCapability.Window.SessionManager

名称 值 说明
RELATIVE_TO_SCREEN 0 窗口矩形区域相对于屏幕坐标系。
RELATIVE_TO_PARENT_WINDOW 1 窗口矩形区域相对于父窗口坐标系。

GlobalWindowMode20+

窗口模式。

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

系统能力： SystemCapability.Window.SessionManager

名称 值 说明
FULLSCREEN 1 全屏窗口。
SPLIT 1 << 1 分屏窗口。
FLOAT 1 << 2 悬浮窗。
PIP 1 << 3 画中画。

WindowStageEventType9+

WindowStage生命周期。

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

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

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

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

ModalityType14+

子窗口模态类型枚举。

系统能力： SystemCapability.Window.SessionManager

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

名称 值 说明
WINDOW_MODALITY 0 模态子窗类型为模窗口子窗，当仅需要其父级窗口不响应用户操作时，可选此参数。
APPLICATION_MODALITY 1 模态子窗类型为模应用子窗，除其父级窗口外还需要该应用其他实例的窗口不响应用户操作时，可选此参数。
此接口仅支持在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

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/VRnNGu
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录