如何在Tkinter中实现无Toplevel的自定义任务栏图标及悬停预览功能

前置依赖 #

该效果依赖Windows桌面窗口管理器(DWM)的原生能力，Tkinter原生没有提供对应接口，你需要先安装pywin32库调用Windows系统API：
pip install pywin32

实现核心逻辑 #

• 无需额外创建Toplevel窗口，直接基于主窗口的HWND（窗口句柄）和系统交互即可
• 任务栏图标直接和主窗口绑定，修改主窗口图标即可同步修改任务栏显示的图标
• 悬停预览失效通常出现在自定义窗口样式（比如隐藏默认标题栏）的场景下，需要通过DWM API强制系统正确渲染窗口缩略图

完整实现代码 #

import tkinter as tk
import win32gui
from ctypes import windll, c_int, c_void_p, sizeof

# 初始化DWM API
dwmapi = windll.dwmapi
DWMWA_FORCE_ICONIC_REPRESENTATION = 7
DWMWA_DISALLOW_PEEK = 11

root = tk.Tk()
root.title("自定义任务栏测试")
root.geometry("600x400")

# -------------------------- 1. 设置自定义任务栏图标 --------------------------
# 替换为你的本地ico文件路径即可，支持将png等格式转为ico使用
root.iconbitmap("custom_icon.ico")

# 获取主窗口句柄
hwnd = root.winfo_id()

# -------------------------- 2. 配置悬停预览正常显示 --------------------------
# 如果没有修改默认窗口样式，下面的配置代码可以省略
# 隐藏默认标题栏的示例代码（自定义标题栏时才需要开启）
# root.overrideredirect(True)

def enable_thumbnail_preview(hwnd):
    # 允许系统抓取窗口内容作为缩略图
    attr_val = c_int(0)
    dwmapi.DwmSetWindowAttribute(
        hwnd,
        DWMWA_DISALLOW_PEEK,
        c_void_p(attr_val),
        sizeof(c_int)
    )
    # 禁用强制图标表示，让系统显示窗口内容预览而非仅图标
    attr_val = c_int(0)
    dwmapi.DwmSetWindowAttribute(
        hwnd,
        DWMWA_FORCE_ICONIC_REPRESENTATION,
        c_void_p(attr_val),
        sizeof(c_int)
    )

enable_thumbnail_preview(hwnd)

# 测试用窗口内容，悬停任务栏图标时可预览到该内容
tk.Label(root, text="这是应用主体界面，悬停任务栏图标可以预览到本内容", font=("微软雅黑", 14)).pack(pady=150)

root.mainloop()

效果参考 #

注意事项 #

• 该方案仅适用于Windows系统，macOS和Linux的任务栏预览逻辑完全不同，需要调用对应系统的API实现
• 如果你要实现的是系统托盘（右下角通知区域的图标）而非任务栏窗口对应的图标，可以直接用pystray库实现，不需要依赖Toplevel

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