You need to enable JavaScript to run this app. Python如何使用win32gui检测任意窗口最小化按钮的点击事件
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 17:45:07