C#模拟键盘输入、键状态和监听键盘消息

模拟键盘输入

模拟键盘输入的功能需要依赖Windows函数实现，这个函数是SendInput，它是专门用来模拟键盘、鼠标等设备输入的函数。

另外和键盘输入相关的函数还有SendKeys，它是System.Windows.Forms. SendKeys，只能在WinFrom项目中使用，并且它的所有功能都可以由SendInput来实现。

另一个是keybd_event函数，这个函数依然是有用的，但是目前官方已经推荐使用SendInput替代它了。

SendInput的定义

[DllImport("user32.dll")] static extern uint SendInput(int nInputs,INPUT[] pInputs,int cbSize);

INPUT对象中保存了输入内容，nInputs和cbSize代表pInputs的长度和INPUT结构的大小，这两个参数能帮助SendInput正确解析INPUT对象。返回值0表示失败，非零表示正确执行。

 

INPUT的定义

[StructLayout(LayoutKind.Sequential)] struct KEYBDINPUT {     public ushort wVk;     public ushort wScan;     public uint dwFlags;     public uint time;     public IntPtr dwExtraInfo; } [StructLayout(LayoutKind.Sequential)] struct HARDWAREINPUT {     public uint uMsg;     public ushort wParamL;     public ushort wParamH; } [StructLayout(LayoutKind.Sequential)] struct MOUSEINPUT {     public int dx;     public int dy;     public uint mouseData;     public uint dwFlags;     public uint time;     public IntPtr dwExtraInfo; } [StructLayout(LayoutKind.Explicit)] struct MOUSEKEYBDHARDWAREINPUT {     [FieldOffset(0)]     public HARDWAREINPUT hi;     [FieldOffset(0)]     public KEYBDINPUT ki;     [FieldOffset(0)]     public MOUSEINPUT mi; } [StructLayout(LayoutKind.Sequential)] struct INPUT {     public uint type;     public MOUSEKEYBDHARDWAREINPUT mkhi; }

INPUT结构中的type表示消息类型，值为1表示键盘消息。mkhi表示具体的消息内容，它可以模拟三类消息，其中键盘消息使用KEYBDINPUT表示，其它消息类型的结构不在这里介绍（虽然用不到MOUSEINPUT等结构，但是它们的定义不能省略，否则SendInput无法正确解析INPUT中的具体内容）。

⩥FieldOffset(0)将三个结构的起始都放在0位置，所以只能使用其中一个内容，因为一个INPUT也只能表示一个消息，这样设计可以节省空间。

KEYBDINPUT结构中的wVK表示虚拟键码 ，dwFlags的第一位bit默认0表示键盘按下事件，1表示键盘释放事件。

虚拟键码是一种能让Windows以与设备无关的方式处理键盘的技术，可以简单理解为：键盘上的每个键用一个数字来表示。

 

模拟A键

INPUT[] inputs = new INPUT[2]; inputs[0]=new INPUT {     type=1,     mkhi=new MOUSEKEYBDHARDWAREINPUT {         ki=new KEYBDINPUT {             wVk=0x41         }     } }; inputs[1]=new INPUT {     type=1,     mkhi=new MOUSEKEYBDHARDWAREINPUT {         ki=new KEYBDINPUT {             wVk=0x41,             dwFlags=2         }     } }; SendInput(inputs.Length,inputs,Marshal.SizeOf(inputs[0]));

A键的虚拟键码是0x41。type=1表示这是键盘消息，dwFlags=2表示键盘释放事件。

这里INPUT数组模拟的就是使用物理键盘A键的过程。inputs[0]模拟A键按下，inputs[1]模拟A键释放。

 

模拟Ctrl+A

INPUT[] inputs = new INPUT[4]; inputs[0]=new INPUT {     type=1,     mkhi=new MOUSEKEYBDHARDWAREINPUT {         ki=new KEYBDINPUT {             wVk=0x11         }     } }; inputs[1]=new INPUT {     type=1,     mkhi=new MOUSEKEYBDHARDWAREINPUT {         ki=new KEYBDINPUT {             wVk=0x41         }     } }; inputs[2]=new INPUT {     type=1,     mkhi=new MOUSEKEYBDHARDWAREINPUT {         ki=new KEYBDINPUT {             wVk=0x41,             dwFlags=2         }     } }; inputs[3]=new INPUT {     type=1,     mkhi=new MOUSEKEYBDHARDWAREINPUT {         ki=new KEYBDINPUT {             wVk=0x11,             dwFlags=2,         }     } }; SendInput(inputs.Length,inputs,Marshal.SizeOf(inputs[0]));

