Tkinter中如何将CTkToplevel窗口居中显示在主窗口正中央

该方案不依赖硬编码坐标，兼容多显示器场景，无论主窗口移动到哪个屏幕、尺寸如何变化，都能保证顶层窗口居中显示在主窗口正中央。

核心实现逻辑是通过tkinter原生的窗口信息接口，实时获取主窗口和顶层窗口的真实位置、渲染尺寸，动态计算偏移坐标，完全不需要额外判断窗口所在的屏幕。

实现步骤 #

• 调用update_idletasks()强制刷新UI队列，避免CustomTkinter主题渲染延迟导致拿到的窗口尺寸、坐标不准确
• 通过winfo_x()、winfo_y()获取主窗口左上角相对于所在屏幕的绝对坐标，通过winfo_width()、winfo_height()获取主窗口渲染后的真实宽高
• 用同样的接口获取CTkToplevel顶层窗口自身的真实宽高
• 按公式计算顶层窗口的放置坐标：

  x轴偏移 = 主窗口x坐标 + (主窗口宽度 - 顶层窗口宽度) // 2
  y轴偏移 = 主窗口y坐标 + (主窗口高度 - 顶层窗口高度) // 2

• 调用顶层窗口的geometry()方法传入计算好的坐标完成定位

注意事项 #

• 不要使用winfo_screenwidth()、winfo_screenheight()这类获取全屏尺寸的接口，这类接口仅用于实现窗口相对于屏幕居中的场景，不适配相对父窗口居中的需求
• 如果需要实现主窗口拖动、缩放时，已打开的顶层窗口始终保持在主窗口中央，只需要给主窗口绑定<Configure>事件，事件触发时重新执行坐标计算和定位逻辑即可
• 多显示器场景下不需要额外编写屏幕判断逻辑，winfo系列接口会自动适配窗口所在屏幕的坐标体系，直接计算即可生效

可直接复用的代码示例 #

import customtkinter as ctk

def center_toplevel_on_parent(parent, toplevel):
    # 刷新待渲染的UI任务，获取准确的窗口参数
    toplevel.update_idletasks()
    parent.update_idletasks()

    # 读取父窗口实时位置、尺寸
    parent_x = parent.winfo_x()
    parent_y = parent.winfo_y()
    parent_width = parent.winfo_width()
    parent_height = parent.winfo_height()

    # 读取顶层窗口实时尺寸
    top_width = toplevel.winfo_width()
    top_height = toplevel.winfo_height()

    # 计算居中偏移
    offset_x = parent_x + (parent_width - top_width) // 2
    offset_y = parent_y + (parent_height - top_height) // 2

    # 应用位置
    toplevel.geometry(f"+{offset_x}+{offset_y}")


# 功能测试
if __name__ == "__main__":
    main_app = ctk.CTk()
    main_app.geometry("900x650")
    main_app.title("主窗口")

    def create_centered_toplevel():
        test_top = ctk.CTkToplevel(main_app)
        test_top.geometry("350x220")
        test_top.title("居中显示的顶层窗口")
        # 窗口弹出时居中
        center_toplevel_on_parent(main_app, test_top)

        # 取消下方注释即可实现主窗口移动/缩放时，顶层窗口始终跟随居中
        # main_app.bind("<Configure>", lambda e: center_toplevel_on_parent(main_app, test_top))

    ctk.CTkButton(
        main_app, 
        text="打开居中顶层窗口", 
        command=create_centered_toplevel
    ).pack(pady=30)

    main_app.mainloop()

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