c# 全局监听键盘（键盘钩子） 作者：马育民 • 2024-08-11 21:57 • 阅读：10035 # 封装类 ``` 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 原文出处：https://malaoshi.top/show_1IX8Du1IGctH.html