Python如何使用win32gui检测任意窗口最小化按钮的点击事件
Python通过win32gui检测窗口最小化按钮点击实现指南
核心逻辑
WM_NCHITTEST是Windows原生窗口消息,数值为0x0084。鼠标在窗口区域触发点击动作前,系统会向窗口发送该消息询问点击位置对应的窗口区域,返回值为HTMINBUTTON(固定值9)时即代表点击命中最小化按钮。
场景1:检测Python自建窗口的最小化点击
这种场景不需要钩子,直接在自定义窗口的消息处理函数中拦截WM_NCHITTEST消息即可,示例代码如下:
import win32gui import win32con import win32api def wnd_proc(hwnd, msg, wparam, lparam): if msg == win32con.WM_NCHITTEST: # 调用默认窗口过程获取命中结果 hit_result = win32gui.DefWindowProc(hwnd, msg, wparam, lparam) if hit_result == win32con.HTMINBUTTON: print("最小化按钮被点击") # 自定义业务逻辑写在这里 return hit_result elif msg == win32con.WM_DESTROY: win32gui.PostQuitMessage(0) return 0 else: return win32gui.DefWindowProc(hwnd, msg, wparam, lparam) # 注册窗口类 wc = win32gui.WNDCLASS() wc.lpfnWndProc = wnd_proc wc.lpszClassName = "TestWindowClass" wc.hbrBackground = win32con.COLOR_WINDOW + 1 class_atom = win32gui.RegisterClass(wc) # 创建窗口 hwnd = win32gui.CreateWindow( class_atom, "测试窗口", win32con.WS_OVERLAPPEDWINDOW, 100, 100, 400, 300, 0, 0, win32api.GetModuleHandle(None), None ) # 显示窗口 win32gui.ShowWindow(hwnd, win32con.SW_SHOW) # 消息循环 win32gui.PumpMessages()
场景2:检测系统任意第三方窗口的最小化点击
这种场景需要用到Windows的WH_GETMESSAGE钩子监听系统所有窗口消息,示例代码如下:
import win32gui import win32con import win32api import ctypes from ctypes import wintypes user32 = ctypes.WinDLL('user32', use_last_error=True) # 定义钩子回调函数类型 CMPFUNC = ctypes.CFUNCTYPE(ctypes.c_int, ctypes.c_int, wintypes.WPARAM, wintypes.LPARAM) hook_id = None def hook_proc(nCode, wParam, lParam): if nCode >= 0 and wParam == win32con.PM_REMOVE: msg = ctypes.cast(lParam, ctypes.POINTER(wintypes.MSG)).contents if msg.message == win32con.WM_NCHITTEST: # 获取消息处理结果 hit_res = win32gui.SendMessage(msg.hwnd, msg.message, msg.wParam, msg.lParam) if hit_res == win32con.HTMINBUTTON: window_title = win32gui.GetWindowText(msg.hwnd) print(f"窗口[{window_title}]的最小化按钮被点击") return user32.CallNextHookEx(hook_id, nCode, wParam, lParam) # 安装钩子 hook_func = CMPFUNC(hook_proc) hook_id = user32.SetWindowsHookExW(win32con.WH_GETMESSAGE, hook_func, win32api.GetModuleHandle(None), 0) if not hook_id: raise ctypes.WinError(ctypes.get_last_error()) try: print("正在监听最小化按钮点击,按Ctrl+C退出") win32gui.PumpMessages() except KeyboardInterrupt: pass finally: # 释放钩子 user32.UnhookWindowsHookEx(hook_id)
注意事项
- 需提前安装依赖:
pip install pywin32 - 检测第三方窗口时,脚本需要以管理员权限运行,且Python解释器位数和目标窗口位数必须一致(32位Python仅能检测32位窗口,64位同理)
- 钩子使用完毕必须主动释放,避免占用系统资源导致卡顿
内容的提问来源于stack exchange,提问作者Ahmed
相关产品推荐
相关产品推荐

