Python利用win32gui实现指定窗口截图

小满

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

原创

本文介绍如何使用Python的win32gui库获取当前所有可见窗口的句柄与标题，并通过指定窗口句柄实现精准截图。代码涵盖枚举窗口、设置前台窗口及利用GDI进行位图复制的完整流程，支持将结果保存为BMP或JPG格式，适用于自动化测试与办公场景。

以下示例展示了如何利用Python结合win32相关模块完成窗口截图功能，供读者参考实现。

获取窗口句柄与标题

首先需要获取系统中所有窗口的句柄及其对应的标题信息。


import win32gui

hwnd_title = dict()


def _get_all_hwnd(hwnd, mouse):
 if win32gui.IsWindow(hwnd) and win32gui.IsWindowEnabled(hwnd) and win32gui.IsWindowVisible(hwnd):
  hwnd_title.update({hwnd: win32gui.GetWindowText(hwnd)})


win32gui.EnumWindows(_get_all_hwnd, 0)
for wnd in hwnd_title.items():
 print(wnd)

程序运行后输出格式为元组形式：(窗口句柄, 窗口标题)。用户可根据输出的标题内容，筛选出需要截图的目标窗口。


(65772, '')
(262798, 'pythonProject – screenShot.py')
(5114244, '项目里程碑.ppt[兼容模式] - PowerPoint')
(3803304, '')
(133646, '')
(133642, '')

执行窗口截图

在获取到目标窗口句柄后，即可执行具体的截图操作。


import win32com.client
import win32gui
import win32api
import win32con
import win32ui
from PIL import Image


def setForeground(hwnd):
 """
  将窗口设置为最前面
 :param hwnd: 窗口句柄 一个整数
 """
 if hwnd != win32gui.GetForegroundWindow():
  shell = win32com.client.Dispatch("WScript.Shell")
  shell.SendKeys('%')
  win32gui.SetForegroundWindow(hwnd)


def winShot(hwnd):
 """
  根据窗口句柄截取窗口视图
 :param hwnd: 窗口句柄 一个整数
 """
 bmpFileName = 'screenshot.bmp'
 jpgFileName = 'screenshot.jpg'

 r = win32gui.GetWindowRect(hwnd)
 hwin = win32gui.GetDesktopWindow()
 # 图片最左边距离主屏左上角的水平距离
 left = win32api.GetSystemMetrics(win32con.SM_XVIRTUALSCREEN)
 # 图片最上边距离主屏左上角的垂直距离
 top = win32api.GetSystemMetrics(win32con.SM_YVIRTUALSCREEN)
 hwindc = win32gui.GetWindowDC(hwin)
 srcdc = win32ui.CreateDCFromHandle(hwindc)
 memdc = srcdc.CreateCompatibleDC()
 bmp = win32ui.CreateBitmap()
 bmp.CreateCompatibleBitmap(srcdc, r[2] - r[0], r[3] - r[1])
 memdc.SelectObject(bmp)
 memdc.BitBlt((-r[0], top - r[1]), (r[2], r[3] - top), srcdc, (left, top), win32con.SRCCOPY)
 bmp.SaveBitmapFile(memdc, bmpFileName)

 im = Image.open(bmpFileName)
 im = im.convert('RGB')
 im.save(jpgFileName)

if __name__ == '__main__':
 setForeground(5114244)
 winShot(5114244)

以上就是本文介绍的完整内容，希望能为读者的学习提供便利，欢迎继续支持本站。