c# 全局监听键盘（键盘钩子）

作者：马育民 • • 阅读：10115

封装类

internal class KeyboardHook
{
    public event KeyEventHandler KeyDownEvent;
    public event KeyPressEventHandler KeyPressEvent;
    public event KeyEventHandler KeyUpEvent;

    public delegate int HookProc(int nCode, Int32 wParam, IntPtr lParam);
    static int hKeyboardHook = 0; //声明键盘钩子处理的初始值
    //值在Microsoft SDK的Winuser.h里查询
    public const int WH_KEYBOARD_LL = 13;   //线程键盘钩子监听鼠标消息设为2，全局键盘监听鼠标消息设为13
    HookProc KeyboardHookProcedure; //声明KeyboardHookProcedure作为HookProc类型
    //键盘结构
    [StructLayout(LayoutKind.Sequential)]
    public class KeyboardHookStruct
    {
        public int vkCode;  //定一个虚拟键码。该代码必须有一个价值的范围1至254
        public int scanCode; // 指定的硬件扫描码的关键
        public int flags;  // 键标志
        public int time; // 指定的时间戳记的这个讯息
        public int dwExtraInfo; // 指定额外信息相关的信息
    }
    //使用此功能，安装了一个钩子
    [DllImport("user32.dll", CharSet = CharSet.Auto, CallingConvention = CallingConvention.StdCall)]
    public static extern int SetWindowsHookEx(int idHook, HookProc lpfn, IntPtr hInstance, int threadId);


    //调用此函数卸载钩子
    [DllImport("user32.dll", CharSet = CharSet.Auto, CallingConvention = CallingConvention.StdCall)]
    public static extern bool UnhookWindowsHookEx(int idHook);


    //使用此功能，通过信息钩子继续下一个钩子
    [DllImport("user32.dll", CharSet = CharSet.Auto, CallingConvention = CallingConvention.StdCall)]
    public static extern int CallNextHookEx(int idHook, int nCode, Int32 wParam, IntPtr lParam);

    // 取得当前线程编号（线程钩子需要用到）
    [DllImport("kernel32.dll")]
    static extern int GetCurrentThreadId();

    //使用WINDOWS API函数代替获取当前实例的函数,防止钩子失效
    [DllImport("kernel32.dll")]
    public static extern IntPtr GetModuleHandle(string name);

