WinForm无边框窗体Windows模糊效果问题：控件被意外模糊

问题说明 #

在为无边框WinForm应用Windows模糊效果时，参考Stack Overflow用户György Kőszeg的实现代码后，发现模糊效果不仅作用于窗体背景，连窗体上的控件也被模糊。需要明确该现象是否正常，以及如何实现仅对窗体应用模糊效果的需求（注：窗体阴影由其他类实现）。

现象是否正常？ #

是正常现象。ACCENT_ENABLE_BLURBEHIND是Windows提供的系统级模糊策略，它会对整个窗口的客户区域（包括所有控件所在的区域）应用模糊效果。而WinForm的控件默认直接绘制在窗体的同一个绘图表面上，因此会被模糊效果覆盖，呈现出模糊状态。

如何实现仅窗体背景模糊？ #

核心思路是将模糊效果限制在窗体的背景层，让控件位于不受模糊影响的前景层上。具体实现步骤如下：

• 设置窗体为分层透明，让模糊效果能透过背景显示
• 使用Panel作为所有控件的容器，设置容器背景为不透明，隔离模糊效果
• 调整模糊策略的渐变颜色参数，配合窗体透明实现精准的背景模糊

修改后的BlurEffect类代码 #

internal class BlurEffect
{
    internal enum AccentState
    {
        ACCENT_DISABLED = 0,
        ACCENT_ENABLE_GRADIENT = 1,
        ACCENT_ENABLE_TRANSPARENTGRADIENT = 2,
        ACCENT_ENABLE_BLURBEHIND = 3,
        ACCENT_INVALID_STATE = 4
    }

    internal enum WindowCompositionAttribute
    {
        WCA_ACCENT_POLICY = 19
    }

    [StructLayout(LayoutKind.Sequential)]
    internal struct AccentPolicy
    {
        public AccentState AccentState;
        public int AccentFlags;
        public int GradientColor;
        public int AnimationId;
    }

    [StructLayout(LayoutKind.Sequential)]
    internal struct WindowCompositionAttributeData
    {
        public WindowCompositionAttribute Attribute;
        public IntPtr Data;
        public int SizeOfData;
    }

    internal static class User32
    {
        [DllImport("user32.dll")]
        internal static extern int SetWindowCompositionAttribute(IntPtr hwnd, ref WindowCompositionAttributeData data);
    }

    internal static void Apply(Form form, bool enable)
    {
        var accent = new AccentPolicy();
        if (enable)
        {
            accent.AccentState = AccentState.ACCENT_ENABLE_BLURBEHIND;
            // ARGB格式设置渐变颜色：半透明黑色（可按需调整透明度和色调）
            accent.GradientColor = (128 << 24) | (0 << 16) | (0 << 8) | 0;
            accent.AccentFlags = 2; // 启用渐变模糊模式
        }
        else
        {
            accent.AccentState = AccentState.ACCENT_DISABLED;
        }

        var accentStructSize = Marshal.SizeOf(accent);
        var accentPtr = Marshal.AllocHGlobal(accentStructSize);
        Marshal.StructureToPtr(accent, accentPtr, false);

        var data = new WindowCompositionAttributeData
        {
            Attribute = WindowCompositionAttribute.WCA_ACCENT_POLICY,
            SizeOfData = accentStructSize,
            Data = accentPtr
        };

        User32.SetWindowCompositionAttribute(form.Handle, ref data);
        Marshal.FreeHGlobal(accentPtr);
    }
}

修改后的测试窗体代码 #

public partial class MyForm : Form
{
    private bool blur_effect = false;
    [Category("• MyForm")]
    [DisplayName("• BlurEffect")]
    [Description("Enables or disables the [Blur] effect.")]
    public bool BlurEffect
    {
        get => this.blur_effect;
        set
        {
            this.blur_effect = value;
            BlurEffect.Apply(this, value);
            base.Invalidate();
        }
    }

    public MyForm()
    {
        InitializeComponent();
        // 基础设置：无边框+支持透明背景
        this.FormBorderStyle = FormBorderStyle.None;
        this.SetStyle(ControlStyles.SupportsTransparentBackColor, true);
        this.BackColor = Color.Transparent;
        this.TransparencyKey = Color.Transparent;

        // 创建控件容器，隔离模糊效果
        var controlPanel = new Panel();
        controlPanel.Dock = DockStyle.Fill;
        controlPanel.BackColor = Color.White; // 设置不透明背景，确保控件清晰
        this.Controls.Add(controlPanel);

        // 添加测试按钮到容器中
        var blurToggleBtn = new Button();
        blurToggleBtn.Text = "切换模糊效果";
        blurToggleBtn.Size = new Size(150, 30);
        blurToggleBtn.Location = new Point((this.Width - blurToggleBtn.Width)/2, (this.Height - blurToggleBtn.Height)/2);
        blurToggleBtn.Click += BlurEffect_Button_Click;
        controlPanel.Controls.Add(blurToggleBtn);
    }

    private void BlurEffect_Button_Click(object sender, EventArgs e)
    {
        this.BlurEffect = !this.BlurEffect;
    }
}

关键说明 #

• 调整GradientColor的Alpha值（代码中128）可以控制模糊背景的透明度，数值越大背景越不透明
• 所有业务控件必须放在独立容器内，容器背景需设为不透明，避免被模糊效果影响
• 窗体必须开启透明支持，否则模糊效果无法正常渲染

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