Windows Forms 嵌入Panel的子窗体异常放大问题排查

• 首先排查DPI适配配置问题
  这是嵌入子窗体异常放大最常见的诱因，WinForm程序未正确配置高DPI感知时，子窗体嵌入Panel时会触发系统自动缩放，即使手动对齐了尺寸也会出现偏移。

  • 如果你使用的是.NET Core/.NET 5+版本，在项目Program.cs的入口函数中，Application.Run执行前添加以下配置：

  Application.SetHighDpiMode(HighDpiMode.SystemAware);
  Application.EnableVisualStyles();
  Application.SetCompatibleTextRenderingDefault(false);
  

  • 如果你使用的是.NET Framework版本，右键项目→属性→应用程序→查看Windows设置，打开app.manifest文件，取消以下配置的注释：

  <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true</dpiAware>
    </windowsSettings>
  </application>
  

• 关闭子窗体的自动缩放特性
  子窗体默认的AutoScaleMode属性通常为Font或Dpi，嵌入父容器时会根据父容器的字体、DPI参数重新计算尺寸，导致异常放大。你可以在openChildForm方法中添加对应配置，修改后的完整代码如下：

private Form activeForm = null;
private void openChildForm(Form childForm)
{
    if (activeForm != null)
    {
        activeForm.Close();
    }
    activeForm = childForm;
    childForm.TopLevel = false;
    childForm.FormBorderStyle = FormBorderStyle.None;
    // 新增：关闭子窗体自动缩放
    childForm.AutoScaleMode = AutoScaleMode.None;
    // 新增：先手动对齐尺寸，避免Dock填充前的尺寸异常
    childForm.Size = panelChildForm.ClientSize;
    childForm.Dock = DockStyle.Fill;
    panelChildForm.Controls.Add(childForm);
    panelChildForm.Tag = childForm;
    childForm.BringToFront();
    childForm.Show();
    labelVersion.BringToFront();
}

• 额外校验项
  确认承载子窗体的panelChildForm的AutoScaleMode属性也设置为None，避免父容器触发缩放传递。

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