如何检测Windows系统中tkinter窗口是否处于可见状态？

Tkinter自带的winfo_ismapped()或Map/Unmap事件只能判断窗口是否处于映射状态（即是否显示、未被最小化/隐藏），无法检测窗口被其他应用遮挡的情况。要实现遮挡检测，必须调用Windows原生API，以下是具体方案：

核心思路 #

通过Windows的user32.dll和dwmapi.dll提供的API，结合以下步骤判断：

1. 排除窗口最小化、隐藏的情况；
2. 获取窗口的可见区域，对比可见区域面积与窗口原始面积，判断是否被遮挡；
3. 对不支持DWM的旧系统， fallback到判断窗口是否为前台窗口。

实现代码 #

import ctypes
from ctypes import wintypes
import tkinter as tk

# 加载Windows系统库
user32 = ctypes.WinDLL('user32', use_last_error=True)
dwmapi = ctypes.WinDLL('dwmapi', use_last_error=True)

# 定义API所需的结构体和常量
DWMWA_VISIBLE_REGION = 7

class RECT(ctypes.Structure):
    _fields_ = [("left", wintypes.LONG),
                ("top", wintypes.LONG),
                ("right", wintypes.LONG),
                ("bottom", wintypes.LONG)]

class HRGN(ctypes.c_void_p):
    pass

def is_window_fully_obscured(hwnd):
    # 1. 判断窗口是否最小化
    if user32.IsIconic(hwnd):
        return True
    # 2. 判断窗口是否可见（未被隐藏）
    if not user32.IsWindowVisible(hwnd):
        return True
    # 3. 通过DWM获取窗口可见区域
    hrgn = HRGN()
    dwm_result = dwmapi.DwmGetWindowAttribute(
        hwnd, DWMWA_VISIBLE_REGION, ctypes.byref(hrgn), ctypes.sizeof(hrgn)
    )
    if dwm_result != 0:
        # DWM不可用（如Windows XP）， fallback到判断是否为前台窗口
        return user32.GetForegroundWindow() != hwnd
    # 4. 计算可见区域面积
    visible_rect = RECT()
    if user32.GetRgnBox(hrgn, ctypes.byref(visible_rect)) == 0:
        # 可见区域为空，说明完全被遮挡
        user32.DeleteObject(hrgn)
        return True
    # 5. 计算窗口原始面积
    window_rect = RECT()
    user32.GetWindowRect(hwnd, ctypes.byref(window_rect))
    window_area = (window_rect.right - window_rect.left) * (window_rect.bottom - window_rect.top)
    # 6. 对比可见面积与原始面积（阈值可调整）
    visible_area = (visible_rect.right - visible_rect.left) * (visible_rect.bottom - visible_rect.top)
    user32.DeleteObject(hrgn)
    # 当可见面积小于原始面积的10%时，认为完全被遮挡
    return visible_area < window_area * 0.1

# Tkinter测试示例
if __name__ == "__main__":
    root = tk.Tk()
    root.title("遮挡检测测试")
    root.geometry("400x300")

    def check_visibility():
        hwnd = root.winfo_id()
        is_obscured = is_window_fully_obscured(hwnd)
        status_label.config(text=f"窗口是否完全被遮挡: {'是' if is_obscured else '否'}")
        root.after(1000, check_visibility)

    status_label = tk.Label(root, text="等待检测...", font=("Arial", 12))
    status_label.pack(pady=50)

    root.after(1000, check_visibility)
    root.mainloop()

关键说明 #

• DWM依赖：DwmGetWindowAttribute仅支持Windows Vista及以上系统，旧系统会自动切换到前台窗口判断逻辑；
• 阈值调整：代码中用10%的面积阈值判断“完全被遮挡”，如果需要检测任何遮挡，可将阈值改为visible_area < window_area；
• 资源清理：获取的区域句柄HRGN必须用DeleteObject释放，避免内存泄漏；
• 前台窗口判断：仅作为 fallback方案，因为后台窗口也可能部分可见，该方案无法区分部分遮挡和完全遮挡。

内容的提问来源于stack exchange，提问作者ChocolaToni