使用win32gui设置窗口透明时SetLayeredWindowAttributes报参数错误

错误原因分析 #

报错pywintypes.error: (87, 'SetLayeredWindowAttributes', 'The parameter is incorrect.')通常由以下情况导致：

• 64位Python环境下仍使用32位的SetWindowLong函数，窗口样式设置异常
• 混用winxpgui和win32gui的API，引发常量或调用逻辑冲突
• 窗口句柄无效（未找到目标窗口）
• 参数组合不符合SetLayeredWindowAttributes的要求

修复步骤及代码 #

1. 先验证窗口句柄有效性 #

确认FindWindow确实找到了目标窗口，避免无效句柄引发后续错误。

2. 替换为64位兼容的窗口样式设置函数 #

64位系统下必须使用SetWindowLongPtr替代SetWindowLong，否则会导致样式设置失败。

3. 统一使用win32gui的SetLayeredWindowAttributes #

避免winxpgui和win32gui的API混用问题，确保常量和调用逻辑一致。

修复后的完整代码：

import win32gui
import win32con
import win32api

# 获取窗口句柄
hwnd = win32gui.FindWindow(None, "My App Name")
if not hwnd:
    print("未找到目标窗口")
else:
    # 设置窗口为分层样式（64位系统用SetWindowLongPtr）
    ex_style = win32gui.GetWindowLongPtr(hwnd, win32con.GWL_EXSTYLE)
    win32gui.SetWindowLongPtr(hwnd, win32con.GWL_EXSTYLE, ex_style | win32con.WS_EX_LAYERED)
    # 设置透明度（仅使用LWA_ALPHA时，crKey参数可传任意合法RGB值）
    win32gui.SetLayeredWindowAttributes(hwnd, win32api.RGB(0,0,0), 180, win32con.LWA_ALPHA)

额外说明 #

• 如果需要同时实现指定颜色透明和整体透明度，可以将最后一个参数改为win32con.LWA_COLORKEY | win32con.LWA_ALPHA，此时crKey指定的颜色会完全透明，同时叠加alpha透明度。
• 确保目标窗口支持分层样式：部分系统窗口或第三方应用可能不允许修改为分层窗口，这种情况下需要检查窗口是否具备修改权限，或尝试其他透明方案。

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