大网数据广告活动
OpenHarmony 设备与应用开发

窗口开发术语

· 52CE 我爱测

应用窗口区别于系统窗口,指与应用显示相关的窗口,用来显示应用的内容。根据管理方式和用途的不同,应用窗口又可以分为主窗口、辅助窗口两种类型。

窗口开发术语

窗口类型

窗口有系统窗口、应用窗口两种分类。

系统窗口

系统窗口指完成系统特定功能的窗口。如音量条、壁纸、通知栏、状态栏、导航栏等。

系统窗口仅系统应用可用。

应用窗口

应用窗口区别于系统窗口,指与应用显示相关的窗口,用来显示应用的内容。根据管理方式和用途的不同,应用窗口又可以分为主窗口、辅助窗口两种类型。

  • 主窗口

    主窗口由UIAbility创建时默认创建,会在“任务管理界面”中以一个独立的任务卡片显示,用于显示应用UIAbility主界面。

  • 辅助窗口

    辅助窗口由应用自行管理创建和销毁,不会在“任务管理界面”中以一个独立的任务卡片显示,可以用于显示应用的辅助内容,例如弹窗等。

    辅助窗口包括子窗口、全局悬浮窗、模态窗口、画中画、闪控球和标准悬浮窗。其中子窗口分为独立子窗、非独立子窗。

    • 独立子窗:

      从API version 26.0.0开始,支持在创建子窗时设置SubWindowOptions中的zLevelAboveParentLoosened为true,此时创建的子窗称为独立子窗。独立子窗在自由窗口状态下,不跟随主窗前后台的切换,仅跟随主窗一起销毁,独立子窗与主窗可通过点击调整层级。

    • 非独立子窗:

      默认创建的子窗均为非独立子窗。创建子窗时SubWindowOptions中的zLevelAboveParentLoosened默认为false,此时创建的子窗为非独立子窗。

悬浮窗

悬浮窗分为智慧多窗悬浮窗、全局悬浮窗和标准悬浮窗。

  • 智慧多窗悬浮窗是指设备屏幕上悬浮的、非全屏的应用窗口。

    一般用于在已有全屏任务运行的基础上,临时处理另一个任务,或短时间多任务并行使用。如浏览网页的同时回复消息。

    相关参考:智慧多窗简介、智慧多窗最佳实践。

  • 全局悬浮窗是指一种特殊的应用辅助窗口,具备在应用主窗口和对应Ability退至后台后仍然可以在前台显示的能力。

    全局悬浮窗可以用于应用退至后台后,使用小窗继续显示UI,例如音乐应用用于显示桌面歌词等。

    应用在创建全局悬浮窗前,需要申请对应的权限。

    相关参考:设置全局悬浮窗。

自由窗口

自由窗口是一种允许用户在同一屏幕上以自由大小、位置显示的窗口状态。自由窗口支持拖拽、缩放和分屏组合,从而实现多任务处理。

自由窗口按照打开或者获取焦点的顺序在Z轴层叠排布。当自由窗口被点击或触摸时,将导致其Z轴高度提升,并获取焦点。

启动新的自由窗口时,默认以一定间距在上一个窗口的右下方层叠显示。

每个自由窗口默认会在窗口上方显示窗口标题栏,标题栏左侧显示应用图标,右侧显示三键控制按钮(窗口最大化/还原、窗口最小化和关闭窗口),且窗口标题栏支持额外的沉浸式配置。

自由窗口可以通过拖动窗口边缘调节窗口大小,可以通过拖动标题栏移动窗口位置。

[图示请参阅官方原文]

当前设备支持情况:

  • 2in1设备:2in1设备上的窗口,默认为自由窗口。
  • Tablet设备:部分Tablet设备,支持开启自由多窗模式(通过下拉控制中心,点击“自由多窗”按钮开启),开启此模式后,应用窗口默认为自由窗口。
  • Phone设备:部分Phone设备,支持开启自由多窗模式(通过下拉控制中心,点击“自由多窗”按钮开启),开启此模式后,应用窗口默认为自由窗口。

自由多窗模式

自由多窗模式是一种支持用户在移动设备上进行多任务处理的交互方式。

自由多窗下,允许用户在一块屏幕上同时显示多个应用窗口。此时的应用窗口为自由窗口。

部分Tablet设备上,可通过下拉控制中心,点击“自由多窗”按钮开启自由多窗。

部分Phone设备上,可通过下拉控制中心,点击“自由多窗”按钮开启自由多窗。

[图示请参阅官方原文]

电脑模式

电脑模式是一种支持用户在移动设备上进行多任务处理的交互方式。

电脑模式下,允许用户在一块屏幕上同时显示多个应用窗口。此时的应用窗口为自由窗口。

部分Tablet设备上,可通过下拉控制中心,点击“电脑模式”按钮开启电脑模式。

全局坐标系

全局坐标系是指在设备连接扩展屏(多物理屏幕)的场景下,以主屏幕左上角为原点(0, 0),屏幕右侧为x轴正方向,屏幕下侧为y轴正方向,对窗口、指针等对象的位置进行统一描述的坐标体系。

在该坐标系中,所有物理屏幕被映射到同一连续的虚拟坐标空间内,各类窗口操作、坐标转换及窗口矩形变化事件均基于该坐标空间进行计算和回调。

[图示请参阅官方原文]

使用场景:

  • 窗口跨屏移动:调用基于全局坐标系的接口移动窗口,无需传递具体屏幕ID参数,即可实现窗口在多屏之间移动。
  • 窗口位置变化监听:基于全局坐标系监听窗口矩形变化事件,统一获取窗口在多屏环境中的位置与尺寸变化信息。

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。