HarmonyOS 鸿蒙Next开发设置窗口的背景颜色

HarmonyOS 鸿蒙Next开发设置窗口的背景颜色

import { common } from '@kit.AbilityKit'; // 导入AbilityKit的common模块

export class AppUtil {
  private static windowStage: window.WindowStage; // 静态变量，用于存储窗口管理器
  private static context: common.UIAbilityContext; // 静态变量，用于存储UIAbility的上下文信息

  /**
   * 初始化方法，缓存全局变量，在UIAbility的onWindowStageCreate方法中调用该方法进行初始化。
   * Initialization method, caches global variables, call this method in the onWindowStageCreate method of UIAbility for initialization.
   * @param context 上下文
   * @param windowStage 窗口管理器
   */
  static init(context: common.UIAbilityContext, windowStage: window.WindowStage) {
    AppUtil.context = context; // 初始化上下文
    AppUtil.windowStage = windowStage; // 初始化窗口管理器
  }

  /**
   * 获取主窗口
   * Get the main window
   */
  static getMainWindow(): window.Window {
    if (!AppUtil.windowStage) { // 如果窗口管理器未初始化
      console.error("windowStage为空，请在UIAbility的onWindowStageCreate方法中调用AppUtil的init方法进行初始化！WindowStage is null, please call the init method of AppUtil in the onWindowStageCreate method of UIAbility for initialization!");
    }
    return AppUtil.windowStage.getMainWindowSync(); // 同步获取主窗口
  }

  /**
   * 获取UIContext
   * @returns
   */
  static getUIContext(): UIContext {
    return AppUtil.getMainWindow().getUIContext();
  }
  
  /**
   * 设置窗口的背景颜色。此方法在Stage模型下使用，需要在loadContent()或setUIContent()方法调用之后才会生效。
   *
   * @param color 需要设置的背景颜色，格式为十六进制RGB或ARGB颜色代码，例如"#00FF00"或"#FF00FF00"，大小写不敏感。
   * @param windowClass 可选参数，指定要设置背景颜色的具体窗口实例。如果不提供，则默认使用主窗口。
   *
   * @returns 返回一个Promise对象，表示异步操作的完成状态。
   */
  static async setWindowBackgroundColor(color: string, windowClass?: window.Window) {
    try {
      // 如果没有提供具体的窗口实例，则使用主窗口
      if (!windowClass) {
        windowClass = AppUtil.getMainWindow();
      }
      // 设置窗口的背景颜色，并返回一个Promise对象
      return windowClass.setWindowBackgroundColor(color);
    } catch (err) {
      // 如果设置过程中发生错误，记录错误信息
      console.error(JSON.stringify(err));
      // 返回一个空的Promise对象，表示操作完成
      return;
    }
  }
}