.NET 隐藏/自定义windows系统光标

本文介绍如何操作windows系统光标。正常我们设置/隐藏光标，只能改变当前窗体或者控件范围，无法全局操作windows光标。接到一个需求，想隐藏windows全局的鼠标光标显示，下面讲下如何操作

 先了解下系统鼠标光标，在鼠标属性-自定义列表中可以看到一共有13种类型，对应13种工作状态：

操作系统提供了一组预定义的光标，如箭头、手形、沙漏等，位于 C:\Windows\Cursors目录下。

对应的Windows.Input.CursorType枚举：

 1   public enum CursorType
 2   {
 3     None,
 4     No,
 5     Arrow,
 6     AppStarting,
 7     Cross,
 8     Help,
 9     IBeam,
10     SizeAll,
11     SizeNESW,
12     SizeNS,
13     SizeNWSE,
14     SizeWE,
15     UpArrow,
16     Wait,
17     Hand,
18     Pen,
19     ScrollNS,
20     ScrollWE,
21     ScrollAll,
22     ScrollN,
23     ScrollS,
24     ScrollW,
25     ScrollE,
26     ScrollNW,
27     ScrollNE,
28     ScrollSW,
29     ScrollSE,
30     ArrowCD,
31   }

光标显示逻辑：

• 全局光标设置：在桌面或非控件区域，使用默认系统光标。
• 窗口控件的设置：每个窗口控件可以设置自己的光标类型。当鼠标移动到该控件上时，将自动切换到该设置的光标。如果未设置则显示系统光标
• 当鼠标移动、点击或执行其他操作时，系统会检测并相应更新光标形状。应用程序也可以改变拖放等操作的光标

对当前鼠标状态有获取需求的，可以通过GetCursorInfo获取，当前鼠标光标id以及句柄：

1     private IntPtr GetCurrentCursor()
2     {
3         CURSORINFO cursorInfo;
4         cursorInfo.cbSize = Marshal.SizeOf(typeof(CURSORINFO));
5         GetCursorInfo(out cursorInfo);
6         var cursorId = cursorInfo.hCursor;
7         var cursorHandle = CopyIcon(cursorId);
8         return cursorHandle;
9     }

那如何隐藏系统光标呢？系统光标可以通过SetSystemCursor function (winuser.h) - Win32 apps | Microsoft Learn函数设置，不过貌似没有隐藏光标的入口

然后隐藏系统光标：

1   private void HideCursor()
2   {
3       _cursorHandle = GetCurrentCursor();
4       //替换为空白鼠标光标
5       var cursorFile = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Blank.cur");
6       IntPtr cursor = LoadCursorFromFile(cursorFile);
7       SetSystemCursor(cursor, OcrNormal);
8  }

恢复系统光标的显示，将之前光标Handle设置回去：

1 var success = SetSystemCursor(_cursorHandle, OcrNormal);

以上是实现了当前光标的替换。但上面有介绍过鼠标光标状态有13种，会根据应用程序状态进行切换，所以其它光标也要处理。

对13种光标都替换为空白光标，13种光标CursorId值在setSystemCursor文档有说明：

 1     private readonly int[] _systemCursorIds = new int[] { 32512, 32513, 32514, 32515, 32516, 32642, 32643, 32644, 32645, 32646, 32648, 32649, 32650 };
 2     private readonly IntPtr[] _previousCursorHandles = new IntPtr[13];
 3     private void HideCursor()
 4     {
 5         for (int i = 0; i < _systemCursorIds.Length; i++)
 6         {
 7             var cursor = LoadCursor(IntPtr.Zero, _systemCursorIds[i]);
 8             var cursorHandle = CopyIcon(cursor);
 9             _previousCursorHandles[i] = cursorHandle;
10             //替换为空白鼠标光标
11             var cursorFile = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Blank.cur");
12             IntPtr blankCursor = LoadCursorFromFile(cursorFile);
13             SetSystemCursor(blankCursor, (uint)_systemCursorIds[i]);
14         }
15     }

运行验证：系统桌面、应用窗体如VisualStudio以及网页等光标编辑状态，都成功隐藏

还原光标状态：

1     private void ShowCursor()
2     {
3         for (int i = 0; i < _systemCursorIds.Length; i++)
4         {
5             SetSystemCursor(_previousCursorHandles[i], (uint)_systemCursorIds[i]);
6         }
7     }

用到的User32及参数类：

 1    [DllImport("user32.dll", SetLastError = true)]
 2    public static extern IntPtr LoadCursor(IntPtr hInstance, int lpCursorName);
 3    [DllImport("user32.dll")]
 4    public static extern IntPtr CopyIcon(IntPtr cusorId);
 5    [DllImport("user32.dll")]
 6    public static extern IntPtr LoadCursorFromFile(string lpFileName);
 7    [DllImport("user32.dll")]
 8    public static extern bool SetSystemCursor(IntPtr hcur, uint id);
 9    [DllImport("user32.dll")]
10    static extern bool GetCursorInfo(out CURSORINFO pci);
11 
12    [StructLayout(LayoutKind.Sequential)]
13    public struct POINT
14    {
15        public Int32 x;
16        public Int32 y;
17    }
18 
19    [StructLayout(LayoutKind.Sequential)]
20    public struct CURSORINFO
21    {
22        public Int32 cbSize;        // Specifies the size, in bytes, of the structure. 
23                                    // The caller must set this to Marshal.SizeOf(typeof(CURSORINFO)).
24        public Int32 flags;         // Specifies the cursor state. This parameter can be one of the following values:
25                                    //    0             The cursor is hidden.
26                                    //    CURSOR_SHOWING    The cursor is showing.
27        public IntPtr hCursor;          // Handle to the cursor. 
28        public POINT ptScreenPos;       // A POINT structure that receives the screen coordinates of the cursor. 
29    }

需要说明的是，系统光标修改请谨慎处理，光标修改后人工操作不太容易恢复，对应用程序退出、崩溃等情况做好光标恢复操作。

以上demo代码见：kybs00/HideSystemCursorDemo: 隐藏windows系统光标 (github.com) 

参考资料：

AllAPI.net - Your #1 source for using API-functions in Visual Basic! (mentalis.org)

createCursor 函数 (winuser.h) - Win32 apps | Microsoft Learn

SetSystemCursor function (winuser.h) - Win32 apps | Microsoft Learn

关键字：自定义光标、隐藏/显示光标、windows系统光标显示