HarmonyOS 应用开发之管理应用窗口（FA模型）

最新推荐文章于 2024-08-16 17:37:51 发布

码中之牛

最新推荐文章于 2024-08-16 17:37:51 发布

阅读量1.1k

点赞数 18

分类专栏： Harmony OS OpenHarmony 鸿蒙文章标签： harmonyos 华为鸿蒙开发移动开发前端

本文链接：https://blog.csdn.net/weixin_61845324/article/details/137150435

版权

本文介绍了在HarmonyOS中如何创建和管理应用子窗口，包括设置子窗口属性、体验窗口沉浸式能力，如隐藏状态栏和导航栏，以及通过API进行窗口布局和系统栏控制。还提供了入门鸿蒙开发的学习资源链接。

摘要由CSDN通过智能技术生成

基本概念

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

场景介绍

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

设置应用子窗口属性及目标页面
体验窗口沉浸式能力

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

接口说明

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

设置应用子窗口

开发者可以按需创建应用子窗口，如弹窗等，并对其进行属性设置等操作。

开发步骤

创建/获取子窗口对象。
- 可以通过window.createWindow接口创建子窗口。
- 也可以通过window.findWindow接口来查找已经创建的窗口从而得到子窗口。

import window from '@ohos.window';
import { BusinessError } from '@ohos.base';

let windowClass: window.Window | null = null;
// 方式一：创建子窗口。
let config: window.Configuration = { name: "subWindow", windowType: window.WindowType.TYPE_APP };
window.createWindow(config, (err: BusinessError, data) => {
  let errCode: number = err.code;
  if (errCode) {
    console.error('Failed to create the subWindow. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in creating subWindow. Data: ' + JSON.stringify(data));
  windowClass = data;
});
// 方式二：查找得到子窗口。
try {
  windowClass = window.findWindow('subWindow');
} catch (exception) {
  console.error('Failed to find the Window. Cause: ' + JSON.stringify(exception));
}

设置子窗口属性。

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

// 移动子窗口位置。
let windowClass: window.Window = window.findWindow("test");
windowClass.moveWindowTo(300, 300, (err: BusinessError) => {
  let errCode: number = err.code;
  if (errCode) {
    console.error('Failed to move the window. Cause:' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in