    public void Start()
    {
        // 安装键盘钩子
        if (hKeyboardHook == 0)
        {
            KeyboardHookProcedure = new HookProc(KeyboardHookProc);
            hKeyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardHookProcedure, GetModuleHandle(System.Diagnostics.Process.GetCurrentProcess().MainModule.ModuleName), 0);
            //hKeyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardHookProcedure, Marshal.GetHINSTANCE(Assembly.GetExecutingAssembly().GetModules()[0]), 0);
            //************************************
            //键盘线程钩子
            SetWindowsHookEx(13, KeyboardHookProcedure, IntPtr.Zero, GetCurrentThreadId());//指定要监听的线程idGetCurrentThreadId(),
            //键盘全局钩子,需要引用空间(using System.Reflection;)
            //SetWindowsHookEx( 13,MouseHookProcedure,Marshal.GetHINSTANCE(Assembly.GetExecutingAssembly().GetModules()[0]),0);
            //
            //关于SetWindowsHookEx (int idHook, HookProc lpfn, IntPtr hInstance, int threadId)函数将钩子加入到钩子链表中，说明一下四个参数：
            //idHook 钩子类型，即确定钩子监听何种消息，上面的代码中设为2，即监听键盘消息并且是线程钩子，如果是全局钩子监听键盘消息应设为13，
            //线程钩子监听鼠标消息设为7，全局钩子监听鼠标消息设为14。lpfn 钩子子程的地址指针。如果dwThreadId参数为0 或是一个由别的进程创建的
            //线程的标识，lpfn必须指向DLL中的钩子子程。 除此以外，lpfn可以指向当前进程的一段钩子子程代码。钩子函数的入口地址，当钩子钩到任何
            //消息后便调用这个函数。hInstance应用程序实例的句柄。标识包含lpfn所指的子程的DLL。如果threadId 标识当前进程创建的一个线程，而且子
            //程代码位于当前进程，hInstance必须为NULL。可以很简单的设定其为本应用程序的实例句柄。threaded 与安装的钩子子程相关联的线程的标识符
            //如果为0，钩子子程与所有的线程关联，即为全局钩子
            //************************************
            //如果SetWindowsHookEx失败
            if (hKeyboardHook == 0)
            {
                Stop();
                throw new Exception("安装键盘钩子失败");
            }
        }
    }
    public void Stop()
    {
        bool retKeyboard = true;


        if (hKeyboardHook != 0)
        {
            retKeyboard = UnhookWindowsHookEx(hKeyboardHook);
            hKeyboardHook = 0;
        }

        if (!(retKeyboard)) throw new Exception("卸载钩子失败！");
    }
    //ToAscii职能的转换指定的虚拟键码和键盘状态的相应字符或字符
    [DllImport("user32")]
    public static extern int ToAscii(int uVirtKey, //[in] 指定虚拟关键代码进行翻译。
                                        int uScanCode, // [in] 指定的硬件扫描码的关键须翻译成英文。高阶位的这个值设定的关键，如果是（不压）
                                        byte[] lpbKeyState, // [in] 指针，以256字节数组，包含当前键盘的状态。每个元素（字节）的数组包含状态的一个关键。如果高阶位的字节是一套，关键是下跌（按下）。在低比特，如果设置表明，关键是对切换。在此功能，只有肘位的CAPS LOCK键是相关的。在切换状态的NUM个锁和滚动锁定键被忽略。
                                        byte[] lpwTransKey, // [out] 指针的缓冲区收到翻译字符或字符。
                                        int fuState); // [in] Specifies whether a menu is active. This parameter must be 1 if a menu is active, or 0 otherwise.

    //获取按键的状态
    [DllImport("user32")]
    public static extern int GetKeyboardState(byte[] pbKeyState);


    [DllImport("user32.dll", CharSet = CharSet.Auto, CallingConvention = CallingConvention.StdCall)]
    private static extern short GetKeyState(int vKey);

    private const int WM_KEYDOWN = 0x100;//KEYDOWN
    private const int WM_KEYUP = 0x101;//KEYUP
    private const int WM_SYSKEYDOWN = 0x104;//SYSKEYDOWN
    private const int WM_SYSKEYUP = 0x105;//SYSKEYUP

    private int KeyboardHookProc(int nCode, Int32 wParam, IntPtr lParam)
    {
        // 侦听键盘事件
        if ((nCode >= 0) && (KeyDownEvent != null || KeyUpEvent != null || KeyPressEvent != null))
        {
            KeyboardHookStruct MyKeyboardHookStruct = (KeyboardHookStruct)Marshal.PtrToStructure(lParam, typeof(KeyboardHookStruct));
            // raise KeyDown
            if (KeyDownEvent != null && (wParam == WM_KEYDOWN || wParam == WM_SYSKEYDOWN))
            {
                Keys keyData = (Keys)MyKeyboardHookStruct.vkCode;
                KeyEventArgs e = new KeyEventArgs(keyData);
                KeyDownEvent(this, e);
            }

            //键盘按下
            if (KeyPressEvent != null && wParam == WM_KEYDOWN)
            {
                byte[] keyState = new byte[256];
                GetKeyboardState(keyState);

                byte[] inBuffer = new byte[2];
                if (ToAscii(MyKeyboardHookStruct.vkCode, MyKeyboardHookStruct.scanCode, keyState, inBuffer, MyKeyboardHookStruct.flags) == 1)
                {
                    KeyPressEventArgs e = new KeyPressEventArgs((char)inBuffer[0]);
                    KeyPressEvent(this, e);
                }
            }

            // 键盘抬起
            if (KeyUpEvent != null && (wParam == WM_KEYUP || wParam == WM_SYSKEYUP))
            {
                Keys keyData = (Keys)MyKeyboardHookStruct.vkCode;
                KeyEventArgs e = new KeyEventArgs(keyData);
                KeyUpEvent(this, e);
            }

        }
        //如果返回1，则结束消息，这个消息到此为止，不再传递。
        //如果返回0或调用CallNextHookEx函数则消息出了这个钩子继续往下传递，也就是传给消息真正的接受者
        return CallNextHookEx(hKeyboardHook, nCode, wParam, lParam);
    }
    ~KeyboardHook()
    {
        Stop();
    }
}

使用

声明变量

private KeyEventHandler keyDownEventHandler = null;//处理按下键盘的钩子
private KeyEventHandler keyUpEventHandler = null;//处理弹起键盘的钩子
private KeyboardHook k_hook = new KeyboardHook();

回调函数

按下事件
private void hook_KeyDown(object sender, KeyEventArgs e)
{
    //  这里写具体实现
    Console.WriteLine("按下按键" + e.KeyValue + "," + e.KeyData + "," + e.KeyCode + "和控制键" + Control.ModifierKeys);
}

解释：

  • KeyCode：最为常用，记录了键盘上按了哪个键，当使用组合键时如ctrl+a，其值是”A”；

  • KeyData：可以记录组合键，当使用组合键时如ctrl+a时，其值为”A,ctrl”。注意：在这里与 KeyCode 相同

  • KeyValue则是KeyCode的数字值，当使用组合键时如ctrl+a时，其值为65（A），注意不是97（a）；

松开事件
private void hook_KeyUp(object sender, KeyEventArgs e)
{
    //  这里写具体实现
    Console.WriteLine("松开按键" + e.KeyValue + "," + e.KeyData + "," + e.KeyCode + "和控制键" + Control.ModifierKeys );
}

