如何在C# WinForms .NET 8中实现覆盖其他控件的透明叠加控件？

原基于洋红色（Magenta）颜色键的分层窗口方案在.NET 8中失效，核心原因是WinForms在.NET Core及后续版本中调整了控件渲染逻辑与窗口样式管理机制。以下是适配.NET 8的实现方案，支持半透明背景、居中文字显示，且能稳定堆叠在其他控件上方：

实现思路 #

1. 兼容64位系统的Win32 API声明，避免指针处理错误
2. 初始化时设置必要控件样式，确保透明属性与分层窗口生效
3. 放弃颜色键方案，改用LWA_ALPHA实现整体半透明，直接绘制背景与文字

完整代码 #

using System;
using System.Drawing;
using System.Runtime.InteropServices;
using System.Windows.Forms;

class TransparentOverlay : Control
{
    private int _opacity = 128; // 半透明值范围：0-255，0为完全透明
    private string _overlayText = "加载中...";

    public int Opacity
    {
        get => _opacity;
        set
        {
            _opacity = Math.Clamp(value, 0, 255);
            if (IsHandleCreated) UpdateLayeredWindow();
            Invalidate();
        }
    }

    public string OverlayText
    {
        get => _overlayText;
        set
        {
            _overlayText = value;
            Invalidate();
        }
    }

    public TransparentOverlay()
    {
        SetStyle(ControlStyles.OptimizedDoubleBuffer | 
                 ControlStyles.AllPaintingInWmPaint | 
                 ControlStyles.UserPaint |
                 ControlStyles.SupportsTransparentBackColor, true);
        BackColor = Color.Transparent;
        ForeColor = Color.White;
        Font = new Font("Arial", 14, FontStyle.Bold);
    }

    protected override void OnHandleCreated(EventArgs e)
    {
        base.OnHandleCreated(e);
        // 叠加分层窗口样式，不覆盖原有扩展样式
        var exStyle = NativeMethods.GetWindowLongPtr(Handle, NativeMethods.GWL_EXSTYLE);
        NativeMethods.SetWindowLongPtr(Handle, NativeMethods.GWL_EXSTYLE, exStyle | NativeMethods.WS_EX_LAYERED);
        UpdateLayeredWindow();
    }

    private void UpdateLayeredWindow()
    {
        NativeMethods.SetLayeredWindowAttributes(Handle, 0, (byte)_opacity, NativeMethods.LWA_ALPHA);
    }

    protected override void OnPaint(PaintEventArgs e)
    {
        // 绘制半透明背景
        using (var bgBrush = new SolidBrush(Color.FromArgb(_opacity, Color.Black)))
        {
            e.Graphics.FillRectangle(bgBrush, DisplayRectangle);
        }

        // 绘制居中文字
        if (!string.IsNullOrEmpty(_overlayText))
        {
            var textSize = e.Graphics.MeasureString(_overlayText, Font);
            var textPos = new PointF(
                (Width - textSize.Width) / 2,
                (Height - textSize.Height) / 2
            );
            using (var textBrush = new SolidBrush(ForeColor))
            {
                e.Graphics.DrawString(_overlayText, Font, textBrush, textPos);
            }
        }
    }

    protected override void OnSizeChanged(EventArgs e)
    {
        base.OnSizeChanged(e);
        if (IsHandleCreated) UpdateLayeredWindow();
    }

    private static class NativeMethods
    {
        public const int GWL_EXSTYLE = -20;
        public const int WS_EX_LAYERED = 0x80000;
        public const int LWA_ALPHA = 0x2;

        [DllImport("user32.dll", EntryPoint = "SetWindowLongPtr")]
        public static extern IntPtr SetWindowLongPtr(IntPtr hWnd, int nIndex, IntPtr dwNewLong);

        [DllImport("user32.dll", EntryPoint = "GetWindowLongPtr")]
        public static extern IntPtr GetWindowLongPtr(IntPtr hWnd, int nIndex);

        [DllImport("user32.dll")]
        public static extern bool SetLayeredWindowAttributes(IntPtr hWnd, uint crKey, byte bAlpha, int dwFlags);
    }
}

使用说明 #

• 将TransparentOverlay控件添加到窗体后，设置Dock = DockStyle.Fill即可覆盖整个窗体区域
• 通过Opacity属性调整背景透明度，数值越大背景越不透明
• 通过OverlayText属性自定义显示文字，文字会自动居中

内容的提问来源于stack exchange，提问作者viktor.rosvall