CustomTkinter中设置窗口图标的正确方法

在使用Python的CustomTkinter库开发GUI应用时，设置窗口图标是一个常见的需求。然而，许多开发者会遇到iconphoto方法不工作的问题，导致窗口图标无法正常显示。本文将详细介绍在CustomTkinter中正确设置窗口图标的方法。

问题现象

开发者尝试使用iconphoto方法设置窗口图标时，通常会遇到类似以下的错误：

_tkinter.TclError: failed to create an iconphoto with image ".\icons\tiny_logo.png"

解决方案

对于主窗口(root window)

正确的做法是结合使用wm_iconbitmap和iconphoto方法：

from PIL import ImageTk

# 创建PhotoImage对象
self.iconpath = ImageTk.PhotoImage(file='logo.png')

# 先调用wm_iconbitmap
self.wm_iconbitmap()

# 再设置iconphoto
self.iconphoto(False, self.iconpath)

对于子窗口(Toplevel)

对于Toplevel窗口，需要稍微不同的处理方式：

# 先调用wm_iconbitmap
self.wm_iconbitmap()

# 延迟设置iconphoto
self.after(300, lambda: self.iconphoto(False, self.iconpath))

技术原理

1. wm_iconbitmap的作用：这个方法会初始化窗口的图标系统，为后续设置图标做好准备。

2. iconphoto的参数：第一个参数False表示不将此图标设置为默认图标，第二个参数是要使用的图像对象。

3. Toplevel窗口的特殊处理：由于Toplevel窗口的初始化时序问题，需要延迟设置图标，否则可能不生效。

注意事项

1. 确保图像文件路径正确，最好使用绝对路径以避免路径解析问题。

2. 图像格式支持PNG、ICO等常见格式，但不同平台可能有不同限制。

3. 图像对象需要保持引用，否则可能被垃圾回收导致图标消失。

通过以上方法，可以可靠地在CustomTkinter应用中设置窗口图标，提升应用的专业性和用户体验。