如何在pywin32中调用AnimateWindow()实现Delphi同款窗口隐藏动画？

需求概述 #

想用Python的pywin32模块调用Windows API的AnimateWindow()函数，实现如下Delphi代码的功能：

目标Delphi代码 #

var
   hWind: HWND;

begin
   Label1.Caption := 'function: AnimateWindow';
   Label1.Font.Size := 15;

   hWind := Form1.Handle;
   If (AnimateWindow(hWind, 1500, AW_HIDE) = True) Then
       Edit1.Text := 'Done'
   Else
   Begin
       Edit1.Text := 'ERROR';
       Edit2.Text := IntToStr(GetLastError());
   End;
end;

问题代码 #

尝试的Python代码无法正常运行，代码如下：

import win32gui


hwnd = win32gui.FindWindow(None, "Untitled - Notepad")
win32gui.AnimateWindow(hwnd, 1500,0x00010000, True)
bbox = win32gui.GetWindowRect(hwnd)

排查与修复方案 #

1. 参数不匹配：pywin32封装的AnimateWindow函数不需要第四个布尔参数，原生Windows API的签名是BOOL AnimateWindow(HWND hWnd, DWORD dwTime, DWORD dwFlags);，你额外传入的True属于无效参数。
2. 句柄有效性校验：先确认FindWindow是否成功获取到窗口句柄，避免对无效句柄调用API。
3. 错误捕获与排查：添加错误码获取逻辑，方便定位问题。

修正后的代码：

import win32gui
import win32api

# 获取目标窗口句柄
hwnd = win32gui.FindWindow(None, "Untitled - Notepad")
if not hwnd:
    print("未找到目标窗口，请确保无标题记事本处于运行状态")
else:
    AW_HIDE = 0x00010000
    # 调用AnimateWindow，移除多余参数
    result = win32gui.AnimateWindow(hwnd, 1500, AW_HIDE)
    if result:
        print("Done")
    else:
        error_code = win32api.GetLastError()
        print(f"ERROR，错误码：{error_code}")

补充说明 #

• 调用AW_HIDE标志后，窗口会在动画完成后隐藏，此时调用GetWindowRect可能返回无效值，因为窗口已不可见。
• 必须确保目标窗口（如无标题记事本）处于运行状态，FindWindow才能正确获取句柄。

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