Qt5.14.2 剪贴板之巧——Qt让“复制粘贴“更高效

作为现代图形界面程序的标配功能，剪贴板操作在日常办公和编程中无疑是最常见的场景之一。而在Qt的疆场内，大神们也为我们准备了一手利器——QClipboard类，让复制粘贴操作变得前所未有的简单高效。今天，就让我们一睹究竟，领略Qt大神们在这方面的非凡功力吧!

一、QClipboard的惊艳一"剪"

如果单从名字上看，QClipboard给人的感觉就是个简单的"剪贴板"类而已。但当我们真正开始使用时，它的强大之处就暴露无遗了。

1、复制文本一"剪"呼啸

在现代计算机系统中，纯文本数据无疑是最常见、也是最基本的传输形式。让我们看看如何在Qt中优雅地复制和粘贴纯文本吧:

QClipboard *clipboard = QApplication::clipboard();

// 复制文本到剪贴板
QString textToCopy = "Hello Qt Clipboard!";
clipboard->setText(textToCopy);

// 从剪贴板获取文本
QString clipText = clipboard->text();
qDebug() << "Clipboard text:" << clipText;

上面的代码展示了如何通过QClipboard::setText()方法将一个QString对象的内容复制到系统剪贴板中。而要获取剪贴板中的文本内容，我们只需调用QClipboard::text()方法即可。

简单到让人感动的API设计，正是Qt大神们的一贯风格。他们将常见需求抽象成易于使用的接口，使我们的开发之路如虎添翼，岂不美哉?

2、复制图像一"粘"而就

纯文本固然重要，但在图形界面程序中，图像数据同样不可或缺。而Qt在这方面自然也做足了功课，为我们提供了复制粘贴图像的完美解决方案。

// 复制图像
QClipboard *clipboard = QApplication::clipboard();
QPixmap pixmap(":/images/qt-logo.png");
clipboard->setPixmap(pixmap);

// 读取图像
QPixmap clipPixmap = clipboard->pixmap();
if (!clipPixmap.isNull()) {
    QLabel *imageLabel = new QLabel;
    imageLabel->setPixmap(clipPixmap);
    imageLabel->show();
}

这段代码先从资源文件加载了一个QPixmap对象，然后直接调用QClipboard::setPixmap()方法将其复制到剪贴板。要获取剪贴板中的图像，我们只需调用QClipboard::pixmap()方法即可拿到一个QPixmap对象。

是不是觉得Qt的剪贴板支持实在是太人性化了?无论是文本还是图像数据，我们都可以用极其简单直白的方式在应用程序与剪贴板间自由移动。

3、数据自由自在地"粘"来"粘"去

那复制了数据之后，我们如何获取呢?QClipboard同样是手到擒来:

QClipboard *clipboard = QApplication::clipboard();

if (clipboard->text() == textToCopy)
    qDebug() << "复制文本成功";

if (!clipboard->image().isNull())
    qDebug() << "复制图像成功";

无论是text()用于获取文本数据，还是image()用于获取图像数据，QClipboard都为我们提供了极其便利的API。有了这些小助手在手，剪贴板操作实在是易如反掌。

二、常见坑，当心了

用好Qt剪贴板操作看似轻而易举，但实际上在使用过程中也常常会遇到一些令人头疼的"坑"。好在Qt大神们并非吝啬秘笈，而是替我们考虑周全，提供了应对之策。

1、剪贴板所有权

有时我们会发现，虽然已经成功复制了数据到剪贴板，但粘贴后数据却丢失或损坏了。这很可能是因为Qt在内部使用了显式共享或者QWindow::setClipboard机制，导致剪贴板所有权发生了变化。

对策是，我们需要主动获取剪贴板所有权，确保对其拥有独占访问权。代码如下:

QClipboard *clipboard = QApplication::clipboard();
clipboard->setSelectionMode(true); // 获取剪贴板所有权

通过调用QClipboard::setSelectionMode(true)，我们就可以成为剪贴板内容的所有者。当然，用完后也需要调用setSelectionMode(false)释放所有权。

2、多线程安全

在多线程环境下操作剪贴板，很容易遇到数据竞争的问题。比如两个线程同时读写剪贴板，就可能导致意料之外的结果。

为了避免这种情况，Qt专门提供了QClipboard::supportsThreadModal()方法，让我们检查当前系统剪贴板是否支持线程模态模式。如果支持，我们就可以开启线程模态模式保证剪贴板访问的原子性:

if (clipboard->supportsThreadModal()) {
    clipboard->startThreadModal(); // 开启线程模态模式
    // 操作剪贴板
    clipboard->endThreadModal(); // 结束线程模态模式
}

通过上述方式，我们就可以确保在任何时候，只有一个线程能够访问剪贴板，从而避免了潜在的数据竞争问题。

3、其他注意事项

比如由于剪贴板是系统资源，有时可能会被其他程序占用，从而导致我们的操作失败。再者，有时剪贴板的内容变化会非常频繁，我们需要特别注意监听QClipboard发出的相关信号。

所幸，QClipboard本身就已经为我们做好了完备的准备。我们可以利用其提供的findBufferChanged()、selectionChanged()和dataChanged()信号，及时捕获剪贴板内容的变化，并作出相应处理:

QClipboard *clipboard = QApplication::clipboard();
connect(clipboard, &QClipboard::dataChanged, this, [=](){
   // 剪贴板内容发生变化
   handleClipboardDataChange();
});

此外，QClipboard提供了剪贴板是否可用的ownsClipboard()和ownsFindBuffer()函数，我们也可以在必要时检查剪贴板的占用情况，避免不必要的失败尝试。

除了上述常见"坑"外，在使用Qt剪贴板操作时，我们还需要注意以下几点:

• 及时清理不再需要的数据，防止占用过多系统资源
• 合理设置剪贴板模式(Clipboard/Selection/FindBuffer)
• 注意跨平台的行为差异，不同操作系统对剪贴板的处理可能不尽相同

所以说，只要我们掌握了QClipboard提供的各种小窍门，就没有什么可以阻挡我们在剪贴板上为所欲为了。当然，Qt大神们在剪贴板这一领域所施展的神乎其技远不止如此…

究竟QClipboard还将为我们带来怎样更多的惊喜?让我们拭目以待!毕竟，就算是复制粘贴这种"小儿科"操作，也足以看出Qt大神们对极致体验的非凡追求了。相信只要我们跟随大神的脚步，定能在软件开发的海洋中越挥越远，创造出更多无与伦比的神级作品!