Python使用win32gui激活指定窗口及解决SetForegroundWindow报错

Cora

发布时间：2026-10-14| 3人浏览过

原创

本文介绍如何在Python中利用win32gui模块将指定窗口设为前台活动窗口。针对SetForegroundWindow常报的“找不到指定过程”错误，提供通过Dispatch WScript.Shell发送Alt键事件的解决方案，确保窗口置顶和最大化操作有效执行。

Python使用win32gui激活指定窗口及解决SetForegroundWindow报错

在Python程序运行过程中，如果同时打开了多个窗口，可以通过使用win32gui模块来将指定的某一个窗口设置为当前的活动窗口。


import re, time
import webbrowser
import win32gui, win32con, win32com.client
 
 
def _window_enum_callback(hwnd, wildcard):
  '''
  Pass to win32gui.EnumWindows() to check all the opened windows
  把想要置顶的窗口放到最前面，并最大化
  '''
  if re.match(wildcard, str(win32gui.GetWindowText(hwnd))) is not None:
    win32gui.BringWindowToTop(hwnd)
    # 先发送一个alt事件，否则会报错导致后面的设置无效：pywintypes.error: (0, 'SetForegroundWindow', 'No error message is available')
    shell = win32com.client.Dispatch("WScript.Shell")
    shell.SendKeys('%')
    # 设置为当前活动窗口
    win32gui.SetForegroundWindow(hwnd)
    # 最大化窗口
    win32gui.ShowWindow(hwnd, win32con.SW_MAXIMIZE)
 
 
if __name__ == '__main__':
  webbrowser.open("https://www.baidu.com/")
  time.sleep(1)
  win32gui.EnumWindows(_window_enum_callback, ".*%s.*" % config.window_name)#此处为你要设置的活动窗口名

这里需要特别说明一个常见的问题：

许多开发者（包括作者本人）可能会遇到如下错误提示：

pywintypes.error: (0, 'SetForegroundWindow', 'No error message is available')

Stack Overflow社区提供的解决方案是，在代码中增加以下部分：