在鸿蒙（HarmonyOS）开发中，setWindowSystemBarEnable 和 setWindowSystemBarEnable 是与窗口显示模式密切相关的两个核心方法，但它们的 设计目标 和 实际效果 有本质区别。以下是两者的详细对比：

一、核心区别对比

二、视觉差异示意图

1. 仅隐藏系统栏（setWindowSystemBarEnable）

+----------------------------+
|          Status Bar        |  <- 隐藏状态栏
+----------------------------+
|                            |
|                            |
|        应用内容区域          |  <- 区域高度为屏幕高度 - 导航栏高度
|                            |
|                            |
+----------------------------+
|        Navigation Bar      |  <- 隐藏导航栏
+----------------------------+

2. 全屏模式（setWindowLayoutFullScreen）

+----------------------------+
|                            |
|                            |
|                            |
|        应用内容区域          |  <- 区域高度=屏幕高度
|                            |
|                            |
|                            |
+----------------------------+

三、典型场景代码示例

场景1：短视频播放页（需临时隐藏导航栏）

// 仅隐藏底部导航栏，保持状态栏可见
window.getLastWindow().then((win) => {
  win.setWindowSystemBarEnable(['navigation'], false); // 隐藏导航栏
  win.setWindowLayoutFullScreen(false); // 不启用全屏布局
});

场景2：全屏游戏界面

window.getLastWindow().then((win) => {
  win.setWindowSystemBarEnable(['status', 'navigation'], false); // 隐藏所有系统栏
  win.setWindowLayoutFullScreen(true); // 启用全屏布局
});

四、关联使用技巧

1. 组合使用实现完美全屏

// 步骤1：隐藏系统栏
window.setWindowSystemBarEnable(['status', 'navigation'], false);

// 步骤2：启用全屏布局（内容区域扩展至屏幕边缘）
window.setWindowLayoutFullScreen(true);

// 步骤3：防止系统栏意外弹出
window.on('windowSizeChange', (size) => {
  // 全屏状态下强制隐藏系统栏
  if (size.width === screenWidth && size.height === screenHeight) {
    window.setWindowSystemBarEnable(['status', 'navigation'], false);
  }
});

2. 恢复默认状态

window.setWindowLayoutFullScreen(false); // 退出全屏布局
window.setWindowSystemBarEnable(['status', 'navigation'], true); // 显示系统栏

五、常见问题

1. 为何全屏后触摸区域错位？

• 原因：未正确处理全屏后的安全区域（如刘海屏、曲面屏）
• 解决方案：

  // 获取安全区域信息
  import { display } from '@kit.ArkUI';
  const displayInfo = display.getDefaultDisplay().getCutoutInfo();
  const safeArea = displayInfo.safeArea; // { left, top, right, bottom }
  
  // 在布局中避开安全区域
  Column() {
    // 顶部安全区
    Blank().height(safeArea.top) 
    
    // 主内容
    Scroll() 
      .margin({ bottom: safeArea.bottom })
  }
  

2. 系统栏隐藏后如何实现手势操作？

// 监听边缘手势（需API 9+）
import { gesture } from '@kit.ArkUI';

gesture.createGestureHandler(gesture.GestureType.PAN, {
  direction: gesture.PanDirection.UP, // 上滑手势
  distance: 50 // 触发距离
}).onAction(() => {
  // 显示系统栏
  window.setWindowSystemBarEnable(['navigation'], true);
});

通过理解这两个方法的区别，您可以更精准地控制鸿蒙应用的窗口显示效果！