C# WinForm中通过P/Invoke加载自定义光标

追风的人

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

原创

在C# WinForm开发中，有时需要为应用程序设置独特的鼠标指针以增强用户体验。本文通过调用Windows API并结合反射机制，展示了如何加载外部自定义光标文件（.cur或.ani）并应用到Form窗口。

实现原理与准备

默认情况下，System.Windows.Forms.Cursor 类主要支持从嵌入资源或标准路径加载图标。若需直接加载指定路径的光标文件，通常需要使用非托管API。本方案的核心思路如下：

导入API：使用 DllImport 从 user32.dll 引入 LoadCursorFromFile、SetCursor 和 DestroyCursor 函数。
创建代理对象：实例化一个临时的 Cursor 对象，用于持有目标句柄。
反射注入句柄：由于 Cursor 类的 Handle 属性是只读的，且内部句柄存储在一个名为 handle 的私有字段中，我们可以通过反射直接修改该字段的值，从而替换光标底层数据。

具体操作步骤

第1步：添加必要的命名空间引用

首先，确保代码文件中引入了以下命名空间，以便访问Windows窗体、绘图以及运行时反射和互操作服务：

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

第2步：定义Windows API接口

在窗体类（如 Form1）中声明外部DLL方法。我们需要加载自定义光标并设置当前光标状态：

public partial class Form1 : Form
{
    // 加载自定义光标文件，返回光标句柄
    [DllImport("user32.dll")]
    public static extern IntPtr LoadCursorFromFile(string fileName);

    // 设置当前线程的光标
    [DllImport("user32.dll")]
    public static extern IntPtr SetCursor(IntPtr cursorHandle);

    // 销毁光标资源，防止内存泄漏
    [DllImport("user32.dll")]
    public static extern uint DestroyCursor(IntPtr cursorHandle);
}

第3步：在构造函数中应用自定义光标

为了实现效果，我们在 Form 的构造函数中执行以下操作：创建一个基础 Cursor 对象，获取其句柄副本，然后通过反射将 LoadCursorFromFile 加载的新句柄赋值给该对象的内部 handle 字段。

注意：原示例中使用的是系统路径 C:\WINNT\Cursors\dinosau2.ani。在实际项目中，请替换为您实际可用的 .cur 或 .ani 文件路径。

public Form1()
{
    // 可选：初始化组件（由IDE自动生成）
    InitializeComponent();

    // 1. 基于当前光标创建一个新的Cursor对象作为容器
    Cursor myCursor = new Cursor(Cursor.Current.Handle);

    // 2. 加载指定的光标文件
    // 请将路径替换为您的实际光标文件路径
    string customCursorPath = @"C:\Windows\Cursors\aero_link.cur"; 
    if (System.IO.File.Exists(customCursorPath))
    {
        IntPtr colorCursorHandle = LoadCursorFromFile(customCursorPath);

        // 3. 使用反射修改 Cursor 对象的私有字段 'handle'
        myCursor.GetType().InvokeMember(
            "handle",
            BindingFlags.Public | BindingFlags.NonPublic | 
            BindingFlags.Instance | BindingFlags.SetField,
            null,
            myCursor,
            new object[] { colorCursorHandle }
        );

        // 4. 将修改后的光标应用到此窗体
        this.Cursor = myCursor;
    }
}

关键参数说明

fileName：LoadCursorFromFile 的参数，必须是有效的 .cur 或 .ani 文件绝对路径。
BindingFlags：组合标志，Instance | SetField 允许我们修改实例中的私有字段，NonPublic 则是访问私有成员的关键。
handle 字段：这是 Cursor 内部保存 Native Handle (HCURSOR) 的位置，直接替换它是实现自定义加载的最直接方式。

注意事项与排错

文件权限：确保运行用户有读取该光标文件的权限。
内存管理：虽然 .NET GC 会回收托管对象，但原生句柄（Native Handle）可能需要手动释放。如果频繁切换不同光标，建议在使用完后调用 DestroyCursor 来清理旧句柄，避免GDI资源泄漏。
兼容性：此方法适用于 Windows Forms 应用程序。对于 WPF 或其他UI框架，推荐直接使用 cursorthreadlocal 或 XAML 资源绑定。
路径错误：如果 LoadCursorFromFile 返回 IntPtr.Zero，请检查文件路径是否正确，或文件格式是否损坏。可以使用 File.Exists() 进行预判。