OpenCV waitKeyEx()点击鼠标或按Tab后无法识别方向键的问题

我正在为实验室设备编写相机查看器，大部分显示控制通过键盘完成，少数操作需要鼠标。即便未添加鼠标事件处理程序，仍存在以下问题：使用方向键调整感兴趣区域（ROI）时功能正常，但在图像窗口任意位置点击鼠标或按下Tab键后，方向键失效，其他按键仍可正常识别。

复现代码：

import cv2
import numpy as np
cv2.namedWindow("window", flags=cv2.WND_PROP_AUTOSIZE+cv2.WINDOW_GUI_NORMAL)
img=np.zeros((100,100,3), np.uint8)   

while True:
    cv2.imshow("window", img) 
    key = cv2.waitKeyEx(1) #waitKeyEx returns the ASCII value of the key if there is one, otherwise the key code; 27=Esc.
    # Key codes depend on the backend hence the "or" for arrow keys & F1.  Linux first, Win10 (via VirtualBox) 2nd            
    # process keypresses.
    if (key==65361 or key==2424832):#left
        print ('left')                                    
    elif (key==65364 or key==2621440):#down
        print ('down')                                                            
    elif (key==65362 or key==2490368):#up
        print ('up')                                    
    elif (key==65363 or key==2555904):#right
        print ('right')                                                         
    elif (key == 27):#Esc
        break      
    else:
        if key >0:print ("key with ASCII code  %d not understood"%key)
cv2.destroyAllWindows()

运行环境：XFCE桌面环境，OpenCV 4.6.0基于QT5后端构建，Ubuntu 20.04 + Python 3.8.10，后续将部署到Windows系统。

这个问题源于OpenCV QT后端的焦点管理逻辑：点击窗口或按Tab后，窗口内的图像控件会失去键盘焦点，方向键事件被窗口的其他组件捕获，无法传递给waitKeyEx。以下是两种可行的解决方式：

方法1：强制重置窗口焦点 #

通过监听鼠标事件和Tab按键，在触发时将焦点重新拉回图像控件：

import cv2
import numpy as np

def on_mouse(event, x, y, flags, param):
    # 任意鼠标点击事件触发时，重置窗口焦点
    cv2.setWindowProperty("window", cv2.WND_PROP_FULLSCREEN, cv2.WINDOW_NORMAL)
    cv2.imshow("window", param)

cv2.namedWindow("window", flags=cv2.WND_PROP_AUTOSIZE+cv2.WINDOW_GUI_NORMAL)
img=np.zeros((100,100,3), np.uint8)   
cv2.setMouseCallback("window", on_mouse, img)

while True:
    cv2.imshow("window", img) 
    key = cv2.waitKeyEx(1)
    if (key==65361 or key==2424832):#left
        print ('left')                                    
    elif (key==65364 or key==2621440):#down
        print ('down')                                                            
    elif (key==65362 or key==2490368):#up
        print ('up')                                    
    elif (key==65363 or key==2555904):#right
        print ('right')                                                         
    elif (key == 27):#Esc
        break
    # 处理Tab键，同步重置焦点
    elif key == 9:
        cv2.setWindowProperty("window", cv2.WND_PROP_FULLSCREEN, cv2.WINDOW_NORMAL)
        cv2.imshow("window", img)
    else:
        if key >0:print ("key with ASCII code  %d not understood"%key)
cv2.destroyAllWindows()

核心逻辑是通过重新设置窗口属性并刷新图像，强制将焦点归还给图像控件，确保方向键事件能被waitKeyEx正常捕获。

方法2：更换窗口创建标志 #

如果不需要QT后端的GUI扩展功能，可以改用基础窗口标志，避免焦点管理问题：

# 创建窗口时使用基础标志，跳过QT的复杂交互组件
cv2.namedWindow("window", flags=cv2.WINDOW_NORMAL)

这种方法会简化窗口功能，但能避免焦点偏移问题，适合对窗口UI要求不高的场景。

以上两种方法在Windows环境下同样适用，Windows版OpenCV的QT后端存在相同的焦点管理逻辑，重置焦点的代码无需修改即可兼容。

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