带自定义TitleBar的MAUI应用全屏时顶部存在像素级空白问题

我基于.NET 9.0开发了带自定义TitleBar的MAUI应用，实现参考自微软官方的TitleBar文档。遇到的问题是：Windows 11系统屏幕缩放设为100%时，应用全屏状态下自定义TitleBar顶部会出现一块空白区域，且该问题不受屏幕分辨率影响（应用顶部空白截图：自定义TitleBar上方存在一条横向空白带）。已在微软官网及GitHub搜索但未找到相关解决方案。

针对该问题，可尝试以下几种修复方式：

• 修正布局边距与对齐方式
  检查自定义TitleBar的XAML布局，移除多余的顶部边距，确保控件紧贴窗口顶部：

  <ContentView x:Name="CustomTitleBar" Margin="0" VerticalOptions="Start" HorizontalOptions="Fill">
      <!-- 自定义TitleBar内容 -->
  </ContentView>
  

• Windows平台全屏状态下调整窗口Insets
  在Windows平台代码中，监听窗口全屏状态，手动调整自定义TitleBar的位置以匹配窗口客户端区域。在Platforms/Windows/App.xaml.cs中添加逻辑：

  protected override void OnLaunched(LaunchActivatedEventArgs args)
  {
      base.OnLaunched(args);
  
      if (Application.Windows.FirstOrDefault()?.Handler?.PlatformView is Microsoft.UI.Xaml.Window window)
      {
          window.Activated += (sender, e) =>
          {
              if (window.AppWindow.Presenter is Microsoft.UI.Windowing.OverlappedPresenter presenter && presenter.IsFullScreen)
              {
                  window.ExtendsContentIntoTitleBar = true;
                  var insets = window.AppWindow.TitleBar.ClientAreaInsets;
                  // 调整自定义TitleBar的顶部边距以抵消系统Insets
                  if (CustomTitleBar != null)
                  {
                      CustomTitleBar.Margin = new Thickness(0, insets.Top, 0, 0);
                  }
              }
          };
      }
  }
  

• 动态匹配系统TitleBar高度
  获取系统TitleBar的默认高度，将自定义TitleBar的高度设置为一致，避免因高度差异导致的空白：

  if (window.AppWindow.TitleBar is var titleBar)
  {
      CustomTitleBar.HeightRequest = titleBar.Height;
  }
  

• 确认全屏模式启用方式
  使用MAUI官方API启用全屏，避免自定义全屏逻辑导致的布局异常：

  Application.Current.Windows[0].WindowState = WindowState.FullScreen;
  

若以上方法无效，建议在MAUI官方GitHub仓库提交问题报告，附上自定义TitleBar的完整代码片段、系统版本及缩放设置信息，便于官方定位问题。

内容的提问来源于stack exchange，提问作者Marius