模拟键盘输入
模拟键盘输入的功能需要依赖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则卸载成功。