C# 编写一个简单易用的 Windows 截屏增强工具

半年前我开源了 DreamScene2 一个小而快并且功能强大的 Windows 动态桌面软件。有很多的人喜欢，这使我有了继续做开源的信心。这是我的第二个开源作品 ScreenshotEx 一个简单易用的 Windows 截屏增强工具。

欢迎 Star 和 Fork https://github.com/he55/ScreenshotEx

前言

在使用 Windows 系统的截屏快捷键

PrintScreen

截屏时，如果需要把截屏保存到文件，需要先粘贴到画图工具然后另存为文件。以前我还没有觉得很麻烦，后来使用了 macOS 系统的截屏工具，我才知道原来一个小小的截屏工具也可以这么简单易用。于是参考 macOS 系统的截屏工具做了一个 Windows 版的。

功能

• 自动保存截屏到桌面

  

• 点击截屏预览可以编辑截屏

  

实现原理

如果想在按下系统的截屏快捷键后做一些事情，能想到的方法应该就是如何监听键盘事件。WIN32 API 提供的 SetWindowsHookExA 钩子函数刚好可以实现这个需求，

idHook

参数设置成

WH_KEYBOARD_LL

时是低等级键盘钩子可以捕获键盘消息。

SetWindowsHookExA

函数定义

HHOOK SetWindowsHookExA(
[in] int       idHook,    // 钩子类型
[in] HOOKPROC  lpfn,      // 钩子处理函数
[in] HINSTANCE hmod,      // 模块句柄
[in] DWORD     dwThreadId // 线程Id
);

键盘处理函数定义

LRESULT CALLBACK LowLevelKeyboardProc(
_In_ int    nCode,
_In_ WPARAM wParam, // 键盘消息
_In_ LPARAM lParam // KBDLLHOOKSTRUCT 结构体指针
);

代码

C# PInvoke 定义

const int HC_ACTION = 0;
const int WH_KEYBOARD_LL = 13;
const int WM_KEYUP = 0x0101;
const int WM_SYSKEYUP = 0x0105;
const int VK_SNAPSHOT = 0x2C;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)]
public struct KBDLLHOOKSTRUCT
{
public uint vkCode;
public uint scanCode;
public uint flags;
public uint time;
public UIntPtr dwExtraInfo;
}

[UnmanagedFunctionPointer(CallingConvention.Winapi)]
public delegate IntPtr HookProc(int nCode, IntPtr wParam, ref KBDLLHOOKSTRUCT lParam);

[DllImport("User32.dll", SetLastError = true, CharSet = CharSet.Auto)]
public static extern IntPtr SetWindowsHookEx(int idHook, HookProc lpfn, IntPtr hmod, int dwThreadId);

[DllImport("User32.dll", SetLastError = true, ExactSpelling = true)]
[return: MarshalAs(UnmanagedType.Bool)]
public static extern bool UnhookWindowsHookEx(IntPtr hhk);

[DllImport("User32.dll", SetLastError = false, ExactSpelling = true)]
public static extern IntPtr CallNextHookEx(IntPtr hhk, int nCode, IntPtr wParam, ref KBDLLHOOKSTRUCT lParam);

[DllImport("Kernel32.dll", SetLastError = true, CharSet = CharSet.Auto)]
public static extern IntPtr GetModuleHandle([Optional] string lpModuleName);

注册键盘钩子

需要注意：因为

SetWindowsHookEx

是非托管函数第二个参数是个委托类型，

GC

不会记录非托管函数对

.NET

对象的引用。如果用临时变量保存委托出作用域就会被

GC

释放，当

SetWindowsHookEx

去调用已经被释放的委托就会报错。

SetWindowsHookEx

函数第一个参数传

WH_KEYBOARD_LL

低等级键盘钩子、第二个参数传键盘消息处理函数的委托、第三个参数使用

GetModuleHandle

函数获取模块句柄、第四个参数传 0。

HookProc _hookProc;
IntPtr _hhook;

void StartHook()
{
_hookProc = new HookProc(LowLevelKeyboardProc); // 使用成员变量保存委托
_hhook = SetWindowsHookEx(WH_KEYBOARD_LL, _hookProc, GetModuleHandle(null), 0); // 注册键盘钩子，保存返回值卸载钩子时用到。GetModuleHandle(null) 获取当前模块句柄
}

键盘消息处理函数

在键盘消息处理函数里面捕获

PrintScreen

按键消息，然后显示预览和保存图片逻辑

IntPtr LowLevelKeyboardProc(int nCode, IntPtr wParam, ref KBDLLHOOKSTRUCT lParam)
{
if (nCode == HC_ACTION)
{
if (lParam.vkCode == VK_SNAPSHOT) // 捕获 PrintScreen 按键消息
{
if ((int)wParam == WM_KEYUP || (int)wParam == WM_SYSKEYUP) // 按键释放时保存图片
SaveImage();
else
_previewWindow.SetHide();
}
}
return CallNextHookEx(_hhook, nCode, wParam, ref lParam);
}

保存图片

从系统剪贴板获取图片

void SaveImage()
{
if (Clipboard.ContainsImage())
{
if (!Directory.Exists(_settings.SavePath))
Directory.CreateDirectory(_settings.SavePath);

string ext = "png";
ImageFormat imageFormat = ImageFormat.Png;
switch (_settings.SaveExtension)
{
case 0:
imageFormat = ImageFormat.Png;
ext = "png";
break;
case 1:
imageFormat = ImageFormat.Jpeg;
ext = "jpg";
break;
case 2:
imageFormat = ImageFormat.Bmp;
ext = "bmp";
break;
}

if (_settings.SaveName == 0)
{
string name = DateTime.Now.ToString("yyyy-MM-dd HH.mm.ss");
_saveFilePath = Path.Combine(_settings.SavePath, $"{PrefixName} {name}.{ext}");
}
else
{
do
{
_saveFilePath = Path.Combine(_settings.SavePath, $"{PrefixName} {_nameIndex}.{ext}");
_nameIndex++;
} while (File.Exists(_saveFilePath));
}

Image image = Clipboard.GetImage();
image.Save(_saveFilePath, imageFormat);

if (_settings.IsPlaySound)
_soundPlayer.Play();

if (_settings.IsShowPreview)
_previewWindow.SetImage(_saveFilePath);
}
}

完整代码 https://github.com/he55/ScreenshotEx