使用Python/Windows API设置窗口置顶失败，求解决方案

我正在编写一段代码，用于查找目标窗口（返回其句柄）、将其置于顶层并设置为置顶窗口，但遇到无法成功设置置顶的问题。代码如下：

HWND_TOPMOST = -1
SWP_NOSIZE = 1
SWP_NOMOVE = 2
hwnd = ctypes.windll.user32.FindWindowW(None, title) # works OK
ctypes.windll.user32.BringWindowToTop(hwnd) # works OK
ctypes.windll.user32.SetWindowPos(hwnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE) # doesn't work

注：我无法安装第三方库或模块，只能使用Python原生模块和/或Windows API。

解决方案 #

1. 修复ctypes参数类型不匹配问题 #

直接调用ctypes.windll.user32时，未指定API的参数和返回值类型，Windows API可能因类型解析错误拒绝执行。你需要明确声明函数的类型信息：

import ctypes
from ctypes import wintypes

# 定义Windows API官方常量值
HWND_TOPMOST = wintypes.HWND(-1)
SWP_NOSIZE = 0x0001
SWP_NOMOVE = 0x0002
SWP_SHOWWINDOW = 0x0040  # 可选，确保窗口处于显示状态

# 绑定user32库并声明函数类型
user32 = ctypes.WinDLL('user32', use_last_error=True)
# 声明FindWindowW的参数和返回值类型
user32.FindWindowW.argtypes = [wintypes.LPCWSTR, wintypes.LPCWSTR]
user32.FindWindowW.restype = wintypes.HWND
# 声明SetWindowPos的参数和返回值类型
user32.SetWindowPos.argtypes = [
    wintypes.HWND, wintypes.HWND,
    wintypes.INT, wintypes.INT,
    wintypes.INT, wintypes.INT,
    wintypes.UINT
]
user32.SetWindowPos.restype = wintypes.BOOL
# 声明BringWindowToTop的参数和返回值类型
user32.BringWindowToTop.argtypes = [wintypes.HWND]
user32.BringWindowToTop.restype = wintypes.BOOL

# 实际调用逻辑
title = "你的目标窗口标题"
hwnd = user32.FindWindowW(None, title)
if hwnd != 0:
    user32.BringWindowToTop(hwnd)
    # 调用SetWindowPos，追加SWP_SHOWWINDOW确保窗口可见
    success = user32.SetWindowPos(hwnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW)
    if not success:
        # 可选：获取错误码排查问题
        error_code = ctypes.get_last_error()
        print(f"SetWindowPos调用失败，错误码：{error_code}")
else:
    print("未找到目标窗口")

2. 检查运行权限 #

如果目标窗口是用管理员权限启动的，你的Python脚本也必须以管理员权限运行，否则无法修改该窗口的置顶属性。

3. 确认窗口句柄有效性 #

即使FindWindowW返回非0值，也建议在调用后续API前检查hwnd是否为0，避免因窗口已关闭导致的无效句柄问题。

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