Microsoft UI XAML 项目中完全隐藏标题栏的技术实现

在 Windows 应用开发中，有时我们需要完全隐藏窗口的标题栏以获得更灵活的界面设计。本文将详细介绍在 Microsoft UI XAML 项目中实现完全隐藏标题栏的几种技术方案。

方案一：使用 OverlappedPresenter 控制边框和标题栏

在 WinUI 1.4 及以上版本中，可以通过 OverlappedPresenter 类来控制窗口的边框和标题栏显示：

OverlappedPresenter.SetBorderAndTitleBar(false, false);
OverlappedPresenter.IsResizable = false;  // 移除 WS_THICKFRAME 样式

这种方法简单直接，但需要注意：

1. 设置 IsResizable 为 false 会同时禁用窗口大小调整功能
2. 在 WinUI 1.5.4 版本中同样适用

方案二：Win32 API 直接操作窗口样式

对于需要更精细控制的情况，可以直接使用 Win32 API 操作窗口样式：

IntPtr hWnd = WinRT.Interop.WindowNative.GetWindowHandle(this);
int style = GetWindowLongPtr(hWnd, GWL_STYLE).ToInt32();
SetWindowLongPtr(hWnd, GWL_STYLE, new IntPtr(style & ~(WS_CAPTION)));

这种方法的注意事项：

1. 需要处理窗口位置和大小的调整
2. 可能需要额外处理窗口边框的显示
3. 兼容性需要考虑不同 Windows 版本

方案三：扩展内容到标题栏并折叠标题栏

这是目前最推荐的解决方案，它能够：

• 完全隐藏标题栏
• 保留窗口拖动功能
• 保持窗口大小调整能力

实现代码：

public MainWindow()
{
    this.InitializeComponent();
    ExtendsContentIntoTitleBar = true;
    SetTitleBar(Part_TitleBar);  // Part_TitleBar 是你的可拖动区域
    
    // 关键设置：将标题栏高度设置为折叠
    AppWindow.TitleBar.PreferredHeightOption = TitleBarHeightOption.Collapsed;
}

这种方案的优点：

1. 完全隐藏标题栏视觉元素
2. 可以自定义拖动区域
3. 保持完整的窗口功能
4. 官方推荐的做法，兼容性好

技术细节深入解析

窗口样式背后的原理

Windows 窗口的视觉元素由多种样式标志控制：

• WS_CAPTION：控制标题栏显示
• WS_THICKFRAME：控制窗口边框和大小调整能力
• WS_MINIMIZEBOX/WS_MAXIMIZEBOX：控制最小化/最大化按钮

拖动区域的处理

当隐藏标题栏后，窗口失去了默认的拖动区域。解决方案有：

1. 指定某个 UI 元素作为拖动区域（SetTitleBar 方法）
2. 处理 WM_NCHITTEST 消息，自定义非客户区响应

DPI 缩放考虑

在不同 DPI 设置下，窗口边框和标题栏的大小可能变化，需要：

1. 使用系统 API 获取当前 DPI
2. 根据 DPI 缩放比例调整自定义拖动区域大小

实际应用建议

1. 对于大多数情况，推荐使用方案三（扩展内容+折叠标题栏）
2. 如果需要完全自定义窗口边框，可以结合方案一和方案三
3. 直接操作窗口样式（方案二）应作为最后选择，因为兼容性风险较高

通过以上方法，开发者可以灵活控制窗口标题栏的显示，实现各种现代化的应用界面设计。