使用PyInstaller --uac-uiaccess与Tkinter topmost=True时按钮错位

问题背景 #

我用Python和Tkinter开发无障碍应用，必须借助PyInstaller的--uac-uiaccess参数获取UI自动化的正常访问权限。

症状 #

同时启用--uac-uiaccess编译和Tkinter窗口的topmost=True时，所有UI元素（比如按钮）会错位显示在屏幕左上角，而非应用窗口内部。如果保留窗口装饰并启用置顶，UI元素会完全渲染在根窗口边界之外。

最小复现代码 #

import tkinter as tk
# 创建主窗口
root = tk.Tk()
root.title("Simple Buttons")
root.attributes('-topmost', True)  # 保持窗口置顶
# 创建容纳按钮的框架
button_frame = tk.Frame(root)
button_frame.pack(padx=10, pady=10)
# 创建8个按钮
button_texts = ["ON/OFF", "LEFT", "DOUBLE", "DRAG", "RIGHT", "SETUP", "MOVE", "EXIT"]
buttons = []
for text in button_texts:
    button = tk.Button(button_frame, text=text, width=8, height=2)
    button.pack(side=tk.LEFT, padx=2)
    buttons.append(button)
# 启动主循环
root.mainloop()

构建流程 #

• 创建自签名证书
• 使用PyInstaller搭配--uac-uiaccess编译
• 对可执行文件签名
• 安装至Program Files

已尝试的无效方案 #

• 添加显式的root.update()调用
• 使用update_idletasks()
• 使用框架作为容器
• 测试不同的窗口配置
• 仅禁用topmost时可正常运行
• 测试overrideredirect(True)时存在相同问题

环境 #

• Windows 11 24H2
• Python 3.13.3
• PyInstaller 6.13
• 内置Tkinter

解决方案 #

切换至Qt6（PySide6/PyQt6）可完全解决该问题。

使用PyInstaller的--uac-uiaccess参数时，Qt6的始终置顶功能可完美运行，无UI元素定位问题。这显然是Tkinter的topmost属性与PyInstaller的UAC访问功能之间的特定兼容性问题。

建议遇到类似问题的开发者，若应用同时需要UAC权限提升和始终置顶窗口，从Tkinter迁移至Qt6。

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