C# WinForm 实现桌面遮罩层效果

季宁

发布时间：2026-10-14| 7人浏览过

原创

在开发桌面应用时，有时需要在 Windows 桌面上显示一个覆盖全屏的半透明背景，且该背景不能阻挡用户对桌面的正常点击操作（即鼠标穿透）。本文将展示如何利用 C# 的 WinForm 框架结合 Windows API 函数，快速实现这一特效。

核心原理

实现桌面遮罩层的关键在于对窗口扩展样式（Extended Window Styles）的设置，主要涉及两个常量：

WS_EX_TRANSPARENT：允许窗口支持鼠标穿透，即鼠标事件会传递给位于该窗口下方的其他窗口。
WS_EX_LAYERED：使窗口支持分层特性，从而可以使用 SetLayeredWindowAttributes 来设置窗口的透明度或位图透明度。

准备工作

你需要一个标准的 C# Windows Forms 项目。在代码文件中引入必要的命名空间：System.Drawing、System.Windows.Forms 以及用于调用非托管代码的 System.Runtime.InteropServices。

实现步骤

第1步：声明 Windows API 函数与常量

首先，需要在类中导入 user32.dll 中的关键函数，并定义相关的整数常量。这是控制窗口行为的基础。

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

namespace DesktopMaskOverlay
{
    public partial class Form1 : Form
    {
        // 导入 User32.dll 中的三个关键函数
        [DllImport("user32.dll", EntryPoint = "GetWindowLong")]
        public static extern int GetWindowLong(IntPtr hWnd, int nIndex);

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

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

        // 定义常量
        private const int GWL_EXSTYLE = -20;
        private const int WS_EX_TRANSPARENT = 0x20;
        private const int WS_EX_LAYERED = 0x80000;
        private const uint LWA_ALPHA = 0x2; // 表示使用 Alpha 通道进行透明度调节
    }
}

注意：原示例中返回类型可能因编译器版本不同而略有差异，这里统一调整为 int 以确保兼容性，SetLayeredWindowAttributes 通常返回布尔值指示成功与否。

第2步：配置窗体初始化参数

在窗体的加载事件（Form_Load）中，我们需要将窗体设置为始终置顶、无边框、最大化显示，并应用上述的 API 设置。

    private void Form1_Load(object sender, EventArgs e)
    {
        // 1. 设置基础外观
        this.BackColor = Color.Silver; // 遮罩颜色，可根据需要修改
        this.TopMost = true;           // 始终置于顶层，确保遮盖桌面图标等
        this.FormBorderStyle = FormBorderStyle.None; // 移除标题栏和边框
        this.WindowState = FormWindowState.Maximized; // 铺满整个工作区

        // 2. 获取当前扩展样式，并添加 WS_EX_TRANSPARENT 和 WS_EX_LAYERED
        int extendedStyle = GetWindowLong(this.Handle, GWL_EXSTYLE);
        SetWindowLong(this.Handle, GWL_EXSTYLE, extendedStyle | WS_EX_TRANSPARENT | WS_EX_LAYERED);

        // 3. 设置透明度
        // 参数说明: Handle, 屏蔽色(0表示忽略), Alpha值(0-255), 标志(LWA_ALPHA)
        SetLayeredWindowAttributes(this.Handle, 0, 128, LWA_ALPHA);
    }

参数解析：

GetWindowLong(Handle, GWL_EXSTYLE)：获取窗口当前的扩展样式。
| WS_EX_TRANSPARENT | WS_EX_LAYERED：通过按位或运算，在不改变原有其他样式的前提下，追加透明和分层特性。
SetLayeredWindowAttributes(..., 128, ...)：这里的 128 是 Alpha 值，范围是 0~255。128 约为 50% 的透明度。你可以根据实际需求调整此数值，数值越小越透明。