You need to enable JavaScript to run this app. Tkinter:如何设置供Windows Application Driver测试的控件属性名
优惠活动
大模型
产品
解决方案
定价
更多

Tkinter:如何设置供Windows Application Driver测试的控件属性名

Tkinter UI测试可识别属性名配置方法

以下是可在Windows Application Driver、Accessibility Insights工具中被正确识别的属性配置方案:

  • 方案1:显式声明控件name属性并开启辅助功能暴露
    创建控件时直接传入name参数定义唯一标识,同时开启控件的辅助功能可见属性,示例代码:
import tkinter as tk
root = tk.Tk()
# 定义控件时传入name参数,同时设置takefocus强制暴露到辅助树
submit_btn = tk.Button(root, text="确认", name="confirm_button", takefocus=True)
submit_btn.pack()
root.mainloop()

配置完成后可在Accessibility Insights的UIA树中查看AutomationId字段,对应你设置的name值,WinAppDriver可通过find_element_by_accessibility_id方法直接定位。

  • 方案2:调用Windows API手动设置UIA可识别名称
    如果旧版本Tkinter的name属性无法被识别,可以通过ctypes调用系统API给控件句柄设置可访问名称,示例代码:
import tkinter as tk
import ctypes
from ctypes import wintypes

user32 = ctypes.WinDLL("user32", use_last_error=True)
WM_SETTEXT = 0x000C

def set_uia_name(widget, custom_name):
    hwnd = widget.winfo_id()
    user32.SendMessageW(hwnd, WM_SETTEXT, 0, custom_name)

# 调用示例
root = tk.Tk()
login_btn = tk.Button(root, text="登录")
login_btn.pack()
# 设置自定义UIA名称
set_uia_name(login_btn, "login_button")
root.mainloop()

设置后可在Accessibility Insights的Name字段看到你配置的自定义名称,直接用于WinAppDriver的name定位。

  • 方案3:多属性组合定位兜底
    如果无法修改控件源码配置属性,可以组合使用控件类型、显示文本、父控件层级、相对坐标等属性联合定位,无需额外修改控件代码。

注意:请将Tkinter版本升级到8.6及以上,旧版本对Windows UIA辅助树的支持存在缺陷,会导致属性无法被识别。

内容的提问来源于stack exchange,提问作者Woden

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 19:18:05