pywinauto无法识别QListWidgetItem关联Widget的子控件问题

一、如何在pywinauto中查看关联Widget下的所有子控件信息 #

可以通过以下几种方式深度排查控件树：

1. 调整print_control_identifiers的深度参数
   默认的print_control_identifiers()可能不会显示深层子控件，手动指定更大的depth值（比如depth=10），强制输出多级控件结构：

# 假设已获取到QListWidget的对象
list_widget.print_control_identifiers(depth=10)

2. 手动遍历控件后代
   获取到目标TestWidget对象后，使用descendants()方法遍历所有层级的子控件，打印关键属性确认：

# 先定位到TestWidget对象，比如通过automation_id或控件类型
test_widget = list_widget.child_window(auto_id="TestWidget", control_type="Pane")
# 遍历所有后代控件
for idx, ctrl in enumerate(test_widget.descendants()):
    print(f"[{idx}] 控件类型: {ctrl.control_type}, 自动化ID: {ctrl.automation_id()}, 文本: {ctrl.texts()}")

3. 配合系统工具验证
   使用Windows自带的Inspect.exe（可在Windows SDK中找到）直接查看UI控件树，确认这些QLabel和QPushButton是否被UIA框架识别。这一步能快速区分是pywinauto的遍历问题，还是控件本身未被无障碍框架暴露。

二、是否是QListWidget的无障碍支持问题导致 #

大概率是QT 5.14.2的无障碍（UIA）支持限制导致的：

• QListWidgetItem在UIA框架中默认被识别为单一的列表项元素，其内部自定义Widget（如你的TestWidget）的子控件不会自动被UIA暴露，pywinauto基于UIA后端自然无法识别。
• 解决这个问题需要在QT代码中手动配置无障碍属性：
  • 给TestWidget设置正确的无障碍角色，比如setAccessibleRole(QAccessible::GroupBox)；
  • 为内部的QLabel、QPushButton设置可识别的无障碍名称/描述，调用setAccessibleName()、setAccessibleDescription()；
  • 若自定义Widget结构复杂，可能需要重写QAccessible::interfaceForChild方法，手动注册子控件到无障碍框架中。

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