鼠标悬停显示Tooltip致pywinauto抛出ElementAmbiguousError求助

问题原因 #

当Tooltip弹出后，它会成为目标进程下的一个UI元素，导致原有的定位条件（仅匹配进程和后端）同时命中「Select Folder」窗口和Tooltip，触发ElementAmbiguousError。

解决方案 #

1. 优化控件定位条件，排除Tooltip干扰 #

Tooltip的control_type为ToolTip，和目标窗口的Window类型不同，通过更精确的筛选可避免歧义：

方法A：精准筛选窗口类型

# 筛选进程下所有Window类型的窗口，取标题匹配的第一个
windows = katApp.windows(backend='uia', process=19852, control_type="Window")
openDlg = [w for w in windows if w.window_text() == "Select Folder"][0]

方法B：用lambda表达式限定匹配规则

openDlg = katApp.child_window(
    lambda c: c.window_text() == "Select Folder" and c.control_type() == "Window",
    found_index=0
)

2. 避免鼠标触发Tooltip #

脚本中click_input()、draw_outline()这类操作会移动真实鼠标到控件位置，容易触发Tooltip，可通过以下方式规避：

方法A：使用后台模拟点击

替换click_input()为click()，后者是后台操作，不会移动真实鼠标：

btnSelectFolder.click()  # 替代 btnSelectFolder.click_input()

方法B：提前移开鼠标

在操作控件前，将鼠标移至屏幕角落，远离对话框区域：

from pywinauto.mouse import move

# 移到屏幕左上角，避免悬停在对话框元素上
move((0, 0))

# 执行后续控件操作
txtFolder.type_keys(projectPath + "~", with_spaces=True)
btnSelectFolder.click_input()

3. 临时修改系统鼠标悬停时间（脚本级生效） #

之前修改注册表未生效，是因为缺少发送系统设置变更消息的步骤，以下是临时修改并恢复的完整代码：

import winreg
import ctypes

# 保存原始鼠标悬停时间
key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Control Panel\Mouse", 0, winreg.KEY_READ)
original_hover_time, _ = winreg.QueryValueEx(key, "MouseHoverTime")
winreg.CloseKey(key)

# 设置为10秒（基本不会触发Tooltip）
key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Control Panel\Mouse", 0, winreg.KEY_WRITE)
winreg.SetValueEx(key, "MouseHoverTime", 0, winreg.REG_SZ, "10000")
winreg.CloseKey(key)

# 发送消息让系统立即生效
ctypes.windll.user32.SendMessageW(0xFFFF, 0x001A, 0, r"Control Panel\Mouse")

# ----------------------
# 此处放置你的自动化脚本代码
# ----------------------

# 脚本结束后恢复原始设置
key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Control Panel\Mouse", 0, winreg.KEY_WRITE)
winreg.SetValueEx(key, "MouseHoverTime", 0, winreg.REG_SZ, original_hover_time)
winreg.CloseKey(key)
ctypes.windll.user32.SendMessageW(0xFFFF, 0x001A, 0, r"Control Panel\Mouse")

4. 等待窗口稳定后再操作 #

在定位子控件前，先等待目标窗口完全加载，避免Tooltip未消失时进行定位：

# 等待Select Folder窗口出现并稳定
openDlg = katApp.wait_window(title="Select Folder", control_type="Window", timeout=10)

# 窗口稳定后再定位子控件
txtFolder = openDlg.child_window(title="Folder:", control_type="Edit")
txtFolder.draw_outline(colour='green', thickness=2)
txtFolder.type_keys(projectPath + "~", with_spaces=True)

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