HarmonyOS Next开发学习手册——管理应用窗口（FA模型）

最新推荐文章于 2024-09-30 15:46:13 发布

原创

最新推荐文章于 2024-09-30 15:46:13 发布 · 946 阅读

CC 4.0 BY-SA版权

文章标签：

窗口沉浸式能力：指对状态栏、导航栏等系统窗口进行控制，减少状态栏导航栏等系统界面的突兀感，从而使用户获得最佳体验的能力。

沉浸式能力只在应用主窗口作为全屏窗口时生效。通常情况下，应用子窗口（弹窗、悬浮窗口等辅助窗口）和处于自由窗口下的应用主窗口无法使用沉浸式能力。

说明：
当前沉浸式界面开发仅支持window级别的配置，暂不支持Page级别的配置。若有Page级别切换的需要，可以在页面生命周期开始，例如onPageShow中设置沉浸模式，然后在页面退出，例如onPageHide中恢复默认设置来实现。

在FA模型下，管理应用窗口的典型场景有：

以下分别介绍具体开发方式。

上述场景涉及的常用接口如下表所示。

实例名	接口名	描述
window静态方法	createWindow(config: Configuration, callback: AsyncCallback): void	创建子窗口。 -config：创建窗口时的参数。
window静态方法	findWindow(name: string): Window	查找name所对应的窗口。
Window	setUIContent(path: string, callback: AsyncCallback): void	根据当前工程中某个页面的路径为窗口加载具体的页面内容。其中path为要加载到窗口中的页面内容的路径，在FA模型下该路径需添加到工程的config.json文件中。
Window	moveWindowTo(x: number, y: number, callback: AsyncCallback): void	移动当前窗口。
Window	setWindowBrightness(brightness: number, callback: AsyncCallback): void	设置屏幕亮度值。
Window	resize(width: number, height: number, callback: AsyncCallback): void	改变当前窗口大小。
Window	setWindowLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback): void	设置窗口布局是否为全屏布局。
Window	setWindowSystemBarEnable(names: Array<‘status’	‘navigation’>): Promise
Window	setWindowSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback): void	设置窗口内导航栏、状态栏属性。 systemBarProperties：导航栏、状态栏的属性集合。
Window	showWindow(callback: AsyncCallback): void	显示当前窗口。
Window	on(type: ‘touchOutside’, callback: Callback): void	开启本窗口区域外的点击事件的监听。