开始监听

// 开始监听
public void startListen()
{
    keyDownEventHandler = new KeyEventHandler(hook_KeyDown);
    keyUpEventHandler = new KeyEventHandler(hook_KeyUp);
    k_hook.KeyDownEvent += keyDownEventHandler;//钩住键按下
    k_hook.KeyUpEvent += keyUpEventHandler;//钩住键弹起
    k_hook.Start();//安装键盘钩子
}

停止监听

// 停止监听
public void stopListen()
{
    if (keyDownEventHandler != null)
    {
        k_hook.KeyDownEvent -= keyDownEventHandler;//取消按键事件
        keyDownEventHandler = null;
    }
    if(keyUpEventHandler != null)
    {
        k_hook.KeyUpEvent -= keyUpEventHandler;
    }
    if (keyDownEventHandler != null && keyUpEventHandler != null)
    {
        k_hook.Stop();//关闭键盘钩子
    }
}

结果

单独按住左ctrl不放手

第一次：
按下按键162,LControlKey,LControlKey和控制键None

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 是 None
之后是：
按下按键162,LControlKey,LControlKey和控制键Control

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 只能识别 ctrl键，不能识别左右
松开：
松开按键162,LControlKey,LControlKey和控制键Control

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 只能识别 ctrl键，不能识别左右

按一次ctrl+a

依次显示如下：

按下按键162,LControlKey,LControlKey和控制键None

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 是 None
按下按键65,A,A和控制键Control

总结：

  • e.KeyData 与 e.KeyCode 相同，都是 A，注意：即使按 小a，这里也显示 A
  • Control.ModifierKeys 是 Control，不能识别左右
松开按键65,A,A和控制键Control

总结：

  • e.KeyData 与 e.KeyCode 相同，都是 A，注意：即使按 小a，这里也显示 A
  • Control.ModifierKeys 是 Control，不能识别左右
松开按键162,LControlKey,LControlKey和控制键Control

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 只能识别 ctrl键，不能识别左右

按住ctrl+a

按下按键162,LControlKey,LControlKey和控制键None

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 是 None
按下按键162,LControlKey,LControlKey和控制键Control
按下按键162,LControlKey,LControlKey和控制键Control
......重复上一句

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 只能识别 ctrl键，不能识别左右
按下按键65,A,A和控制键Control
按下按键65,A,A和控制键Control
......重复上一句

总结：

  • e.KeyData 与 e.KeyCode 相同，都是 A，注意：即使按 小a，这里也显示 A
  • Control.ModifierKeys 是 Control，不能识别左右
松开按键65,A,A和控制键Control

总结：

  • e.KeyData 与 e.KeyCode 相同，都是 A，注意：即使按 小a，这里也显示 A
  • Control.ModifierKeys 是 Control，不能识别左右
松开按键162,LControlKey,LControlKey和控制键Control

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 只能识别 ctrl键，不能识别左右

按 ctrl+alt+F8

按下 ctrl 键，第一次显示：
按下按键162,LControlKey,LControlKey和控制键None

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 是 None
一直按下 ctrl 键，之后显示：
按下按键162,LControlKey,LControlKey和控制键Control
按下按键162,LControlKey,LControlKey和控制键Control
...重复上一句

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右ctrl键
  • Control.ModifierKeys 只能识别 ctrl键，不能识别左右
继续按下 alt 键，第一次显示
按下按键164,LMenu,LMenu和控制键Control

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右 alt键
    提示：此时 alt 键显示的是 LMenu
  • Control.ModifierKeys 只能识别 ctrl键，不能识别左右
一直按下 alt 键，之后显示
按下按键164,LMenu,LMenu和控制键Control, Alt
按下按键164,LMenu,LMenu和控制键Control, Alt
...重复上一句

总结：

  • e.KeyData 与 e.KeyCode 相同，能识别左右 alt键
    提示：此时 alt 键显示的是 LMenu
  • Control.ModifierKeys 只能识别 ctrl键、alt键，不能识别左右
继续按下 F8 键，显示
按下按键119,F8,F8和控制键Control, Alt
按下按键164,LMenu,LMenu和控制键Control, Alt
按下按键119,F8,F8和控制键Control, Alt
按下按键164,LMenu,LMenu和控制键Control, Alt
...重复上两句
松开 F8 键，显示
松开按键119,F8,F8和控制键Control, Alt
按下按键164,LMenu,LMenu和控制键Control, Alt
按下按键164,LMenu,LMenu和控制键Control, Alt
...重复上一句
松开 alt 键，显示
松开按键164,LMenu,LMenu和控制键Control, Alt
松开 ctrl 键，显示
松开按键162,LControlKey,LControlKey和控制键Control

参考：
https://blog.csdn.net/MieTuBrother/article/details/110132262

吉ICP备15003043号