C# 模擬滑鼠操作：SetCursorPos 與 mouse_event API 完整封裝指南

應用場景

• 巨集錄製/回放 (使用者操作重現)
• 自動化測試腳本
• 操作示範 Demo 程式
• 無障礙輔助工具

核心 Win32 API

1. SetCursorPos - 設定游標絕對位置

[DllImport("user32.dll")]
static extern bool SetCursorPos(int X, int Y);

參數為螢幕左上角原點的絕對座標。

2. mouse_event - 綜合滑鼠事件模擬

[DllImport("user32.dll")]
static extern void mouse_event(MouseEventFlags flags, int dx, int dy, 
    uint data, UIntPtr extraInfo);

功能涵蓋：

• 絕對/相對位置移動
• 左/中/右鍵按下與釋放
• 滾輪操作
• X 按鍵 (擴充按鍵)

MouseEventFlags 列舉定義

[Flags]
enum MouseEventFlags : uint
{
    Move          = 0x0001,
    LeftDown      = 0x0002,
    LeftUp        = 0x0004,
    RightDown     = 0x0008,
    RightUp       = 0x0010,
    MiddleDown    = 0x0020,
    MiddleUp      = 0x0040,
    XDown         = 0x0080,
    XUp           = 0x0100,
    Wheel         = 0x0800,
    VirtualDesk   = 0x4000,
    Absolute      = 0x8000
}

常用組合範例

完整封裝類別範例

public static class MouseSimulator
{
    [DllImport("user32.dll")] static extern bool SetCursorPos(int x, int y);
    [DllImport("user32.dll")] static extern void mouse_event(uint flags, int dx, int dy, uint data, UIntPtr extraInfo);

    public static void MoveTo(int x, int y) => SetCursorPos(x, y);

    public static void LeftClick()
    {
        mouse_event(0x0002 | 0x0004, 0, 0, 0, UIntPtr.Zero);
    }

    public static void RightClick()
    {
        mouse_event(0x0008 | 0x0010, 0, 0, 0, UIntPtr.Zero);
    }

    public static void Scroll(int delta)
    {
        mouse_event(0x0800, 0, 0, (uint)delta, UIntPtr.Zero);
    }
}

參考文件

詳細參數說明請參閱 MSDN Library 或 Windows Platform SDK 文件。