.NET Framework 4.8 WinForm调用DwmSetWindowAttribute失败求助

一、Windows 11下调用DwmSetWindowAttribute报错的原因与修复 #

1. 核心问题：P/Invoke签名或参数类型不匹配 #

报错The value is not within the expected range通常源于以下情况：

• 函数签名声明错误，导致参数传递时内存布局不兼容
• 传入的属性枚举值、参数类型与目标DWMWINDOWATTRIBUTE不匹配
• 调用时机过早（窗口句柄未完成初始化）

2. 正确的P/Invoke声明与枚举定义 #

确保P/Invoke签名和枚举完全匹配系统要求：

using System;
using System.Runtime.InteropServices;
using System.Drawing;

public static class DwmApi
{
    // 圆角设置专用重载（参数为int类型枚举）
    [DllImport("dwmapi.dll", PreserveSig = false)]
    public static extern void DwmSetWindowAttribute(
        IntPtr hwnd,
        DWMWINDOWATTRIBUTE dwAttribute,
        ref int pvAttribute,
        int cbAttribute);

    // 边框颜色设置专用重载（参数为uint类型COLORREF）
    [DllImport("dwmapi.dll", PreserveSig = false)]
    public static extern void DwmSetWindowAttribute(
        IntPtr hwnd,
        DWMWINDOWATTRIBUTE dwAttribute,
        ref uint pvAttribute,
        int cbAttribute);

    public enum DWMWINDOWATTRIBUTE
    {
        DWMWA_WINDOW_CORNER_PREFERENCE = 33,
        DWMWA_BORDER_COLOR = 34
    }

    public enum DWM_WINDOW_CORNER_PREFERENCE
    {
        DWMWCP_DEFAULT = 0,
        DWMWCP_DONOTROUND = 1,
        DWMWCP_ROUND = 2,
        DWMWCP_ROUNDSMALL = 3
    }
}

3. 正确调用方式与注意事项 #

• 必须在窗口句柄完全初始化后调用（推荐Form_Shown事件，而非Form_Load）
• 调用前验证系统版本（仅Windows 11及以上支持DWMWA_WINDOW_CORNER_PREFERENCE和DWMWA_BORDER_COLOR）
• 严格匹配参数类型：
  • 圆角设置：传入DWM_WINDOW_CORNER_PREFERENCE枚举的int值
  • 边框颜色：传入COLORREF格式的uint值（可通过ColorTranslator.ToWin32(Color)转换）

示例代码：

private void Form_Shown(object sender, EventArgs e)
{
    // 验证Windows 11及以上版本（Build号≥22000）
    if (Environment.OSVersion.Version.Major >= 10 && Environment.OSVersion.Version.Build >= 22000)
    {
        try
        {
            // 设置窗口为标准圆角
            int cornerPref = (int)DwmApi.DWM_WINDOW_CORNER_PREFERENCE.DWMWCP_ROUND;
            DwmApi.DwmSetWindowAttribute(this.Handle, DwmApi.DWMWINDOWATTRIBUTE.DWMWA_WINDOW_CORNER_PREFERENCE, ref cornerPref, sizeof(int));

            // 设置边框为蓝色
            uint borderColor = (uint)ColorTranslator.ToWin32(Color.RoyalBlue);
            DwmApi.DwmSetWindowAttribute(this.Handle, DwmApi.DWMWINDOWATTRIBUTE.DWMWA_BORDER_COLOR, ref borderColor, sizeof(uint));
        }
        catch (COMException ex)
        {
            MessageBox.Show($"调用失败：{ex.Message}");
        }
    }
}

4. 常见坑点排查 #

• 保持FormBorderStyle为默认值，保留ControlBox、MaximizeBox等属性开启，确保原生交互正常
• MDI子窗口无法直接设置DWM属性，需针对主窗口操作
• 若用户手动关闭Windows 11的系统圆角功能，自定义圆角设置会失效

二、Windows 10下的非客户区自定义方案 #

Windows 10原生不支持上述DWM属性，需通过消息拦截和手动绘制实现，同时保留原生标题栏功能：

1. 实现窗口圆角 #

通过扩展客户区+自定义绘制实现：

• 调用DwmExtendFrameIntoClientArea将客户区扩展至非客户区范围
• 处理WM_PAINT消息，在客户区绘制圆角背景，覆盖原非客户区的直角部分
• 调整控件布局，避免被扩展区域遮挡

2. 自定义边框颜色 #

拦截WM_NCPAINT消息手动绘制：

• 重写WndProc方法捕获WM_NCPAINT消息
• 使用GetWindowDC获取非客户区设备上下文，绘制自定义颜色边框
• 绘制完成后调用ReleaseDC释放资源

示例代码（简化版）：

protected override void WndProc(ref Message m)
{
    const int WM_NCPAINT = 0x85;

    switch (m.Msg)
    {
        case WM_NCPAINT:
            // 自定义绘制非客户区边框
            IntPtr hdc = GetWindowDC(m.HWnd);
            if (hdc != IntPtr.Zero)
            {
                using (Graphics g = Graphics.FromHdc(hdc))
                {
                    Rectangle borderRect = new Rectangle(0, 0, this.Width, this.Height);
                    using (Pen pen = new Pen(Color.Orange, 2))
                    {
                        g.DrawRectangle(pen, borderRect);
                    }
                }
                ReleaseDC(m.HWnd, hdc);
                // 阻止系统默认绘制
                m.Result = IntPtr.Zero;
                return;
            }
            break;
    }
    base.WndProc(ref m);
}

[DllImport("user32.dll")]
private static extern IntPtr GetWindowDC(IntPtr hWnd);

[DllImport("user32.dll")]
private static extern int ReleaseDC(IntPtr hWnd, IntPtr hDC);

3. 注意事项 #

• 手动绘制非客户区可能导致原生交互异常（如标题栏拖拽、按钮hover效果），需额外处理WM_NCHITTEST等消息
• Windows 10不同版本的非客户区布局有差异，需做兼容性测试
• 尽量减少系统消息拦截范围，优先保留原生功能完整性

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