PyHook3简明教程

PyHook底层还是使用windows API实现，而我们可以直接拿来用的相关函数定义都在PythonLibsite-packagesPyHook3下的HookManager.py文件中。
因为官方并没给出一个API文档，所以我自己看了一下源文件，发现其实PyHook的方法很少，用法也很简单，基本上example.py中大概都给出了。下面也是通过对example.py给出的例子的解析来了解编写过程。

1. 创建HookManager对象

import PyHook3

hm = PyHook3.HookManager()

之后的操作都是基于这个Manager对象进行。

2. 编写事件处理函数

事件处理函数需要传入一个HookEvent对象，这个类有两个子类，一个为鼠标事件MouseEvent，还有一个为键盘事件KeyboardEvent，分别为当触发相应事件时由系统传入。
MouseEvent及KeyboardEvent又分别有多个属性，代表所触发事件的具体信息。example.py已经列出了所有属性，通过对example.py例子的注释，大概就能清楚了：

# 鼠标事件处理函数
def OnMouseEvent(event):
  print('MessageName:',event.MessageName)  #事件名称
  print('Message:',event.Message)          #windows消息常量 
  print('Time:',event.Time)                #事件发生的时间戳        
  print('Window:',event.Window)            #窗口句柄         
  print('WindowName:',event.WindowName)    #窗口标题
  print('Position:',event.Position)        #事件发生时相对于整个屏幕的坐标
  print('Wheel:',event.Wheel)              #鼠标滚轮
  print('Injected:',event.Injected)        #判断这个事件是否由程序方式生成，而不是正常的人为触发。
  print('---')

  # 返回True代表将事件继续传给其他句柄，为False则停止传递，即被拦截
  return True

#键盘事件处理函数
def OnKeyboardEvent(event):
  print('MessageName:',event.MessageName)          #同上，共同属性不再赘述
  print('Message:',event.Message)
  print('Time:',event.Time)
  print('Window:',event.Window)
  print('WindowName:',event.WindowName)
  print('Ascii:', event.Ascii, chr(event.Ascii))   #按键的ASCII码
  print('Key:', event.Key)                         #按键的名称
  print('KeyID:', event.KeyID)                     #按键的虚拟键值
  print('ScanCode:', event.ScanCode)               #按键扫描码
  print('Extended:', event.Extended)               #判断是否为增强键盘的扩展键
  print('Injected:', event.Injected)
  print('Alt', event.Alt)                          #是某同时按下Alt
  print('Transition', event.Transition)            #判断转换状态
  print('---')

  # 同上
  return True

如果想了解具体含义，可以参考windows编程中的相关消息及参数含义。

3. 绑定事件处理函数

hm.MouseAllButtonsDown = OnMouseEvent #将OnMouseEvent函数绑定到MouseAllButtonsDown事件上
hm.KeyDown = OnKeyboardEvent          #将OnKeyboardEvent函数绑定到KeyDown事件上

除此之外，还有以下事件：
鼠标事件：
MouseAll
MouseAllButtons
MouseAllButtonsUp
MouseAllButtonsDown
MouseAllButtonsDbl
MouseWheel
MouseMove
MouseLeftUp
MouseLeftDown
MouseLeftDbl
MouseRightUp
MouseRightDown
MouseRightDbl
MouseMiddleUp
MouseMiddleDown
MouseMiddleDbl
键盘事件：
KeyUp
KeyDown
KeyChar
KeyAll
因为都可以顾名思义，也就不再做注释。

4. 设置钩子

hm.HookMouse()        #设置鼠标钩子
hm.HookKeyboard()   #设置键盘钩子

5. 循环监听

对于命令行界面的编程，设置了钩子后还不够，因为脚本在成功挂钩后，就结束运行了。这个时候就需要使程序进入循环监听系统事件的状态。
比较简单的方法是使用Win32 Extensions package提供的PumpMessages()方法：

  import pythoncom
  pythoncom.PumpMessages()

但是这个函数不是PyHook编程中必需的。如果是基于某些GUI库的编程，则不需要这样，因为GUI库本身就具有监听消息循环的机制。

6. 取消钩子

hm.UnhookMouse()    #取消鼠标钩子
hm.UnhookKeyboard() #取消键盘钩子