Qt4.8文档翻译：QClipboard类参考,QClipboard Class Reference

详细说明

QClipboard类提供了对于窗口系统的剪贴板的访问功能。

剪贴板提供了一种简单的用于在程序之间复制、粘贴数据的机制。

QClipboard与 QDrag 支持相同类型的数据 ，并且也是采用了类似的机制来提供支持。阅读 拖放 ，以了解剪贴板的高端用法。

在每个程序中，都只有一个唯一的QClipboard 对象，可通过QApplication::clipboard()来访问。

示例：

QClipboard *clipboard = QApplication ::clipboard();

QString originalText = clipboard-> text ();

...

clipboard-> setText (newText);

QClipboard提供了一些便利函数 ，用于处理常见的数据类型： setText ()可用于在程序之间交换 统一码 （Unicode）文本内容， setPixmap ()和 setImage ()可用于交换QPixmaps 和QImages 。 setMimeData ()函数是最灵活的手段 ：通过它 ，妳可以将任何的 QMimeData 放入剪贴板中。针对以上的任何一种数据类型，都有其对应的取值 （getters）函数，例如 text () 、 image ()和 pixmap () 。妳可以调用 clear ()来清空剪贴板。

以下是这些函数的典型用法：

void DropArea::paste()

{

const QClipboard *clipboard = QApplication ::clipboard();

const QMimeData *mimeData = clipboard->mimeData();

if (mimeData->hasImage()) {

setPixmap(qvariant_cast< QPixmap >(mimeData->imageData()));

} else if (mimeData->hasHtml()) {

setText(mimeData->html());

setTextFormat( Qt ::RichText);

} else if (mimeData->hasText()) {

setText(mimeData->text());

setTextFormat( Qt ::PlainText);

} else {

setText(tr("Cannot display data"));

}

X11 用户注意事项

• •.在X11窗口系统中，有一个概念，就是把当前选中的文字与剪贴板区分对待。当有文字被选中时 ，它会立即成为全局的鼠标选中文字内容。而全局的鼠标选中文字内容可能稍后会被复制到剪贴板中 。按照惯例 ，鼠标中键可用于将全局鼠标选中文字内容粘贴到当前输入框 。

• •.X11还有一个概念，就是所有者属性；如果妳在某个窗口中改变了当前选中的文字 ，则 X11只会向当前的所有者及前任的所有者发出关于此次改变的通知，也就是说，它并不会向所有的程序发出通知告之当前选中文字或剪贴板数据发生了改变。

• •.最后一点，X11的剪贴板是由事件驱动的，也就是说，如果事件循环当前并没有在运行，则剪贴板不会正常工作。类似地 ，建议妳在直接由用户输入事件触发的代码里储存或获取剪贴板的数据 ，例如，鼠标按钮或键盘的按下和松开事件 。妳不应当在由定时器或者某种非用户输入事件驱动的代码里储存或提取剪贴板内容 。

• •. 由于现在在X11 中并没有在程序之间复制粘贴文件的标准方式，所以 ，当前有多种 多用途互连网邮件扩展 （MIME） 类型和惯例处于使用当中。例如 ，在Nautilus 中 ，预期对于文件的剪贴板格式是 ，以 x-special/gnome-copied-files 这种 多用途互连网邮件扩展 类型来表示 ，其数据为 ，以剪切/复制动作开头，接下来是一个换行符 ，最后是该文件的 统一资源定位符 （URL）。

Mac OS X 用户注意事项

Mac OS X支持一个独立的查找 （find）缓冲区，它用于在 查找 操作中储存当前的搜索字符串 。这个与查找相关的剪贴板 ，可通过指定为 FindBuffer 模式来访问。

参考 QApplication 。

未知美人