讲师中心 微信公众号
AI工具推荐 视频效率加速

C#保存WPF/WinForm控件为图片 C#如何将界面元素截图并存为文件

星雪吖_1590

星雪吖_1590

发布时间:2026-02-17 09:34:02

|

479人浏览过

|

来源于php中文网

原创

WPF控件导出PNG需用RenderTargetBitmap渲染再编码,确保控件已加载且可见;WinForm用DrawToBitmap但须处理DPI缩放;跨窗口截图推荐Desktop Duplication API。

c#保存wpf/winform控件为图片 c#如何将界面元素截图并存为文件

WPF控件导出为PNG:用RenderTargetBitmap + JpegBitmapEncoder/PngBitmapEncoder

WPF不支持直接调用DrawToBitmap,必须走渲染管线。核心是把控件渲染到RenderTargetBitmap,再编码保存。注意:控件需已加载(IsLoaded == true),且不能处于隐藏状态(Visibility == Visibility.Visible)。

常见错误是控件未布局完成就截图,结果为空白或尺寸为0。建议在Loaded事件或Dispatcher.InvokeAsync中执行:

var bitmap = new RenderTargetBitmap((int)control.ActualWidth, (int)control.ActualHeight, 96, 96, PixelFormats.Pbgra32);
bitmap.Render(control);
<p>var encoder = new PngBitmapEncoder();
encoder.Frames.Add(BitmapFrame.Create(bitmap));</p><p>using var fs = File.OpenWrite("output.png");
encoder.Save(fs);

关键点:

  • ActualWidth/ActualHeight必须在布局完成后读取,否则为0
  • 分辨率参数(96)影响清晰度,高DPI下可设为VisualTreeHelper.GetDpi(control).PixelsPerInchX
  • 若控件含Effect(如模糊、阴影),需确保RenderOptions.SetBitmapScalingMode(control, BitmapScalingMode.HighQuality)
  • 导出透明背景用PngBitmapEncoder;导出JPEG会丢弃Alpha通道

WinForm控件截图:用Control.DrawToBitmap但注意裁剪和DPI缩放

DrawToBitmap是WinForm原生方案,但默认不处理DPI缩放——高DPI下截图会模糊或错位。必须先手动调整目标Bitmap尺寸,并启用Graphics的高质量渲染。

典型写法:

var bmp = new Bitmap(control.Width * control.DeviceDpi / 96, control.Height * control.DeviceDpi / 96);
using (var g = Graphics.FromImage(bmp))
{
    g.InterpolationMode = InterpolationMode.HighQualityBicubic;
    g.SmoothingMode = SmoothingMode.HighQuality;
    g.PixelOffsetMode = PixelOffsetMode.HighQuality;
    control.DrawToBitmap(bmp, new Rectangle(0, 0, bmp.Width, bmp.Height));
}
bmp.Save("output.jpg", ImageFormat.Jpeg);

易踩坑:

  • 直接传control.Size给Bitmap构造函数 → 高DPI下图像被压缩拉伸
  • 忽略control.DeviceDpi,硬编码96 → 多屏DPI不一致时出错
  • DrawToBitmap无法捕获重叠在控件之上的浮层(如ToolTip、菜单)
  • 某些自绘控件(如第三方图表)可能绕过GDI绘制,需调用其专属导出接口

跨窗口/全屏截图:用Graphics.CopyFromScreen或Desktop duplication API

如果要截整个窗口(含非客户区)或桌面,DrawToBitmap和RenderTargetBitmap都失效。此时得用屏幕坐标抓取。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

简单场景用CopyFromScreen(WinForm兼容):

var bounds = control.PointToScreen(new Point(0, 0));
var bmp = new Bitmap(control.Width, control.Height);
using (var g = Graphics.FromImage(bmp))
    g.CopyFromScreen(bounds, Point.Empty, control.Size);

但该方法有局限:

  • 仅适用于可见区域,最小化窗口返回黑图
  • 多显示器+不同DPI时,PointToScreen返回值需用Monitor.FromPoint校准
  • 性能差,不适合高频截图(如录屏)

生产环境建议用Windows Desktop Duplication API(C++/COM),C#可通过SharpDX或Windows.Graphics.Capture(Win10 1803+)调用,支持捕获最小化窗口、硬件加速、Alpha通道。

保存路径与权限:避免UnauthorizedAccessException和中文路径乱码

截图保存失败最常见原因是路径不可写或含非法字符。WPF/WinForm默认运行在用户上下文,但若程序以管理员身份运行,而目标目录(如C:\Program Files)受UAC保护,就会抛UnauthorizedAccessException。

安全做法:

  • 优先保存到Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData)或MyDocuments
  • 路径含中文时,确保文件系统支持UTF-8(NTFS没问题,FAT32需注意)
  • 使用Path.Combine拼接路径,避免手动加反斜杠导致DirectoryNotFoundException
  • 保存前检查父目录是否存在:Directory.CreateDirectory(Path.GetDirectoryName(filePath))

另外,FileStream未显式指定FileAccess.Write或未用using释放,在部分杀毒软件下可能被拦截写入。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

3228

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

5309

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3869

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

486

2026.01.19

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3419

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2978

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

1528

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2699

2023.08.02

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

20

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn