为.NET应用添加截图功能

本文介绍了 .NET 实现截图功能的思路和过程，如果你仅想了解最后的解决方案，可以直接查看文章末尾。

截图的功能我们应该都经常使用，在开发软件时，我们有时也或多或少需要提供这方面的功能，无论是为用户更方便提供远程诊断，还是获取用户的选择区域，亦或是提供某些功能上的辅助。

开发截图无非就这几种选择：教用户使用截图工具、自行开发一个、使用第三方库。

教用户使用

教的成本无疑是最低的，但是不知道用户那边会发生什么，存在很大的不确定性。截图软件除了我们经常用的聊天工具和系统自带的 Win + Ctrl + S外，我用起来感觉最好的还是 C++ 写的开源软件 flameshot^[1] ，功能非常强大。

flameshot

使用的第三方的截图软件，不仅有教的成本，还会打断用户对本身软件的一个使用体验。教用户使用最好还是用系统自带的 Win + Ctrl + S截图，已经可以满足基本的截图需求。

自行开发

自行开发的原理也非常简单：创建一个半透明的全屏无边框窗体，记录鼠标在窗体上的框选矩形位置，使用CopyFromScreen获取该位置的屏幕图片即可。

以上只是针对单个显示器的情况，若有多个显示器，则需要增加鼠标所在显示器的逻辑。

虽然听起来不难，但代码实现起来还是有许多要注意的细节。简单的矩形截图实现不难，难得是让用户易用，易接受，毕竟聊天软件已经帮你培养了用户习惯。

使用第三方库

CSkin^[2] 是我在 2012 年就在使用的一款界面库，在 WinForm 无疑是软件 UI 美化的王者，可以直接作出和 PC 端 QQ 一样的界面体验。库里也提供了截图工具 FrmCapture，没中不足的是，在多显示器场景下会报错，无法正常使用，代码库也有 4 年没有更新了。

private FrmCapture m_frmCapture;
if (m_frmCapture == null || m_frmCapture.IsDisposed)
{m_frmCapture = new FrmCapture();
}
m_frmCapture.IsCaptureCursor = false;
// 截图结束事件
m_frmCapture.Disposed += M_frmCapture_Disposed;
m_frmCapture.Show();

HandyControl^[3] 和在 nuget 上搜索到的 ScreenCapturerSharp^[4] 虽然也可以实现截图功能，但都无法处理多显示器的场景。HandyControl 社区活跃，其使用体验会比较好。ScreenCapturerSharp 提供了类似 QQ 的截图工具库，在 UI 上稍差一些。

如何又快又好又容易

如果只是获取截图，有没有更简单的方式呢？我们只需要模拟按键 Win + Ctrl + S 就可以了呀，然后通过剪贴板获取到截图。说起来容易，但是事情其实并没有那么简单。

首先 SendKeys 就不支持发送 Windows 徽标按键，我们需要通过 WinAPI keybd_event 来替代实现，然后还要获取到截图结束的事件。

[DllImport("user32.dll", SetLastError = true)]
static extern void keybd_event(byte bVk, byte bScan, uint dwFlags, UIntPtr dwExtraInfo);

其实上面是一个保底的通用方案，我们可以自行启动截图软件，启动截图软件读取剪贴板Clipboard.GetImage() 一套结束，无缝无感，堪称完美：

Process snippingToolProcess = new Process()
{StartInfo = new ProcessStartInfo("C:\\Windows\\system32\\SnippingTool.exe", "/clip"),EnableRaisingEvents = true,
};
snippingToolProcess.Exited += SnippingToolProcess_Exited;
snippingToolProcess.Start();

事情其实远没有那么简单，直到我在 Win11 用了我的软件。才意识到，这只是可以在 Win10 的 64 位操作系统使用。SnippingTool /clip 这样带参数启动在 Win11 不支持了，这个路径下的 exe 还被删除了。

虽然你可以在 Win11 通过控制台使用SnippingTool /clip启动截图软件，但是并不会直接进入截图流程，而是打开软件主界面。

仔细研究你会发现，Win11 的截图其实已经是 UWP 应用了，就算你吧 Win10 的 SnippingTool.exe 复制到 Win11 也是报错，无法使用的，所以你也不可能在自己的软件打包带上它。

经过几番折腾，我在微软社区提问和提交反馈（ Win + F 的时候我觉得这个软件是不是这样启动直接就先截了个屏），但是没有找到新版本截图的启动参数。最后直到我前几天发现 Microsoft Learn 的文章启动屏幕截取 - UWP applications^[5]。在 UWP 里使用这么简单嘛，使用 LaunchUriAsync 就可以了。

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-screenclip:"));

有了 URI 的方式，一切就变简单了，你甚至可以在浏览器里调用截图，放一个超链接，或者直接在浏览器地址栏粘贴ms-screenclip:后回车打开截图。

之后我们只需要监听进程结束就可以了，这里需要说明的是，不是启动的进程，而是截图的进程，下面直接上在 WinForm 中使用的代码：

var psi = new ProcessStartInfo()
{UseShellExecute = true,FileName = "ms-screenclip:"
};
Process.Start(psi);// 获取 ScreenClippingHost 这个截图进程的结束事件
var snippingToolProcess = Process.GetProcessesByName("ScreenClippingHost")[0];
snippingToolProcess.EnableRaisingEvents = true;
snippingToolProcess.Exited += SnippingToolProcess_Exited;

SnippingToolProcess_Exited 事件：

private void SnippingToolProcess_Exited(object? sender, EventArgs e)
{this.BeginInvoke(new Action(() =>{var img = Clipboard.GetImage();}));
}

References

[1] flameshot: https://github.com/flameshot-org/flameshot
[2] CSkin: http://www.cskin.net/
[3] HandyControl: https://handyorg.github.io/handycontrol/extend_controls/screenshot/
[4] ScreenCapturerSharp: https://www.nuget.org/packages/ScreenCapturerSharp
[5] 启动屏幕截取 - UWP applications: https://learn.microsoft.com/zh-cn/windows/uwp/launch-resume/launch-screen-snipping