0x11是Ctrl的虚拟键码，这里模拟了按下Ctrl键,按下A键，释放A键，释放Ctrl键的过程，实现了Ctrl+A的组合键效果。

 

SendInput除了能模拟击键消息外还可以在文本输入中模拟字符消息。

KEYBDINPUT结构的wScan表示字符内容，将dwFlags的第二位bit置1表示使用wScan属性而非wVK。

文本输入

string ntext = "你好"; INPUT[] inputs = new INPUT[ntext.Length*2]; for(int i = 0;i<ntext.Length;i++) {     ushort ch = ntext[i];     inputs[i*2]=new INPUT {         type=1,         mkhi=new MOUSEKEYBDHARDWAREINPUT {             ki=new KEYBDINPUT {                 wScan=ch,                 dwFlags=4             }         }     };     inputs[i*2+1]=new INPUT {         type=1,         mkhi=new MOUSEKEYBDHARDWAREINPUT {             ki=new KEYBDINPUT {                 wScan=ch,                 dwFlags=4|2             }         }     }; } SendInput(inputs.Length,inputs,Marshal.SizeOf(inputs[0]));

 

键状态

有时需要知道键盘按键的当前状态，可以使用GetKeyState函数。

GetKeyState的定义

[DllImport("user32.dll")] static extern short GetKeyState(int VKey);

参数是键的虚拟码，对于开关键（Caps Look、Num Lock和Scroll Lock），返回值1表示开启状态。对于其它键返回负数表示按下状态。

CapsLock键状态

short iState = GetKeyState(0x14);

 

监听键盘消息

对于WinForm和WPF程序，要监听输入到本程序的键盘消息直接使用窗口的KeyDown和KeyUp事件即可。

对于其它键盘消息（即给本程序以外的键盘消息），需要使用钩子（hook）。

钩子是Windows系统消息处理机制中的一个节点，可以安装钩子来监听系统中的Windows消息。

Windows消息分很多种，对于特定的一类消息需要使用对应的特定类型的钩子，这里只介绍键盘消息的钩子。

钩子的安装需要调用系统SetWindowsHookEx方法。

 

SetWindowsHookEx的定义

[DllImport("user32.dll")] static extern IntPtr SetWindowsHookEx(int idHook, HookProc lpfn, IntPtr hmod, int threadID);

idHook等于13表示全局键盘消息钩子，lpfn代表键盘消息处理程序，返回非IntPtr.Zero表示安装成功。

 

安装钩子

delegate int HookProc(int code,IntPtr wParam,IntPtr lParam); static HookProc KeyboardProc; static void InstallKeyboardHook() {     KeyboardProc=KeyboardHookCallback;     pKeyboardHook=SetWindowsHookEx(13,keyboardProc,IntPtr.Zero,0); }

KeyboardHookCallback就是自定义的具体处理键盘消息的方法。

 

消息处理

[DllImport("user32.dll")] static extern int CallNextHookEx(IntPtr hhk, int nCode, IntPtr wParam, IntPtr lParam); static int KeyboardHookCallback(int code,IntPtr wParam,IntPtr lParam) {     if(code<0)         return CallNextHookEx(IntPtr.Zero,code,wParam,lParam);     int vkCode = Marshal.ReadInt32(lParam);     System.Diagnostics.Debug.Write(vkCode+" ");     long downup = (long)wParam;     switch(downup) {         case 256:             System.Diagnostics.Debug.WriteLine("down");             break;         case 257:             System.Diagnostics.Debug.WriteLine("up");             break;         case 260:             System.Diagnostics.Debug.WriteLine("sys_down");             break;         case 261:             System.Diagnostics.Debug.WriteLine("sys_up");             break;      }      return CallNextHookEx(IntPtr.Zero,code,wParam,lParam); }

从lParam中读取键的虚拟码（lParam其实是指向类似前文提到的KEYBDINPUT结构的指针），wParam表示击键事件的类型。CallNextHookEx将消息传递给下一个消息处理节点。

⩥使用前文提到的SendInput方法模拟键盘输入也能被钩子监听到。

⩥应避免在消息处理过程中进行耗时操作。

 

卸载钩子需要使用UnhookWindowsHookEx

UnhookWindowsHookEx的定义

[DllImport("user32.dll")] static extern bool UnhookWindowsHookEx(IntPtr pHookHandle);

传入SetWindowsHookEx的返回值即可，返回true则卸载成功。