如何在WPF自定义最大化/还原按钮中支持Windows 11 Snap Layout功能

Windows 11的Snap Layout弹出逻辑由系统内核控制，仅当系统识别到用户悬停的区域是标准最大化按钮命中区时才会触发，WPF自定义标题栏的按钮默认没有对接系统的命中测试规则，因此无法触发该面板。

可行解决方案 #

• 方案1：拦截WM_NCHITTEST消息返回系统识别的命中值 #

  这是成本最低的适配方案，只需要在WPF窗口中重写消息处理逻辑，给自定义最大化按钮的区域返回对应系统命中码即可，核心代码示例：
  首先在窗口的SourceInitialized事件中挂载消息钩子：

  private const int WM_NCHITTEST = 0x0084;
  private const int HTMAXBUTTON = 9;
  private const int HTCLIENT = 1;
  
  protected override void OnSourceInitialized(EventArgs e)
  {
      base.OnSourceInitialized(e);
      var source = HwndSource.FromHwnd(new WindowInteropHelper(this).Handle);
      source.AddHook(HwndHook);
  }
  
  private IntPtr HwndHook(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
  {
      if (msg == WM_NCHITTEST)
      {
          // 解析鼠标屏幕坐标
          int x = lParam.ToInt32() & 0xffff;
          int y = lParam.ToInt32() >> 16;
          Point screenPoint = new Point(x, y);
          // 转换为窗口内相对坐标
          Point clientPoint = PointFromScreen(screenPoint);
          // 计算自定义最大化按钮的窗口内区域
          Rect maxButtonRect = new Rect(
              CustomMaxButton.TranslatePoint(new Point(0,0), this),
              CustomMaxButton.RenderSize);
          if (maxButtonRect.Contains(clientPoint) && CustomMaxButton.IsEnabled)
          {
              handled = true;
              return new IntPtr(HTMAXBUTTON);
          }
      }
      return IntPtr.Zero;
  }
  

  处理完成后系统会自动识别该区域为标准最大化按钮，悬停时自动弹出Snap Layout面板。

• 方案2：使用已适配的UI框架配置项 #

  如果你使用了主流的WPF自定义UI框架，可直接通过框架内置配置开启适配，无需自行编码：

  • ModernWpf：调用Window.SetExtendsContentIntoTitleBar(this, true)后框架会自动处理标题栏控件的命中测试
  • MahApps.Metro：升级到v2.4.6及以上版本，设置TitleBar.IsSnapLayoutEnabled="True"即可自动适配

• 方案3：通过Windows App SDK托管窗口 #

  如果你需要适配更多Windows 11/12新特性，可引入Windows App SDK，用AppWindow类托管WPF窗口，系统会统一处理标题栏按钮的所有原生行为，包括Snap Layout、窗口圆角、云母效果适配等，长期兼容性更好。

注意事项 #

• 需确保窗口WindowStyle="None"且关闭系统默认标题栏渲染，避免自定义区域和系统标题栏命中规则冲突
• 适配完成后建议在Windows 11 22H2及以上版本测试，早期Win11版本对自定义标题栏的Snap Layout支持存在已知缺陷
• 若自定义最大化按钮存在禁用状态，命中时需返回HTDISABLED（值为10），避免禁用状态下误触发Snap Layout

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