简介面向C#开发者的截图工具完整源码基于WinForm实现解决日常屏幕捕获与即时标注需求。程序启动后驻留任务栏支持鼠标左键点击任务栏图标截图、右键菜单退出并内置CtrlAltS全局热键源码中可自定义修改。截图后提供矩形、椭圆、箭头、画笔、文字等标注工具支持ESC取消、撤销绘画步骤并带截图画布遮罩功能贴近实际使用场景。资源共87个文件其中37个cs源码文件为核心另有resx资源、ico图标、dll依赖、exe可执行程序等压缩包仅277KB工程结构清晰可直接用Visual Studio打开学习。已有1076人学习下载适合想掌握WinForm界面布局、全局热键注册、屏幕捕获与GDI绘图实践的开发者参考尤其可通过ScreenPasteHelper、OperateManager等模块了解标注工具与操作管理的封装思路直接编译运行并扩展自定义功能。1. ScreenPaste把截图流程压缩到一次触发的 C# 截图工具每次截图还要 PrintScreen、切到画图、裁剪、另存为再跑到文件夹里找文件发出去这在写文档、提 bug、做客服工单时会把大量时间浪费在重复动作上。ScreenPaste 是一个基于 C# 的截图工具源码项目核心思路是程序启动后常驻系统托盘按下全局快捷键或者点一下托盘图标立即进入全屏选区框选后直接进入标注画布能够划线、画矩形、输入文字确认后图片自动进剪贴板或保存到指定目录。它本质上是一个轻量截图画图工具和 Snipaste、Snapite 这类工具解决同一类问题但源码开放适合按自己的习惯改。无论你是 C# 入门级想找一个 WinForms 与 GDI 完整工程练手还是想二次开发一个团队内部截图工具这套实现都值得拆开看一遍。2. 先搭骨架任务栏常驻、全局热键与全屏捕获的选型写截图工具最忌讳一上来就写选区窗口。先想清楚三件事程序怎么常驻、怎么被叫醒、怎么抓取屏幕。这三个选型决定了后面所有功能的稳定性尤其是任务栏常驻方式和高 DPI 下的截图准确度属于后面环节能不能成立的前提。2.1 用 NotifyIcon 常驻系统托盘任务栏图标的正确承载方式标题里写的“启动任务栏”“点击任务栏图标截图”落实到 WinForms 时绝大部分情况指的是系统托盘区域也就是任务栏右下角时钟旁边那一排小图标。托盘图标用 NotifyIcon 控件承载优点是占用了极小的视觉空间程序主窗口可以完全隐藏截图时不会被自己挡到画面这也是 Snipaste、Snapite 这类工具的共同做法。// Program.cs —— 最小可运行的托盘常驻骨架 [STAThread] static void Main() { Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); // 必须用静态字段持有否则 Main 结束后 NotifyIcon 会被 GC 回收 TrayIcon new NotifyIcon { Icon SystemIcons.Application, // 图标可以用 .ico 资源替换 Text ScreenPaste - 截图工具, // 鼠标悬停时显示的文案 Visible true // 不置 true 不会出现托盘图标 }; var menu new ContextMenuStrip(); menu.Items.Add(开始截图, null, (s, e) ScreenshotManager.Trigger()); menu.Items.Add(退出, null, (s, e) Application.Exit()); TrayIcon.ContextMenuStrip menu; TrayIcon.MouseClick OnTrayMouseClick; // 左键单击也走截图入口 Application.Run(); }这段代码最关键的是Application.Run()没有传窗体也能跑起消息循环。NotifyIcon 的事件、右键菜单、后续的 RegisterHotKey 都是挂在消息循环上的没有这个循环托盘图标点一百次也没反应。Visible true不能漏漏掉最常见的结果就是程序跑着自己看不到图标误以为没启动。如果你确实想用底部主任务栏的按钮来做“点击任务栏图标截图”WinForms 没有原生支持只能用一个最小化的 ToolWindow 窗口占住任务栏位置再在激活或失焦事件里拦截。这个方案在多显示器和高 DPI 下很容易翻车我一般不建议做。把托盘图标当作“任务栏图标”的实现载体是最稳的路线。2.2 全局热键注册RegisterHotKey 与 WM_HOTKEY 的完整链路全局热键的本质是让操作系统在你按下某个组合键时往你的消息队列里塞一条 WM_HOTKEY 消息。WinForms 没有内置组件必须通过 user32.dll 的 RegisterHotKey 来做 P/Invoke。注意这条 API 必须在 UI 线程调用因为它依赖消息窗口的句柄。// HotKeyManager.cs —— 全局热键的 P/Invoke 封装 public sealed class HotKeyManager : IDisposable { private const int WM_HOTKEY 0x0312; private readonly HiddenHotKeyWindow _window; public HotKeyManager() { _window new HiddenHotKeyWindow(); _window.HotKeyPressed id HotKeyPressed?.Invoke(id); _window.CreateHandle(new CreateParams()); // 隐藏窗口只拿 HWND } public event Actionint HotKeyPressed; public bool Register(int id, uint modifiers, uint vk) { return RegisterHotKey(_window.Handle, id, modifiers, vk); } public void Unregister(int id) { UnregisterHotKey(_window.Handle, id); } private sealed class HiddenHotKeyWindow : NativeWindow { public event Actionint HotKeyPressed; protected override void WndProc(ref Message m) { if (m.Msg WM_HOTKEY) { HotKeyPressed?.Invoke(m.WParam.ToInt32()); // WParam 是热键 id return; } base.WndProc(ref m); } } }注册时这样调用以 CtrlShiftA 为例Ctrl对应修饰键0x0002Shift对应0x0004A的虚拟键码是0x41。var hotkey new HotKeyManager(); bool ok hotkey.Register(1, 0x0002 | 0x0004, 0x41); hotkey.HotKeyPressed id ScreenshotManager.Trigger();参数里那个id是热键编号同一个进程内每个热键必须用不同的 id一个 id 重复注册会直接返回 false。vk是虚拟键码不是字符本身所以字母都建议用(uint)Keys.A这种写法避免手算出错。这里还有个容易忽略的点程序退出时一定要调用Unregister否则这个热键在系统重启之前会一直占着其他软件想用同一个组合键就会注册失败。很多截图工具卸载后热键还被“吃掉”根源就在这里。2.3 全屏捕获CopyFromScreen 的最小实现与多显示器坐标抓屏用 GDI 的Graphics.CopyFromScreen就够关键坑在多显示器和坐标原点。如果只用Screen.PrimaryScreen.Bounds副屏内容会截不到。Windows 把多块屏幕合成一个虚拟桌面虚拟桌面的左上角不一定是(0,0)——副屏在左边时虚拟桌面左上角是负坐标。所以要取SystemInformation.VirtualScreen。// ScreenCapture.cs —— 抓取整个虚拟桌面 public static Bitmap CaptureFullScreen() { var bounds SystemInformation.VirtualScreen; var bmp new Bitmap(bounds.Width, bounds.Height, PixelFormat.Format32bppArgb); using (var g Graphics.FromImage(bmp)) { // 源起点是虚拟桌面左上角目标起点是 Bitmap 左上角 g.CopyFromScreen(bounds.Left, bounds.Top, 0, 0, bounds.Size); } return bmp; }CopyFromScreen 的目标区域和源区域尺寸一样不需要额外做缩放。PixelFormat.Format32bppArgb是固定选择不要用默认的 Format24bppRgb后者在后续 GDI 绘制标注时会出现明显的颜色断层。最后的using保证 Graphics 对象释放否则文件句柄会泄漏。这版代码在 DPI 为 100% 的开发机上跑没问题但放到 150% 缩放的笔记本上就会出现选区偏移原因和修复放到 5.3 节专门讲。现在先记住抓屏得到的 Bitmap 是物理像素而之后所有窗体的逻辑坐标都可能被系统缩放这两者必须做换算。3. 把快捷键、托盘点击接到同一套截图流程事件入口与选区交互截图入口无论来自热键还是托盘点击最终都应该收敛到同一个方法里。这样做的好处是后续增加“开机启动后自动截图”之类的触发源时只需要加一行调用。入口统一之后真正考验代码的是防重入、蒙版绘制和坐标换算。3.1 统一截图入口防重入、隐藏自身与延时捕获截图工具最容易出的低级问题是把托盘图标或自己的窗口截进图里。热键触发截图时托盘图标还亮着蒙版窗口弹出来抢焦点如果抓屏发生在蒙版显示之前画面上就会多出自己的 UI。// ScreenshotManager.cs —— 所有触发源都收敛到这里 public static class ScreenshotManager { private static bool _busy; public static void Trigger() { if (_busy) return; // 防止热键连按导致多个截图流程 _busy true; TrayIcon.Visible false; // 先隐藏自己的托盘图标 Thread.Sleep(120); // 留时间让托盘区重绘 using var screen CaptureFullScreen(); using var selector new RegionSelectorForm(screen); if (selector.ShowDialog() DialogResult.OK) { using var cropped CropRegion(screen, selector); AnnotatorForm.Run(cropped); // 进入标注画布 } TrayIcon.Visible true; _busy false; } }Thread.Sleep(120)这个数字看起来像玄学但确实是 Windows 托盘图标消失后需要一点时间重绘的实际情况。短了截图上还能看到半个图标尾巴长了用户按完快捷键会感觉卡顿。120 到 150 毫秒是常见取值。_busy标志是双保险因为热键消息可能在你上一次截图流程还没走完时再次到达否则会出现两个选区窗口叠在一起。这段代码里有一个必须注意的设计RegionSelectorForm是全屏模态窗口ShowDialog()会阻塞当前线程直到用户框选完成或按 Esc 取消。这样做的好处是截图流程是严格的串行逻辑不需要引入状态机。3.2 全屏蒙版与鼠标拖拽选区一个窗体画完两件事选区蒙版窗口要做两件事把抓到的屏幕截图原样画出来当背景然后等待用户用鼠标拖出一个矩形。实现上用一个无边框、最大化、置顶的窗体就能完成。注意背景图要用物理像素完整绘制不能做任何缩放。// RegionSelectorForm.cs —— 全屏蒙版拖拽画选区 public sealed class RegionSelectorForm : Form { private readonly Bitmap _screen; private Point _start; private Rectangle _rect; public RegionSelectorForm(Bitmap screen) { _screen screen; FormBorderStyle FormBorderStyle.None; WindowState FormWindowState.Maximized; ShowInTaskbar false; Cursor Cursors.Cross; KeyPreview true; // 让 Esc 和双击先经过这里 DoubleBuffered true; // 减少拖拽时的闪烁 Bounds SystemInformation.VirtualScreen; } protected override void OnMouseDown(MouseEventArgs e) { if (e.Button MouseButtons.Left) _start e.Location; } protected override void OnMouseMove(MouseEventArgs e) { if (e.Button MouseButtons.Left) { _rect Rectangle.FromLTRB( Math.Min(_start.X, e.X), Math.Min(_start.Y, e.Y), Math.Max(_start.X, e.X), Math.Max(_start.Y, e.Y)); Invalidate(); // 触发重绘 } } protected override void OnPaint(PaintEventArgs e) { e.Graphics.DrawImage(_screen, Point.Empty); // 选区外铺半透明黑选区内保持原色 using var region new Region(ClientRectangle); if (_rect.Width 1 _rect.Height 1) region.Exclude(_rect); using var brush new SolidBrush(Color.FromArgb(90, 0, 0, 0)); e.Graphics.FillRegion(brush, region); if (_rect.Width 1 _rect.Height 1) e.Graphics.DrawRectangle(Pens.Red, _rect); } protected override void OnMouseDoubleClick(MouseEventArgs e) { if (_rect.Width 4 _rect.Height 4) { DialogResult DialogResult.OK; Close(); } } protected override void OnKeyDown(KeyEventArgs e) { if (e.KeyCode Keys.Escape) { _rect Rectangle.Empty; DialogResult DialogResult.Cancel; Close(); } } }这段代码的时间复杂度只有面对一个Invalidate()的简单重绘性能没有问题。Region.Exclude是这里最值得说的 API它把选区外的区域从遮罩里挖掉选区内的图保持颜色不变视觉效果就是一块“暗色背景上一块亮色选区”和常见截图工具一致。Bounds SystemInformation.VirtualScreen是关键否则副屏区域点不到。DoubleBuffered true不是可选项。如果省略鼠标拖拽时蒙版窗口会肉眼可见地闪白尤其在慢速拖动时特别明显。这个闪烁问题在截图工具里会被放大成“业余感”所以一定加上。3.3 抠出选中区域从逻辑坐标到物理坐标的换算公式用户框选结束selector.SelectedRectangle是窗体的客户端逻辑坐标。而_screen这个 Bitmap 是由物理像素构成的两者的尺度在高 DPI 屏幕上不一样。不做换算直接Clone抠出来的图会整体向左上偏尺寸也缩小。// CropRegion —— 从全屏截图中抠出选区处理 DPI 缩放 public static Bitmap CropRegion(Bitmap full, RegionSelectorForm selector) { var rect selector.SelectedRectangle; double dpiScale selector.DeviceDpi / 96.0; // 150% 缩放时是 1.5 if (Math.Abs(dpiScale - 1.0) 0.01) { rect new Rectangle( (int)Math.Round(rect.X * dpiScale), (int)Math.Round(rect.Y * dpiScale), (int)Math.Round(rect.Width * dpiScale), (int)Math.Round(rect.Height * dpiScale)); } return full.Clone(rect, full.PixelFormat); // Clone 比新建再 Copy 快 }Clone要求目标矩形必须完全落在 Bitmap 边界内否则抛 ArgumentException。所以换算后最好再加一层边界保护如果rect.Right full.Width或rect.Bottom full.Height就手动截断。多显示器下尤其容易出现这种越界因为 Windows 对每个屏幕的缩放比例可能不一样虚拟桌面的边界并不总是整齐。这里抠出的Bitmap就是下一步标注画布的底图。每一步之间都用using释放中间资源避免长时间运行后 GDI 对象堆积导致内存涨到几百兆这是截图工具常见的内存泄漏来源。4. 划线、输入文字把标注做成对象列表而不是像素堆叠标注功能最容易做成“在截图像素上直接抹颜色”做完撤销就只能凭感觉恢复。正确的做法是把每个标注保存成一个形状对象绘制时逐层叠加。这样撤销就是一行的 List 操作也方便后续增加拖动、调整大小、改颜色。4.1 标注基类与形状列表撤销重做的地基定义一个ShapeBase抽象类把颜色、线宽、绘制方法和命中测试都统一。然后每种标注继承它进入标注画布后所有操作都在一个ListShapeBase上完成。// Shapes.cs —— 标注对象模型 public abstract class ShapeBase { public Color StrokeColor { get; set; } Color.FromArgb(255, 232, 65, 65); public int StrokeWidth { get; set; } 3; public abstract void Draw(Graphics g); public abstract bool HitTest(Point p); } public sealed class LineShape : ShapeBase { public Point Start { get; set; } public Point End { get; set; } public override void Draw(Graphics g) { using var pen new Pen(StrokeColor, StrokeWidth); g.DrawLine(pen, Start, End); } public override bool HitTest(Point p) { return DistancePointToSegment(p, Start, End) StrokeWidth 4; } }标注画布的OnPaint里先画底图再遍历整个列表把形状叠上去// AnnotatorForm.cs 局部 —— 形状列表与撤销 private readonly ListShapeBase _shapes new(); protected override void OnPaint(PaintEventArgs e) { e.Graphics.SmoothingMode SmoothingMode.AntiAlias; e.Graphics.DrawImage(_source, 0, 0); // 截图作为底层 foreach (var shape in _shapes) shape.Draw(e.Graphics); // 标注一层层叠上去 } private void Undo() { if (_shapes.Count 0) _shapes.RemoveAt(_shapes.Count - 1); Invalidate(); }ListShapeBase的代价是每次重绘都会跑一遍所有标注但截图工具的单张图片尺寸和有几十个标注的情况下这个开销完全可以忽略。用对象列表还有个额外好处给任意形状做微调时只需要修改对象属性然后Invalidate()不用费劲去解析位图上的像素。4.2 划线怎么画才不糊点集合与 GraphicsPath自由划线是截图标注里使用频率最高的功能。实现逻辑是鼠标按下时开始收集点移动时把新点追加进列表并不断重绘松开时把点列表封装成形状提交。最容易翻车的是点太密导致折线有锯齿点太疏导致画出来的线像虚线。// 自由划线 —— 记录点重绘时连成路径 private readonly ListPoint _points new(); private bool _isDrawingTool true; protected override void OnMouseDown(MouseEventArgs e) { if (_isDrawingTool e.Button MouseButtons.Left) { _points.Clear(); _points.Add(e.Location); } } protected override void OnMouseMove(MouseEventArgs e) { if (_isDrawingTool e.Button MouseButtons.Left) { _points.Add(e.Location); Invalidate(); } } protected override void OnMouseUp(MouseEventArgs e) { if (_isDrawingTool _points.Count 0) { _shapes.Add(new PathShape(_points.ToArray())); _points.Clear(); } } private sealed class PathShape : ShapeBase { private readonly Point[] _pts; public PathShape(Point[] pts) _pts pts; public override void Draw(Graphics g) { if (_pts.Length 2) return; using var pen new Pen(StrokeColor, StrokeWidth); pen.StartCap LineCap.Round; pen.EndCap LineCap.Round; pen.LineJoin LineJoin.Round; // 拐角圆弧化线不刺眼 using var path new GraphicsPath(); path.AddLines(_pts); g.DrawPath(pen, path); } public override bool HitTest(Point p) { for (int i 1; i _pts.Length; i) if (DistancePointToSegment(p, _pts[i - 1], _pts[i]) StrokeWidth 4) return true; return false; } }鼠标消息的采样频率通常是一秒几十到一百多次手速快时两个相邻点之间可能跨了好几个像素。LineJoin.Round能把折线拐角的尖刺磨圆肉眼看起来就是连续笔迹。这里不需要用贝塞尔插值截图标注的用户对线条的逼真度要求没那么高反而对“画出来是不是平滑”更敏感圆帽加圆角就能解决绝大多数视觉问题。4.3 文字输入的编辑态与确认态用临时 TextBox 避开中文输入坑文字标注最忌讳直接在 OnPaint 里响应 KeyPress。因为 WinForms 的 KeyPress 对中文输入法IME支持不好用户打完拼音再上屏字符是分批到达的手动拼装容易错乱。常见做法是提供一个真实的 TextBox 放在点击位置用户编辑完后提交成 TextShape。// 文字标注用临时 TextBox 承载输入提交后生成 TextShape private TextBox _textEditor; private void StartTextInput(Point p) { _textEditor new TextBox { Location p, Font new Font(Microsoft YaHei, 14), ForeColor CurrentStrokeColor, BackColor Color.FromArgb(120, 255, 255, 255), // 半透明白底 BorderStyle BorderStyle.None, Multiline false }; _textEditor.LostFocus (s, e) CommitTextInput(); _textEditor.KeyDown (s, e) { if (e.KeyCode Keys.Enter) CommitTextInput(); // 回车确认 else if (e.KeyCode Keys.Escape) { _textEditor.Text string.Empty; CommitTextInput(); // Esc 放弃输入 } }; Controls.Add(_textEditor); _textEditor.Focus(); } private void CommitTextInput() { if (_textEditor null) return; string text _textEditor.Text.Trim(); if (text.Length 0) { _shapes.Add(new TextShape { Location _textEditor.Location, Text text, Font _textEditor.Font, StrokeColor _textEditor.ForeColor }); } Controls.Remove(_textEditor); _textEditor.Dispose(); _textEditor null; Invalidate(); }借助真实 TextBox中文输入、emoji、粘贴多行文本都直接复用系统能力不用自己处理。三个退出路径分别是回车确认、Esc 放弃、失去焦点自动提交。其中LostFocus必须和Esc搭配否则用户点标注画布其他地方时TextBox 还留在界面上下一次操作会拿到一个残留的输入框。BackColor用半透明白是为了在复杂截图底色上能看清文字如果不用半透明白色输入框会像一个补丁影响用户对最终标注效果的判断。提交后 TextShape 也进同一个_shapes列表所以文字标注同样支持一次 CtrlZ 撤销。5. ScreenPaste 常见问题排查热键失效、黑屏截图与高 DPI 错位代码写通只能算完成百分之五十。截图工具是典型的“自己电脑上没问题发出去就翻车”的桌面端应用。我把开发中真实遇到的高频问题整理成四条每一条都以“现象→原因→解决”的路径来说方便你直接对照排查。5.1 热键注册失败RegisterHotKey 返回 false 后的降级现象是代码在开发机上正常部署到同事电脑后快捷键没反应或者程序启动时报热键注册失败。原因很直接CtrlShiftA这类组合键被 QQ、微信、输入法截图、PowerToys 等软件占用过一遍。Windows 的热键是系统级互斥的同一时刻只能有一个进程注册成功。解决的关键是 RegisterHotKey 返回 false 时不要直接放弃而是先读Marshal.GetLastWin32Error()判断错误编号。错误码1409表示ERROR_HOTKEY_ALREADY_REGISTERED也就是热键已被占用。这时自动降级到备用组合键并弹托盘气泡通知用户。// 注册热键带错误判断与降级 var ok hotkey.Register(1, MOD_CONTROL | MOD_SHIFT, (uint)Keys.A); if (!ok) { int err Marshal.GetLastWin32Error(); if (err 1409) // ERROR_HOTKEY_ALREADY_REGISTERED { ok hotkey.Register(1, MOD_ALT, (uint)Keys.A); TrayIcon.ShowBalloonTip(3000, ScreenPaste, CtrlShiftA 被占用已切换为 AltA, ToolTipIcon.Info); } } if (!ok) { // 第二次还失败放弃热键只保留托盘点击入口 TrayIcon.ShowBalloonTip(3000, ScreenPaste, 热键注册失败请使用托盘图标截图, ToolTipIcon.Warning); }这里MOD_CONTROL和MOD_SHIFT是修饰键常量的别名为了避免每个调用里写0x0002这种魔法数建议在 HotKeyManager 里定义一组常量。降级后最好把热键写入配置下次启动直接读取配置避免每次都抢同一个键。热键注册放在 UI 线程上的前提不变在后台线程调用 RegisterHotKey 会导致句柄无效或直接抛异常。5.2 截屏黑屏CopyFromScreen 的软硬件边界现象是双显卡笔记本上或者用户开着全屏游戏时截出来的图整张是黑的。原因是CopyFromScreen走的是 GDI 接口它读的是桌面合成器的输出画面。普通桌面窗口都走这个合成路径但全屏独占游戏不走桌面合成GDI 抓到的就是空帧安全桌面比如 UAC 提权弹窗那一层同样抓不到。对截图工具来说最务实的方案不是硬扛而是先做黑屏检测再给用户一个“延时 3 秒截图”入口。检测逻辑可以简单到采样四个角的像素// 黑屏兜底抽四个角判断画面是否基本全黑 private static bool IsMostlyBlack(Bitmap bmp) { int sampleSize 4, blackCount 0, total 0; for (int i 0; i sampleSize; i) { for (int j 0; j sampleSize; j) { var c bmp.GetPixel( bmp.Width * i / (sampleSize - 1), bmp.Height * j / (sampleSize - 1)); total; if (c.R 16 c.G 16 c.B 16) blackCount; } } return blackCount total * 3 / 4; }如果检测结果是黑色可以自动重试两三次每次间隔 300 毫秒还不行就提示用户切回桌面再截。要不要改用 Windows Graphics Capture API 来处理独占全屏可以但对一个 C# 截图工具来说引入的 COM 复杂度和兼容性测试成本都偏高第一版不建议上。5.3 高 DPI 选区偏移PerMonitorV2 声明与坐标换算现象是 150% 缩放的屏幕上用户框选右下角区域实际抠出来的图却是左上角一块偏小的内容。原因是 WinForms 在老式程序里默认按 96 DPI 逻辑坐标运行窗体坐标是虚拟化的而抓屏得到的 Bitmap 是物理像素两个坐标系的缩放系数没有对齐。解决分两步第一步在 app.manifest 里声明 PerMonitorV2让系统告诉程序真实的 DPI 值第二步在抠图时按DeviceDpi / 96.0做坐标换算。!-- app.manifest 中启用 PerMonitorV2 DPI 感知 -- application xmlnsurn:schemas-microsoft-com:asm.v3 windowsSettings dpiAwareness xmlnshttp://schemas.microsoft.com/SMI/2016/WindowsSettings PerMonitorV2 /dpiAwareness /windowsSettings /application声明之后窗体的DeviceDpi会返回真实缩放比例比如 150% 缩放下是 144DeviceDpi / 96.0 1.5。3.3 节里的ToPhysical换算方法就是针对这种情况。这里要补一条边界经验副屏与主屏缩放比例不一致时虚拟桌面的局部坐标换算更复杂最好的处理是逐屏取 DPI而不是一上来就用主屏的DeviceDpi。5.4 托盘图标消失或点击无反应引用持有与单实例现象是托盘图标运行几分钟后消失了或者右键菜单能弹出来但点击截图没反应。第一类原因最常见NotifyIcon 声明成 Main 方法里的局部变量方法结束后虽然 Application.Run 还在跑消息循环但系统已经失去对 NotifyIcon 的强引用GC 随手把它回收了。解决是必须让 NotifyIcon 挂在静态字段上前面 2.1 节代码里已经这么做。第二类情况是程序被启动了两个实例。第二个实例注册热键会失败但它依然创建了自己的托盘图标两个图标长得一模一样点击时不知道哪个在处理消息快捷键自然时灵时不灵。用命名 Mutex 做单实例保护// 单实例 静态持有一并处理 private static NotifyIcon _trayIcon; [STAThread] static void Main() { using var mutex new Mutex(true, ScreenPaste_Instance, out bool isNew); if (!isNew) { return; // 已有实例在运行第二个实例直接退 } _trayIcon new NotifyIcon { /* ... */ }; Application.Run(); _trayIcon?.Dispose(); }Mutex 的命名有讲究最好带一个 GUID 或产品名后缀避免和别的软件撞名。using var会在 Main 结束时释放 Mutex如果程序异常退出系统也会自动释放不用担心 Mutex 残留导致下次无法启动。6. 让截图成为肌肉记忆贴图、防反编译与启动体验6.1 截图后的标准管道复制、保存、贴图标注完成后的处理是决定用户愿不愿意长期用这个工具的分水岭。常见做法是把最终结果同时做三件事写入剪贴板、按日期自动保存、提供“贴图”模式。剪贴板是最高频出口用户不管发消息还是写文档直接 CtrlV 就带走。// 标注确认后的后处理管道 Clipboard.SetImage(result); // 1. 随手 CtrlV 带走 if (AutoSave) result.Save(autoSavePath, ImageFormat.Png); // 2. 按日期存到图片目录 if (PinToScreen) ShowPinWindow(result); // 3. 钉在屏幕上对照这里的贴图功能才是名字里 Paste 的完整含义。实现特别简单一个无边框、TopMost、ShowInTaskbarfalse 的窗体把截图当作背景图显示支持鼠标拖动按 Esc 关闭。它解决的是文档边写边对比的需求用户不用反复切窗口。6.2 Release 发布时的代码保护与启动顺序既然项目名称带“C#源码”如果你打算把 Release 版本发给别人就得考虑到 C# 程序编译出来的是中间语言随便丢进反编译工具就能看到近乎源码的代码。去掉调试符号只能防新手想要更安全的保护可以加混淆器做控制流混淆和字符串加密但混淆后出问题更难排查需要权衡。更实用的做法是把设备名、授权校验等敏感逻辑单独放进一个 Native DLLC# 层只做普通调用。启动顺序也是容易被忽略的体验细节单实例检查应该放在最前其次是注册热键最后创建托盘图标。热键注册失败不能阻断整个程序启动托盘入口永远是最后的备用方案。我自己写第一版时把 DPI 感知声明漏了发给三个同事两个说选区偏移这才意识到这类桌面工具的隐蔽坑远比功能本身多。希望这篇把 ScreenPaste 的架构、快捷键截图、任务栏图标触发和标注实现讲清楚后你也能用这套源码思路在半天内搭出自己合手的截图工具少走我已经踩过的这些坑。本文还有配套的精品资源点击获取
简介面向C#开发者的截图工具完整源码基于WinForm实现解决日常屏幕捕获与即时标注需求。程序启动后驻留任务栏支持鼠标左键点击任务栏图标截图、右键菜单退出并内置CtrlAltS全局热键源码中可自定义修改。截图后提供矩形、椭圆、箭头、画笔、文字等标注工具支持ESC取消、撤销绘画步骤并带截图画布遮罩功能贴近实际使用场景。资源共87个文件其中37个cs源码文件为核心另有resx资源、ico图标、dll依赖、exe可执行程序等压缩包仅277KB工程结构清晰可直接用Visual Studio打开学习。已有1076人学习下载适合想掌握WinForm界面布局、全局热键注册、屏幕捕获与GDI绘图实践的开发者参考尤其可通过ScreenPasteHelper、OperateManager等模块了解标注工具与操作管理的封装思路直接编译运行并扩展自定义功能。1. ScreenPaste把截图流程压缩到一次触发的 C# 截图工具每次截图还要 PrintScreen、切到画图、裁剪、另存为再跑到文件夹里找文件发出去这在写文档、提 bug、做客服工单时会把大量时间浪费在重复动作上。ScreenPaste 是一个基于 C# 的截图工具源码项目核心思路是程序启动后常驻系统托盘按下全局快捷键或者点一下托盘图标立即进入全屏选区框选后直接进入标注画布能够划线、画矩形、输入文字确认后图片自动进剪贴板或保存到指定目录。它本质上是一个轻量截图画图工具和 Snipaste、Snapite 这类工具解决同一类问题但源码开放适合按自己的习惯改。无论你是 C# 入门级想找一个 WinForms 与 GDI 完整工程练手还是想二次开发一个团队内部截图工具这套实现都值得拆开看一遍。2. 先搭骨架任务栏常驻、全局热键与全屏捕获的选型写截图工具最忌讳一上来就写选区窗口。先想清楚三件事程序怎么常驻、怎么被叫醒、怎么抓取屏幕。这三个选型决定了后面所有功能的稳定性尤其是任务栏常驻方式和高 DPI 下的截图准确度属于后面环节能不能成立的前提。2.1 用 NotifyIcon 常驻系统托盘任务栏图标的正确承载方式标题里写的“启动任务栏”“点击任务栏图标截图”落实到 WinForms 时绝大部分情况指的是系统托盘区域也就是任务栏右下角时钟旁边那一排小图标。托盘图标用 NotifyIcon 控件承载优点是占用了极小的视觉空间程序主窗口可以完全隐藏截图时不会被自己挡到画面这也是 Snipaste、Snapite 这类工具的共同做法。// Program.cs —— 最小可运行的托盘常驻骨架 [STAThread] static void Main() { Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); // 必须用静态字段持有否则 Main 结束后 NotifyIcon 会被 GC 回收 TrayIcon new NotifyIcon { Icon SystemIcons.Application, // 图标可以用 .ico 资源替换 Text ScreenPaste - 截图工具, // 鼠标悬停时显示的文案 Visible true // 不置 true 不会出现托盘图标 }; var menu new ContextMenuStrip(); menu.Items.Add(开始截图, null, (s, e) ScreenshotManager.Trigger()); menu.Items.Add(退出, null, (s, e) Application.Exit()); TrayIcon.ContextMenuStrip menu; TrayIcon.MouseClick OnTrayMouseClick; // 左键单击也走截图入口 Application.Run(); }这段代码最关键的是Application.Run()没有传窗体也能跑起消息循环。NotifyIcon 的事件、右键菜单、后续的 RegisterHotKey 都是挂在消息循环上的没有这个循环托盘图标点一百次也没反应。Visible true不能漏漏掉最常见的结果就是程序跑着自己看不到图标误以为没启动。如果你确实想用底部主任务栏的按钮来做“点击任务栏图标截图”WinForms 没有原生支持只能用一个最小化的 ToolWindow 窗口占住任务栏位置再在激活或失焦事件里拦截。这个方案在多显示器和高 DPI 下很容易翻车我一般不建议做。把托盘图标当作“任务栏图标”的实现载体是最稳的路线。2.2 全局热键注册RegisterHotKey 与 WM_HOTKEY 的完整链路全局热键的本质是让操作系统在你按下某个组合键时往你的消息队列里塞一条 WM_HOTKEY 消息。WinForms 没有内置组件必须通过 user32.dll 的 RegisterHotKey 来做 P/Invoke。注意这条 API 必须在 UI 线程调用因为它依赖消息窗口的句柄。// HotKeyManager.cs —— 全局热键的 P/Invoke 封装 public sealed class HotKeyManager : IDisposable { private const int WM_HOTKEY 0x0312; private readonly HiddenHotKeyWindow _window; public HotKeyManager() { _window new HiddenHotKeyWindow(); _window.HotKeyPressed id HotKeyPressed?.Invoke(id); _window.CreateHandle(new CreateParams()); // 隐藏窗口只拿 HWND } public event Actionint HotKeyPressed; public bool Register(int id, uint modifiers, uint vk) { return RegisterHotKey(_window.Handle, id, modifiers, vk); } public void Unregister(int id) { UnregisterHotKey(_window.Handle, id); } private sealed class HiddenHotKeyWindow : NativeWindow { public event Actionint HotKeyPressed; protected override void WndProc(ref Message m) { if (m.Msg WM_HOTKEY) { HotKeyPressed?.Invoke(m.WParam.ToInt32()); // WParam 是热键 id return; } base.WndProc(ref m); } } }注册时这样调用以 CtrlShiftA 为例Ctrl对应修饰键0x0002Shift对应0x0004A的虚拟键码是0x41。var hotkey new HotKeyManager(); bool ok hotkey.Register(1, 0x0002 | 0x0004, 0x41); hotkey.HotKeyPressed id ScreenshotManager.Trigger();参数里那个id是热键编号同一个进程内每个热键必须用不同的 id一个 id 重复注册会直接返回 false。vk是虚拟键码不是字符本身所以字母都建议用(uint)Keys.A这种写法避免手算出错。这里还有个容易忽略的点程序退出时一定要调用Unregister否则这个热键在系统重启之前会一直占着其他软件想用同一个组合键就会注册失败。很多截图工具卸载后热键还被“吃掉”根源就在这里。2.3 全屏捕获CopyFromScreen 的最小实现与多显示器坐标抓屏用 GDI 的Graphics.CopyFromScreen就够关键坑在多显示器和坐标原点。如果只用Screen.PrimaryScreen.Bounds副屏内容会截不到。Windows 把多块屏幕合成一个虚拟桌面虚拟桌面的左上角不一定是(0,0)——副屏在左边时虚拟桌面左上角是负坐标。所以要取SystemInformation.VirtualScreen。// ScreenCapture.cs —— 抓取整个虚拟桌面 public static Bitmap CaptureFullScreen() { var bounds SystemInformation.VirtualScreen; var bmp new Bitmap(bounds.Width, bounds.Height, PixelFormat.Format32bppArgb); using (var g Graphics.FromImage(bmp)) { // 源起点是虚拟桌面左上角目标起点是 Bitmap 左上角 g.CopyFromScreen(bounds.Left, bounds.Top, 0, 0, bounds.Size); } return bmp; }CopyFromScreen 的目标区域和源区域尺寸一样不需要额外做缩放。PixelFormat.Format32bppArgb是固定选择不要用默认的 Format24bppRgb后者在后续 GDI 绘制标注时会出现明显的颜色断层。最后的using保证 Graphics 对象释放否则文件句柄会泄漏。这版代码在 DPI 为 100% 的开发机上跑没问题但放到 150% 缩放的笔记本上就会出现选区偏移原因和修复放到 5.3 节专门讲。现在先记住抓屏得到的 Bitmap 是物理像素而之后所有窗体的逻辑坐标都可能被系统缩放这两者必须做换算。3. 把快捷键、托盘点击接到同一套截图流程事件入口与选区交互截图入口无论来自热键还是托盘点击最终都应该收敛到同一个方法里。这样做的好处是后续增加“开机启动后自动截图”之类的触发源时只需要加一行调用。入口统一之后真正考验代码的是防重入、蒙版绘制和坐标换算。3.1 统一截图入口防重入、隐藏自身与延时捕获截图工具最容易出的低级问题是把托盘图标或自己的窗口截进图里。热键触发截图时托盘图标还亮着蒙版窗口弹出来抢焦点如果抓屏发生在蒙版显示之前画面上就会多出自己的 UI。// ScreenshotManager.cs —— 所有触发源都收敛到这里 public static class ScreenshotManager { private static bool _busy; public static void Trigger() { if (_busy) return; // 防止热键连按导致多个截图流程 _busy true; TrayIcon.Visible false; // 先隐藏自己的托盘图标 Thread.Sleep(120); // 留时间让托盘区重绘 using var screen CaptureFullScreen(); using var selector new RegionSelectorForm(screen); if (selector.ShowDialog() DialogResult.OK) { using var cropped CropRegion(screen, selector); AnnotatorForm.Run(cropped); // 进入标注画布 } TrayIcon.Visible true; _busy false; } }Thread.Sleep(120)这个数字看起来像玄学但确实是 Windows 托盘图标消失后需要一点时间重绘的实际情况。短了截图上还能看到半个图标尾巴长了用户按完快捷键会感觉卡顿。120 到 150 毫秒是常见取值。_busy标志是双保险因为热键消息可能在你上一次截图流程还没走完时再次到达否则会出现两个选区窗口叠在一起。这段代码里有一个必须注意的设计RegionSelectorForm是全屏模态窗口ShowDialog()会阻塞当前线程直到用户框选完成或按 Esc 取消。这样做的好处是截图流程是严格的串行逻辑不需要引入状态机。3.2 全屏蒙版与鼠标拖拽选区一个窗体画完两件事选区蒙版窗口要做两件事把抓到的屏幕截图原样画出来当背景然后等待用户用鼠标拖出一个矩形。实现上用一个无边框、最大化、置顶的窗体就能完成。注意背景图要用物理像素完整绘制不能做任何缩放。// RegionSelectorForm.cs —— 全屏蒙版拖拽画选区 public sealed class RegionSelectorForm : Form { private readonly Bitmap _screen; private Point _start; private Rectangle _rect; public RegionSelectorForm(Bitmap screen) { _screen screen; FormBorderStyle FormBorderStyle.None; WindowState FormWindowState.Maximized; ShowInTaskbar false; Cursor Cursors.Cross; KeyPreview true; // 让 Esc 和双击先经过这里 DoubleBuffered true; // 减少拖拽时的闪烁 Bounds SystemInformation.VirtualScreen; } protected override void OnMouseDown(MouseEventArgs e) { if (e.Button MouseButtons.Left) _start e.Location; } protected override void OnMouseMove(MouseEventArgs e) { if (e.Button MouseButtons.Left) { _rect Rectangle.FromLTRB( Math.Min(_start.X, e.X), Math.Min(_start.Y, e.Y), Math.Max(_start.X, e.X), Math.Max(_start.Y, e.Y)); Invalidate(); // 触发重绘 } } protected override void OnPaint(PaintEventArgs e) { e.Graphics.DrawImage(_screen, Point.Empty); // 选区外铺半透明黑选区内保持原色 using var region new Region(ClientRectangle); if (_rect.Width 1 _rect.Height 1) region.Exclude(_rect); using var brush new SolidBrush(Color.FromArgb(90, 0, 0, 0)); e.Graphics.FillRegion(brush, region); if (_rect.Width 1 _rect.Height 1) e.Graphics.DrawRectangle(Pens.Red, _rect); } protected override void OnMouseDoubleClick(MouseEventArgs e) { if (_rect.Width 4 _rect.Height 4) { DialogResult DialogResult.OK; Close(); } } protected override void OnKeyDown(KeyEventArgs e) { if (e.KeyCode Keys.Escape) { _rect Rectangle.Empty; DialogResult DialogResult.Cancel; Close(); } } }这段代码的时间复杂度只有面对一个Invalidate()的简单重绘性能没有问题。Region.Exclude是这里最值得说的 API它把选区外的区域从遮罩里挖掉选区内的图保持颜色不变视觉效果就是一块“暗色背景上一块亮色选区”和常见截图工具一致。Bounds SystemInformation.VirtualScreen是关键否则副屏区域点不到。DoubleBuffered true不是可选项。如果省略鼠标拖拽时蒙版窗口会肉眼可见地闪白尤其在慢速拖动时特别明显。这个闪烁问题在截图工具里会被放大成“业余感”所以一定加上。3.3 抠出选中区域从逻辑坐标到物理坐标的换算公式用户框选结束selector.SelectedRectangle是窗体的客户端逻辑坐标。而_screen这个 Bitmap 是由物理像素构成的两者的尺度在高 DPI 屏幕上不一样。不做换算直接Clone抠出来的图会整体向左上偏尺寸也缩小。// CropRegion —— 从全屏截图中抠出选区处理 DPI 缩放 public static Bitmap CropRegion(Bitmap full, RegionSelectorForm selector) { var rect selector.SelectedRectangle; double dpiScale selector.DeviceDpi / 96.0; // 150% 缩放时是 1.5 if (Math.Abs(dpiScale - 1.0) 0.01) { rect new Rectangle( (int)Math.Round(rect.X * dpiScale), (int)Math.Round(rect.Y * dpiScale), (int)Math.Round(rect.Width * dpiScale), (int)Math.Round(rect.Height * dpiScale)); } return full.Clone(rect, full.PixelFormat); // Clone 比新建再 Copy 快 }Clone要求目标矩形必须完全落在 Bitmap 边界内否则抛 ArgumentException。所以换算后最好再加一层边界保护如果rect.Right full.Width或rect.Bottom full.Height就手动截断。多显示器下尤其容易出现这种越界因为 Windows 对每个屏幕的缩放比例可能不一样虚拟桌面的边界并不总是整齐。这里抠出的Bitmap就是下一步标注画布的底图。每一步之间都用using释放中间资源避免长时间运行后 GDI 对象堆积导致内存涨到几百兆这是截图工具常见的内存泄漏来源。4. 划线、输入文字把标注做成对象列表而不是像素堆叠标注功能最容易做成“在截图像素上直接抹颜色”做完撤销就只能凭感觉恢复。正确的做法是把每个标注保存成一个形状对象绘制时逐层叠加。这样撤销就是一行的 List 操作也方便后续增加拖动、调整大小、改颜色。4.1 标注基类与形状列表撤销重做的地基定义一个ShapeBase抽象类把颜色、线宽、绘制方法和命中测试都统一。然后每种标注继承它进入标注画布后所有操作都在一个ListShapeBase上完成。// Shapes.cs —— 标注对象模型 public abstract class ShapeBase { public Color StrokeColor { get; set; } Color.FromArgb(255, 232, 65, 65); public int StrokeWidth { get; set; } 3; public abstract void Draw(Graphics g); public abstract bool HitTest(Point p); } public sealed class LineShape : ShapeBase { public Point Start { get; set; } public Point End { get; set; } public override void Draw(Graphics g) { using var pen new Pen(StrokeColor, StrokeWidth); g.DrawLine(pen, Start, End); } public override bool HitTest(Point p) { return DistancePointToSegment(p, Start, End) StrokeWidth 4; } }标注画布的OnPaint里先画底图再遍历整个列表把形状叠上去// AnnotatorForm.cs 局部 —— 形状列表与撤销 private readonly ListShapeBase _shapes new(); protected override void OnPaint(PaintEventArgs e) { e.Graphics.SmoothingMode SmoothingMode.AntiAlias; e.Graphics.DrawImage(_source, 0, 0); // 截图作为底层 foreach (var shape in _shapes) shape.Draw(e.Graphics); // 标注一层层叠上去 } private void Undo() { if (_shapes.Count 0) _shapes.RemoveAt(_shapes.Count - 1); Invalidate(); }ListShapeBase的代价是每次重绘都会跑一遍所有标注但截图工具的单张图片尺寸和有几十个标注的情况下这个开销完全可以忽略。用对象列表还有个额外好处给任意形状做微调时只需要修改对象属性然后Invalidate()不用费劲去解析位图上的像素。4.2 划线怎么画才不糊点集合与 GraphicsPath自由划线是截图标注里使用频率最高的功能。实现逻辑是鼠标按下时开始收集点移动时把新点追加进列表并不断重绘松开时把点列表封装成形状提交。最容易翻车的是点太密导致折线有锯齿点太疏导致画出来的线像虚线。// 自由划线 —— 记录点重绘时连成路径 private readonly ListPoint _points new(); private bool _isDrawingTool true; protected override void OnMouseDown(MouseEventArgs e) { if (_isDrawingTool e.Button MouseButtons.Left) { _points.Clear(); _points.Add(e.Location); } } protected override void OnMouseMove(MouseEventArgs e) { if (_isDrawingTool e.Button MouseButtons.Left) { _points.Add(e.Location); Invalidate(); } } protected override void OnMouseUp(MouseEventArgs e) { if (_isDrawingTool _points.Count 0) { _shapes.Add(new PathShape(_points.ToArray())); _points.Clear(); } } private sealed class PathShape : ShapeBase { private readonly Point[] _pts; public PathShape(Point[] pts) _pts pts; public override void Draw(Graphics g) { if (_pts.Length 2) return; using var pen new Pen(StrokeColor, StrokeWidth); pen.StartCap LineCap.Round; pen.EndCap LineCap.Round; pen.LineJoin LineJoin.Round; // 拐角圆弧化线不刺眼 using var path new GraphicsPath(); path.AddLines(_pts); g.DrawPath(pen, path); } public override bool HitTest(Point p) { for (int i 1; i _pts.Length; i) if (DistancePointToSegment(p, _pts[i - 1], _pts[i]) StrokeWidth 4) return true; return false; } }鼠标消息的采样频率通常是一秒几十到一百多次手速快时两个相邻点之间可能跨了好几个像素。LineJoin.Round能把折线拐角的尖刺磨圆肉眼看起来就是连续笔迹。这里不需要用贝塞尔插值截图标注的用户对线条的逼真度要求没那么高反而对“画出来是不是平滑”更敏感圆帽加圆角就能解决绝大多数视觉问题。4.3 文字输入的编辑态与确认态用临时 TextBox 避开中文输入坑文字标注最忌讳直接在 OnPaint 里响应 KeyPress。因为 WinForms 的 KeyPress 对中文输入法IME支持不好用户打完拼音再上屏字符是分批到达的手动拼装容易错乱。常见做法是提供一个真实的 TextBox 放在点击位置用户编辑完后提交成 TextShape。// 文字标注用临时 TextBox 承载输入提交后生成 TextShape private TextBox _textEditor; private void StartTextInput(Point p) { _textEditor new TextBox { Location p, Font new Font(Microsoft YaHei, 14), ForeColor CurrentStrokeColor, BackColor Color.FromArgb(120, 255, 255, 255), // 半透明白底 BorderStyle BorderStyle.None, Multiline false }; _textEditor.LostFocus (s, e) CommitTextInput(); _textEditor.KeyDown (s, e) { if (e.KeyCode Keys.Enter) CommitTextInput(); // 回车确认 else if (e.KeyCode Keys.Escape) { _textEditor.Text string.Empty; CommitTextInput(); // Esc 放弃输入 } }; Controls.Add(_textEditor); _textEditor.Focus(); } private void CommitTextInput() { if (_textEditor null) return; string text _textEditor.Text.Trim(); if (text.Length 0) { _shapes.Add(new TextShape { Location _textEditor.Location, Text text, Font _textEditor.Font, StrokeColor _textEditor.ForeColor }); } Controls.Remove(_textEditor); _textEditor.Dispose(); _textEditor null; Invalidate(); }借助真实 TextBox中文输入、emoji、粘贴多行文本都直接复用系统能力不用自己处理。三个退出路径分别是回车确认、Esc 放弃、失去焦点自动提交。其中LostFocus必须和Esc搭配否则用户点标注画布其他地方时TextBox 还留在界面上下一次操作会拿到一个残留的输入框。BackColor用半透明白是为了在复杂截图底色上能看清文字如果不用半透明白色输入框会像一个补丁影响用户对最终标注效果的判断。提交后 TextShape 也进同一个_shapes列表所以文字标注同样支持一次 CtrlZ 撤销。5. ScreenPaste 常见问题排查热键失效、黑屏截图与高 DPI 错位代码写通只能算完成百分之五十。截图工具是典型的“自己电脑上没问题发出去就翻车”的桌面端应用。我把开发中真实遇到的高频问题整理成四条每一条都以“现象→原因→解决”的路径来说方便你直接对照排查。5.1 热键注册失败RegisterHotKey 返回 false 后的降级现象是代码在开发机上正常部署到同事电脑后快捷键没反应或者程序启动时报热键注册失败。原因很直接CtrlShiftA这类组合键被 QQ、微信、输入法截图、PowerToys 等软件占用过一遍。Windows 的热键是系统级互斥的同一时刻只能有一个进程注册成功。解决的关键是 RegisterHotKey 返回 false 时不要直接放弃而是先读Marshal.GetLastWin32Error()判断错误编号。错误码1409表示ERROR_HOTKEY_ALREADY_REGISTERED也就是热键已被占用。这时自动降级到备用组合键并弹托盘气泡通知用户。// 注册热键带错误判断与降级 var ok hotkey.Register(1, MOD_CONTROL | MOD_SHIFT, (uint)Keys.A); if (!ok) { int err Marshal.GetLastWin32Error(); if (err 1409) // ERROR_HOTKEY_ALREADY_REGISTERED { ok hotkey.Register(1, MOD_ALT, (uint)Keys.A); TrayIcon.ShowBalloonTip(3000, ScreenPaste, CtrlShiftA 被占用已切换为 AltA, ToolTipIcon.Info); } } if (!ok) { // 第二次还失败放弃热键只保留托盘点击入口 TrayIcon.ShowBalloonTip(3000, ScreenPaste, 热键注册失败请使用托盘图标截图, ToolTipIcon.Warning); }这里MOD_CONTROL和MOD_SHIFT是修饰键常量的别名为了避免每个调用里写0x0002这种魔法数建议在 HotKeyManager 里定义一组常量。降级后最好把热键写入配置下次启动直接读取配置避免每次都抢同一个键。热键注册放在 UI 线程上的前提不变在后台线程调用 RegisterHotKey 会导致句柄无效或直接抛异常。5.2 截屏黑屏CopyFromScreen 的软硬件边界现象是双显卡笔记本上或者用户开着全屏游戏时截出来的图整张是黑的。原因是CopyFromScreen走的是 GDI 接口它读的是桌面合成器的输出画面。普通桌面窗口都走这个合成路径但全屏独占游戏不走桌面合成GDI 抓到的就是空帧安全桌面比如 UAC 提权弹窗那一层同样抓不到。对截图工具来说最务实的方案不是硬扛而是先做黑屏检测再给用户一个“延时 3 秒截图”入口。检测逻辑可以简单到采样四个角的像素// 黑屏兜底抽四个角判断画面是否基本全黑 private static bool IsMostlyBlack(Bitmap bmp) { int sampleSize 4, blackCount 0, total 0; for (int i 0; i sampleSize; i) { for (int j 0; j sampleSize; j) { var c bmp.GetPixel( bmp.Width * i / (sampleSize - 1), bmp.Height * j / (sampleSize - 1)); total; if (c.R 16 c.G 16 c.B 16) blackCount; } } return blackCount total * 3 / 4; }如果检测结果是黑色可以自动重试两三次每次间隔 300 毫秒还不行就提示用户切回桌面再截。要不要改用 Windows Graphics Capture API 来处理独占全屏可以但对一个 C# 截图工具来说引入的 COM 复杂度和兼容性测试成本都偏高第一版不建议上。5.3 高 DPI 选区偏移PerMonitorV2 声明与坐标换算现象是 150% 缩放的屏幕上用户框选右下角区域实际抠出来的图却是左上角一块偏小的内容。原因是 WinForms 在老式程序里默认按 96 DPI 逻辑坐标运行窗体坐标是虚拟化的而抓屏得到的 Bitmap 是物理像素两个坐标系的缩放系数没有对齐。解决分两步第一步在 app.manifest 里声明 PerMonitorV2让系统告诉程序真实的 DPI 值第二步在抠图时按DeviceDpi / 96.0做坐标换算。!-- app.manifest 中启用 PerMonitorV2 DPI 感知 -- application xmlnsurn:schemas-microsoft-com:asm.v3 windowsSettings dpiAwareness xmlnshttp://schemas.microsoft.com/SMI/2016/WindowsSettings PerMonitorV2 /dpiAwareness /windowsSettings /application声明之后窗体的DeviceDpi会返回真实缩放比例比如 150% 缩放下是 144DeviceDpi / 96.0 1.5。3.3 节里的ToPhysical换算方法就是针对这种情况。这里要补一条边界经验副屏与主屏缩放比例不一致时虚拟桌面的局部坐标换算更复杂最好的处理是逐屏取 DPI而不是一上来就用主屏的DeviceDpi。5.4 托盘图标消失或点击无反应引用持有与单实例现象是托盘图标运行几分钟后消失了或者右键菜单能弹出来但点击截图没反应。第一类原因最常见NotifyIcon 声明成 Main 方法里的局部变量方法结束后虽然 Application.Run 还在跑消息循环但系统已经失去对 NotifyIcon 的强引用GC 随手把它回收了。解决是必须让 NotifyIcon 挂在静态字段上前面 2.1 节代码里已经这么做。第二类情况是程序被启动了两个实例。第二个实例注册热键会失败但它依然创建了自己的托盘图标两个图标长得一模一样点击时不知道哪个在处理消息快捷键自然时灵时不灵。用命名 Mutex 做单实例保护// 单实例 静态持有一并处理 private static NotifyIcon _trayIcon; [STAThread] static void Main() { using var mutex new Mutex(true, ScreenPaste_Instance, out bool isNew); if (!isNew) { return; // 已有实例在运行第二个实例直接退 } _trayIcon new NotifyIcon { /* ... */ }; Application.Run(); _trayIcon?.Dispose(); }Mutex 的命名有讲究最好带一个 GUID 或产品名后缀避免和别的软件撞名。using var会在 Main 结束时释放 Mutex如果程序异常退出系统也会自动释放不用担心 Mutex 残留导致下次无法启动。6. 让截图成为肌肉记忆贴图、防反编译与启动体验6.1 截图后的标准管道复制、保存、贴图标注完成后的处理是决定用户愿不愿意长期用这个工具的分水岭。常见做法是把最终结果同时做三件事写入剪贴板、按日期自动保存、提供“贴图”模式。剪贴板是最高频出口用户不管发消息还是写文档直接 CtrlV 就带走。// 标注确认后的后处理管道 Clipboard.SetImage(result); // 1. 随手 CtrlV 带走 if (AutoSave) result.Save(autoSavePath, ImageFormat.Png); // 2. 按日期存到图片目录 if (PinToScreen) ShowPinWindow(result); // 3. 钉在屏幕上对照这里的贴图功能才是名字里 Paste 的完整含义。实现特别简单一个无边框、TopMost、ShowInTaskbarfalse 的窗体把截图当作背景图显示支持鼠标拖动按 Esc 关闭。它解决的是文档边写边对比的需求用户不用反复切窗口。6.2 Release 发布时的代码保护与启动顺序既然项目名称带“C#源码”如果你打算把 Release 版本发给别人就得考虑到 C# 程序编译出来的是中间语言随便丢进反编译工具就能看到近乎源码的代码。去掉调试符号只能防新手想要更安全的保护可以加混淆器做控制流混淆和字符串加密但混淆后出问题更难排查需要权衡。更实用的做法是把设备名、授权校验等敏感逻辑单独放进一个 Native DLLC# 层只做普通调用。启动顺序也是容易被忽略的体验细节单实例检查应该放在最前其次是注册热键最后创建托盘图标。热键注册失败不能阻断整个程序启动托盘入口永远是最后的备用方案。我自己写第一版时把 DPI 感知声明漏了发给三个同事两个说选区偏移这才意识到这类桌面工具的隐蔽坑远比功能本身多。希望这篇把 ScreenPaste 的架构、快捷键截图、任务栏图标触发和标注实现讲清楚后你也能用这套源码思路在半天内搭出自己合手的截图工具少走我已经踩过的这些坑。本文还有配套的精品资源点击获取
