pywayne-gui

Pywayne Gui

Windows 图形用户界面自动化工具，提供全局热键监听和窗口操作功能。

Quick Start

from pywayne.gui import GlobalHotKeys, GuiOperation

# 全局热键
g = GlobalHotKeys()

@g.register(GlobalHotKeys.VK_F1, GlobalHotKeys.MOD_SHIFT)
def shift_f1():
    print('Shift+F1 被按下')

# 启动监听（按 Q 或 Ctrl+C 退出）
GlobalHotKeys.listen()

Dependencies

包	用途	安装命令
pywin32	Windows API 封装	pip install pywin32
pyuserinput	键盘鼠标输入	pip install pyuserinput
pyautogui	GUI 自动化	pip install pyautogui

GlobalHotKeys - 全局热键

注册全局热键，在全局范围内监听键盘事件。

注册热键

from pywayne.gui import GlobalHotKeys

g = GlobalHotKeys()

# 装饰器方式注册
@g.register(GlobalHotKeys.VK_F1, GlobalHotKeys.MOD_SHIFT)
def shift_f1():
    print('Shift+F1')

# 组合键修饰符（支持组合使用）
g.register(GlobalHotKeys.VK_F1, GlobalHotKeys.MOD_CTRL | GlobalHotKeys.MOD_SHIFT)

# 直接调用 register 方法
def handler():
    print('Ctrl+A 被按下')
GlobalHotKeys.register(GlobalHotKeys.VK_A, GlobalHotKeys.MOD_CTRL, handler)

启动监听

# 启动消息循环，开始监听热键
GlobalHotKeys.listen()

停止条件

按以下任意组合键会停止监听循环：

• Q 键
• Ctrl + C

虚拟键码

常用虚拟键码（VK_*）：

按键	键码	组合键
A-Z	VK_A 到 VK_Z	ord('A') 到 ord('Z')
0-9	VK_0 到 VK_9	ord('0') 到 ord('9')
F1-F12	VK_F1 到 VK_F12	-

修饰键（MOD_*）：

修饰键	常量
Alt	MOD_ALT
Ctrl	MOD_CTRL
Shift	MOD_SHIFT
Win	MOD_WIN

修饰键可使用 | 组合，如 MOD_CTRL | MOD_SHIFT。

GuiOperation - 窗口操作

提供 Windows 窗口查找、控制和操作功能。

初始化

from pywayne.gui import GuiOperation

gui = GuiOperation()

find_window

查找包含指定关键字的窗口，返回窗口句柄列表。

# 查找包含"记事本"的窗口
notepad_handles = gui.find_window('记事本')

# 查找包含"微信"的窗口
wechat_handles = gui.find_window('微信')

# 多关键字匹配
handles = gui.find_window('Visual', 'Studio')

参数说明：

• *keys: 按关键字匹配窗口标题

返回值：

• 匹配的窗口句柄列表（hwnd）
• 未找到时返回空列表

get_windows_attr

获取指定窗口的属性信息。

hwnd = gui.find_window('记事本')[0]
title, class_name = gui.get_windows_attr(hwnd)
print(f"窗口标题: {title}")
print(f"窗口类名: {class_name}")