能否通过代码为cv2窗口激活设置焦点，无需手动选中即可响应按键

问题本质 #

OpenCV 原生未提供设置窗口焦点的API，cv2.waitKey()仅在当前OpenCV窗口获得系统焦点时才会响应按键事件，仅设置窗口置顶无法触发按键响应，必须调用系统级接口主动激活窗口获得焦点，或采用全局按键监听绕过焦点限制。

方案1：调用系统接口激活窗口（分平台实现） #

Windows 平台 #

需要先安装pywin32依赖：
pip install pywin32
修改后代码示例：

import time
import win32gui
import win32con
from cv2 import cv2

WINDOW_TITLE = "image"

time.sleep(1)
image = cv2.imread("test.png", cv2.IMREAD_GRAYSCALE) 
cv2.imshow(WINDOW_TITLE, image)
cv2.setWindowProperty(WINDOW_TITLE, cv2.WND_PROP_TOPMOST, 1)
# 确保窗口渲染完成
cv2.waitKey(50)
# 获取窗口句柄并激活
hwnd = win32gui.FindWindow(None, WINDOW_TITLE)
if hwnd:
    win32gui.SetForegroundWindow(hwnd)
    win32gui.SetFocus(hwnd)

cv2.waitKey(0)
cv2.destroyAllWindows()

Linux 平台 #

需要先安装系统依赖xdotool：
sudo apt install xdotool
修改后代码示例：

import time
import subprocess
from cv2 import cv2

WINDOW_TITLE = "image"

time.sleep(1)
image = cv2.imread("test.png", cv2.IMREAD_GRAYSCALE) 
cv2.imshow(WINDOW_TITLE, image)
cv2.setWindowProperty(WINDOW_TITLE, cv2.WND_PROP_TOPMOST, 1)
cv2.waitKey(50)
# 调用xdotool激活窗口
subprocess.run(["xdotool", "search", "--name", WINDOW_TITLE, "windowactivate", "%@"])

cv2.waitKey(0)
cv2.destroyAllWindows()

macOS 平台 #

通过AppleScript实现窗口激活，无需额外安装依赖：

import time
import subprocess
from cv2 import cv2

WINDOW_TITLE = "image"

time.sleep(1)
image = cv2.imread("test.png", cv2.IMREAD_GRAYSCALE) 
cv2.imshow(WINDOW_TITLE, image)
cv2.setWindowProperty(WINDOW_TITLE, cv2.WND_PROP_TOPMOST, 1)
cv2.waitKey(50)
# 调用AppleScript激活窗口
script = f'tell application "System Events" to tell process "Python" to set frontmost of window whose title is "{WINDOW_TITLE}" to true'
subprocess.run(["osascript", "-e", script])

cv2.waitKey(0)
cv2.destroyAllWindows()

方案2：全局按键监听（跨平台通用，无需处理窗口焦点） #

如果不想适配不同系统的窗口接口，可以通过监听全局按键事件绕过焦点限制，只要程序在运行状态，任意按键都能触发关闭。需要安装pynput依赖：
pip install pynput
代码示例：

import time
import threading
from pynput import keyboard
from cv2 import cv2

exit_flag = False

def on_press(key):
    global exit_flag
    exit_flag = True
    return False

# 启动全局按键监听线程
listener = keyboard.Listener(on_press=on_press)
listener.start()

time.sleep(1)
image = cv2.imread("test.png", cv2.IMREAD_GRAYSCALE) 
cv2.imshow("image", image)
cv2.setWindowProperty("image", cv2.WND_PROP_TOPMOST, 1)

# 循环检测退出标志
while not exit_flag:
    # 10ms刷新一次窗口，避免无响应
    if cv2.waitKey(10) > 0:
        break

cv2.destroyAllWindows()
listener.stop()

注意事项 #

• 所有方案中调用激活窗口逻辑前添加的cv2.waitKey(50)是为了等待OpenCV窗口完全渲染，避免找不到窗口的问题，可根据实际设备性能调整延迟时长。
• 全局按键监听方案会捕获所有按键事件，若同时有其他输入操作需谨慎使用。

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