剪贴板监视器

Clipboard Monitor

我有问题。我正在尝试为我的 C# 应用程序使用 ClipboardMonitor。目标是监视剪贴板中的每个更改。 开始监控:

AddClipboardFormatListener(this.Handle);

要停止侦听器:

RemoveClipboardFormatListener(this.Handle);

以及覆盖 WndProc() 方法:

const int WM_DRAWCLIPBOARD = 0x308;
const int WM_CHANGECBCHAIN = 0x030D;

protected override void WndProc(ref Message m)
{
    switch (m.Msg)
    {
        case WM_DRAWCLIPBOARD:
            IDataObject iData = Clipboard.GetDataObject();
            if (iData.GetDataPresent(DataFormats.Text))
            {
                ClipboardMonitor_OnClipboardChange((string)iData.GetData(DataFormats.Text));
            }
            break;

        default:
            base.WndProc(ref m);
            break;
    }
}

当然还有 DLL 导入:

[DllImport("user32.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static extern bool AddClipboardFormatListener(IntPtr hwnd);

[DllImport("user32.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static extern bool RemoveClipboardFormatListener(IntPtr hwnd);

但是在方法调用处设置断点 ClipboardMonitor_OnClipboardChange 并更改剪贴板时,我从未调用过该方法。

如何更改我的代码以便收到 WM_ 消息通知我剪贴板已更改?

问题是您处理的 window 消息有误。引用 AddClipboardFormatListener 的文档:

When a window has been added to the clipboard format listener list, it is posted a WM_CLIPBOARDUPDATE message whenever the contents of the clipboard have changed.

根据这些知识,将代码更改为:

const int WM_CLIPBOARDUPDATE = 0x031D;
protected override void WndProc(ref Message m)
{
    switch (m.Msg)
    {
        case WM_CLIPBOARDUPDATE:
            IDataObject iData = Clipboard.GetDataObject();
            if (iData.GetDataPresent(DataFormats.Text))
            {
                string data = (string)iData.GetData(DataFormats.Text);
            }
            break;


        default:
            base.WndProc(ref m);
            break;
    }
}

SharpClipboard 作为一个库可能会有更多好处,因为它将相同的功能封装到一个优秀的组件库中。然后,您可以访问它的 ClipboardChanged 事件,并在 cut/copied.

时检测各种数据格式

您可以选择要监控的各种数据格式:

var clipboard = new SharpClipboard();

clipboard.ObservableFormats.Texts = true;
clipboard.ObservableFormats.Files = true;
clipboard.ObservableFormats.Images = true;
clipboard.ObservableFormats.Others = true;

这是一个使用其 ClipboardChanged 事件的示例:

private void ClipboardChanged(Object sender, ClipboardChangedEventArgs e)
{
    // Is the content copied of text type?
    if (e.ContentType == SharpClipboard.ContentTypes.Text)
    {
        // Get the cut/copied text.
        Debug.WriteLine(clipboard.ClipboardText);
    }

    // Is the content copied of image type?
    else if (e.ContentType == SharpClipboard.ContentTypes.Image)
    {
        // Get the cut/copied image.
        Image img = clipboard.ClipboardImage;
    }

    // Is the content copied of file type?
    else if (e.ContentType == SharpClipboard.ContentTypes.Files)
    {
        // Get the cut/copied file/files.
        Debug.WriteLine(clipboard.ClipboardFiles.ToArray());

        // ...or use 'ClipboardFile' to get a single copied file.
        Debug.WriteLine(clipboard.ClipboardFile);
    }

    // If the cut/copied content is complex, use 'Other'.
    else if (e.ContentType == SharpClipboard.ContentTypes.Other)
    {
        // Do something with 'e.Content' here...
    }
}

您还可以找到发生 cut/copy 事件的应用程序及其详细信息:

private void ClipboardChanged(Object sender, SharpClipboard.ClipboardChangedEventArgs e)
{
    // Gets the application's executable name.
    Debug.WriteLine(e.SourceApplication.Name);
    // Gets the application's window title.
    Debug.WriteLine(e.SourceApplication.Title);
    // Gets the application's process ID.
    Debug.WriteLine(e.SourceApplication.ID.ToString());
    // Gets the application's executable path.
    Debug.WriteLine(e.SourceApplication.Path);
}

还有其他事件,例如 MonitorChanged 事件,它会在禁用剪贴板监视时侦听,这意味着您可以在运行时启用或禁用监视剪贴板。

除此之外,由于它是一个组件,您可以在 Designer View 中使用它,方法是将其拖放到 Windows 表单中,使任何人都可以非常轻松地自定义其选项并使用其内置事件。

SharpClipboard 似乎是 .NET 中剪贴板监视方案的最佳选择。

只是为了添加到 theB 的优秀答案中......

WM_DRAWCLIPBOARD 消息是设置“剪贴板查看器 Window”后使用的旧消息。这至少可以追溯到 Windows 95。从 Windows Vista 和 Windows Server 2008 开始,添加了“剪贴板格式侦听器”API。

旧的剪贴板查看器 Window 需要更多工作:

  • 通过调用 SetClipboardViewer() API.

    将您的 window 添加到接收剪贴板消息的对象链中
  • 当链中的另一个 window 添加或从链中删除自己时,您会收到一条 WM_CHANGECBCHAIN 消息,并且您需要通过将其传递给来处理该消息SendMessage() API.

    链中的下一个 window
  • 当您收到 WM_DRAWCLIPBOARD 消息时,您还需要使用 SendMessage() API 将消息传递给链中的下一个对象 (hwnd) .然后就可以处理剪贴板的变化内容了。

  • 关闭程序时,需要使用 ChangeClipboardChain() API.

    将其从链中删除

较新的剪贴板格式监听器只需要:

  • 通过调用 AddClipboardFormatListener() 开始监视剪贴板 API。

  • 等待 WM_CLIPBOARDUPDATE 消息通知您剪贴板内容已更改。

  • 在关闭程序之前,通过调用 RemoveClipboardFormatListener() 停止监视。

所有与通知链相关的问题都由 Windows 自动处理。

另一个关键区别:WM_DRAWCLIPBOARD 是 sent (non-queued) 消息,您的程序必须立即处理该消息。 WM_CLIPBOARDUPDATE 是 posted(排队)消息,它将被添加到队列中,在您的程序执行完其当前进程后将在队列中处理。

这意味着当 WM_DRAWCLIPBOARD 消息通过时,您的程序必须立即处理它,即使您正在执行代码。例如,假设您创建了一个剪贴板监视器,允许您保存和检索过去的剪辑,并将那些过去的剪辑加载到剪贴板。您已决定使用较旧的 SetClipboardViewer() API,它将在剪贴板更改时触发 WM_DRAWCLIPBOARD 消息。当您执行将旧剪辑加载回剪贴板的代码时,您刚刚更改了剪贴板内容,这将触发消息。如果您在 Visual Studio 中逐行执行 C# 代码,Clipboard.SetText() 方法将触发消息,您将立即返回到 WndProc() 方法,开始整个过程再次。 WndProc() 方法完成后,您将继续执行 Clipboard.SetText().

之后的下一行代码

如果相反,您使用较新的 AddClipboardFormatListener() API,您也可以使用 Clipboard.SetText() 方法,但它不会触发即时消息。 WM_CLIPBOARDUPDATE 消息被添加到队列中,在您的代码执行完毕之前,您的程序不会处理它。如果您逐行执行代码,则可以执行 Clipboard.SetText() 方法并简单地移至下一行。当您的程序完成其正在执行的操作时,您将返回到 WndProc() 方法来处理 WM 消息。以下是有关消息队列和路由的一些 Microsoft 文档: Windows Message Routing

有时我们的程序需要以不同的方式处理 WM 消息,具体取决于触发消息的内容。如果最终用户将新剪辑复制到剪贴板,我们将要处理该 WM 消息。如果最终用户使用我们的程序将保存的旧剪辑加载回剪贴板,我们将希望我们的程序忽略由此产生的 WM 消息。忽略 WM 消息的一种方法是创建一个名为“忽略”的 public class 整数 属性。每次我们的代码更改剪贴板内容(而不是用户复制新内容)时,我们首先增加(增加)Class.Ignore 属性。我们在 WndProc() 方法中添加一个 If 语句,以便仅在 ignore 属性 为零时才处理 WM 剪贴板消息。如果 Class.Ignore 大于零,WndProc() 将忽略该消息。每次它忽略一条消息时,它也会递减(减少)Class.Ignore 整数。这就是程序如何知道 WM_ 消息是通过复制新剪辑生成的,还是从 re-loaded 到剪贴板的旧剪辑生成的。

请记住,较新的 AddClipboardFormatListener() API 需要 Windows Vista(客户端计算机)或 Windows Server 2008(服务器计算机)或更高版本。但根据 2021 年 8 月的 this 文章,只有大约 0.5% 或更少的 Windows 用户仍在使用 XP 或更旧版本。

这是在 C# 中实现剪贴板格式侦听器的文章:
Monitor for clipboard changes using AddClipboardFormatListener

这里是微软任何感兴趣的人的文档(C++):
Microsoft Documentation on monitoring the clipboard

祝大家编程顺利。