【鸿蒙南向开发】OpenHarmony窗口子系统基本概念与流程分析

---

📚往期笔录记录🔖：

🔖鸿蒙（HarmonyOS）北向开发知识点记录~
🔖鸿蒙（OpenHarmony）南向开发保姆级知识点汇总~
🔖鸿蒙应用开发与鸿蒙系统开发哪个更有前景？
🔖嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~
🔖对于大前端开发来说，转鸿蒙开发究竟是福还是祸？
🔖鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？
🔖记录一场鸿蒙开发岗位面试经历~
🔖持续更新中……

---

窗口子系统位于 \fundation\windowmanager 目录下，提供对窗口与 Display 管理的基础能力

概览

窗口是什么

每个 Ability 在创建时都会创建一个主窗口，并且为该窗口设置 ACE 中的 UIContent 用于加载展示 UI 界面。基本上所有的 UI 视图都是在窗口中展示的，比如弹窗、toast、系统状态栏导航栏、应用等。因此窗口子系统是系统图形界面显示所需的基础子系统。

窗口的种类

• 主窗口 应用显示的主窗口，即每个 Ability 持有的主窗口
• 子窗口 必须依附于主窗口来创建与显示
• 系统窗口 其他窗口均属于系统窗口

窗口的属性

WindowFlag

flag 指定窗口的部分测量规则：

• WINDOW_FLAG_NEED_AVOID 是否避开区域，默认避开，比如状态栏导航栏区域
• WINDOW_FLAG_PARENT_LIMIT 是否受到父窗口的限制，默认不限制，如果限制，则宽高不能超过父窗口，需与 WINDOW_MODE_FLOATING 配合使用

WindowMode

mode 指定窗口的布局规则：

• WINDOW_MODE_UNDEFINED 默认模式，默认宽高为 display 宽高减去状态栏导航栏等的宽高
• WINDOW_MODE_FULLSCREEN 全屏模式，但需要与 WINDOW_FLAG_NEED_AVOID 一起使用，默认宽高为 display 宽高
• WINDOW_MODE_SPLIT_PRIMARY 分屏主窗口模式，如果是横屏则位于左侧，竖屏位于上方
• WINDOW_MODE_SPLIT_SECONDARY 分屏副窗口模式，如果是横屏则位于右侧，竖屏位于下方
• WINDOW_MODE_FLOATING 悬浮模式，悬浮窗口可以通过窗口边缘改变窗口大小，默认宽高为 display 宽高的 3/4

应用主窗口可以通过启动 ability 时的参数 Want::PARAM_RESV_WINDOW_MODE（ohos.aafwk.param.windowMode）来侧面指定 WindowMode 的值

priority

窗口优先级决定了窗口的层级，priority 越大窗口越靠近顶部。该属性位于 W