窗口

窗口开发

• 对应用开发者而言，窗口模块提供了界面显示和交互能力。

• 对终端用户而言，窗口模块提供了控制应用界面的方式。

• 对整个操作系统而言，窗口模块提供了不同应用界面的组织管理逻辑。

窗口模块的用途

• 提供应用和系统界面的窗口对象。 应用开发者通过窗口加载UI界面，实现界面显示功能。

• 组织不同窗口的显示关系，即维护不同窗口间的叠加层次和位置属性。 应用和系统的窗口具有多种类型，不同类型的窗口具有不同的默认位置和叠加层次（Z轴高度）。同时，用户操作也可以在一定范围内对窗口的位置和叠加层次进行调整。

• 提供窗口动效。 在窗口显示、隐藏及窗口间切换时，窗口模块通常会添加动画效果，以使各个交互过程更加连贯流畅。在HarmonyOS中，应用窗口的动效为默认行为，不需要开发者进行设置或者修改。

• 指导输入事件分发。 即根据当前窗口的状态或焦点，进行事件的分发。触摸和鼠标事件根据窗口的位置和尺寸进行分发，而键盘事件会被分发至焦点窗口。应用开发者可以通过窗口模块提供的接口设置窗口是否可以触摸和是否可以获焦。

窗口的分类（考点）

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

• 应用窗口：应用窗口区别于系统窗口，指与应用显示相关的窗口。根据显示内容的不同，应用窗口又分为应用主窗口、应用子窗口两种类型。
• 应用主窗口：应用主窗口用于显示应用界面，会在"任务管理界面"显示。
• 应用子窗口：应用子窗口用于显示应用的弹窗、悬浮窗等辅助窗口，不会在"任务管理界面"显示。应用子窗口的生命周期跟随应用主窗口。

管理应用窗口

• 窗口沉浸式能力：指对状态栏、导航栏等系统窗口进行控制，减少状态栏导航栏等系统界面的突兀感，从而使用户获得最佳体验的能力。
沉浸式能力只在应用主窗口作为全屏窗口时生效。通常情况下，应用子窗口（弹窗、悬浮窗口等辅助窗口）无法使用沉浸式能力。

• 悬浮窗：全局悬浮窗口是一种特殊的应用窗口，具备在应用主窗口和对应Ability退至后台后仍然可以在前台显示的能力。
悬浮窗口可以用于应用退至后台后，使用小窗继续播放视频，或者为特定的应用创建悬浮球等快速入口。应用在创建悬浮窗口前，需要申请对应的权限。

应用场景

• 设置应用主窗口属性及目标页面

• 设置应用子窗口属性及目标页面

• 体验窗口沉浸式能力

• 设置悬浮窗

设置应用主窗口

1. 获取应用主窗口。
通过getMainWindow接口获取应用主窗口。

2. 设置主窗口属性。
可设置主窗口的背景色、亮度值、是否可触等多个属性，开发者可根据需要选择对应的接口。本示例以设置“是否可触”属性为例。

3. 为主窗口加载对应的目标页面。
通过loadContent接口加载主窗口的目标页面。

设置应用子窗口

1. 创建应用子窗口。
通过createSubWindow接口创建应用子窗口。

2. 设置子窗口属性。
子窗口创建成功后，可以改变其大小、位置等，还可以根据应用需要设置窗口背景色、亮度等属性。

3. 加载显示子窗口的具体内容。
通过setUIContent和showWindow接口加载显示子窗口的具体内容。

4. 销毁子窗口。
当不再需要某些子窗口时，可根据具体实现逻辑，使用destroyWindow接口销毁子窗口。

体验窗口沉浸式能力（应用主窗口）

1. 获取应用主窗口。
通过getMainWindow接口获取应用主窗口。

2. 实现沉浸式效果。
调用setWindowSystemBarEnable接口，设置导航栏、状态栏不显示，从而达到沉浸式效果。

3. 加载显示沉浸式窗口的具体内容。
通过loadContent接口加载沉浸式窗口的具体内容。

设置悬浮窗（应用子窗口）

1. 创建悬浮窗。
通过window.createWindow接口创建悬浮窗类型的窗口。

2. 对悬浮窗进行属性设置等操作。
悬浮窗窗口创建成功后，可以改变其大小、位置等，还可以根据应用需要设置悬浮窗背景色、亮度等属性。

3. 加载显示悬浮窗的具体内容。
通过setUIContent和showWindow接口加载显示悬浮窗的具体内容。

4. 销毁悬浮窗。
当不再需要悬浮窗时，可根据具体实现逻辑，使用destroyWindow接口销毁悬浮窗。