提供对窗口系统剪贴板的访问的类。 有关详细信息,请参阅...
#
继承。
所有成员函数的列表。
公共成员 类 提供对窗口系统剪贴板的访问。
剪贴板提供了一种在应用程序之间复制和粘贴数据的简单机制。
支持相同的数据类型并使用类似的机制。 有关剪贴板的高级用法,请阅读拖放文档。
应用程序中只有一个,您可以使用 ::() 访问它。
例子:
QClipboard *cb = QApplication::clipboard(); QString text; // 从剪贴板中复制文本(粘贴) text = cb->text(); if ( text ) qDebug( "The clipboard contains: %s", text ); // 把文本复制到剪贴板 cb->setText( "This text can be pasted by other programs" );
提供了一些特殊且方便的函数来访问常见数据类型:() 允许在应用程序之间交换文本,() 和 () 允许在应用程序之间交换和。 () 函数在功能上是最灵活的:它允许您将任何内容添加到剪贴板。 每个方法都有对应的获取函数,如text()、image()和()。
您可以通过调用clear()来清除剪贴板。
X 系统和Mi 的底层剪贴板是不同的。 X 系统有一个选择的概念 - 当选择文本时,它会立即复制到选择缓冲区; 仅当明确复制或剪切文本时, 才会将其复制到剪贴板。 X 系统也有所有权的概念。 如果您更改窗口中的选择,X11 仅通知所有者和前一个所有者更改。 在中,剪贴板是完全全局的资源,因此所有应用程序都会收到更改通知。 请参阅示例 Qt 中的示例,这是一个多平台剪贴板应用程序,还描述了选择处理。
另请参见环境类以及输入/输出和网络。
成员函数文档 void::clear () 清除剪贴板的内容。 * ::data () const 返回表示当前剪贴板数据的引用。 void::() [信号]
当剪贴板内容更改时会发出此信号。
::image () const 返回剪贴板图像,如果剪贴板不包含任何图像或包含格式不受支持的图像,则返回无效图像。
另请参见 ()、()、data() 和 ::()。
bool :: () const 如果剪贴板对象拥有剪贴板数据,则返回 true,否则返回 false。 bool :: () const 如果剪贴板对象有鼠标选择数据,则返回 true,否则返回 false。 :: () const 返回剪贴板像素图,如果剪贴板不包含像素图,则返回无效像素图。 请注意,这将导致信息丢失。 例如,如果图像是24位,显示是8位,则结果将转换为8位,如果图像有alpha通道,则结果将只是一个蒙版。
另请参见 ()、image()、data() 和 ::()。
void::() [信号]
当选择更改时会发出此信号。 这只适用于支持选择的窗口系统,例如 X11。 不支持选择。
bool::() const 返回选择模式。
另请参阅 () 和 ()。
void :: ( *src ) 设置剪贴板数据位 src。 数据的所有权被传递到剪贴板。 如果要删除此数据,请使用新数据再次调用clear()或call()。
子类是放置在剪贴板上的合理对象(但不要尝试在同一对象上调用::drag())。 放置在剪贴板上的任何父对象都必须为 0。不要将子类放置在剪贴板上,因为它们不属于接收它们的事件处理程序。
()和()函数分别是简单的文本和图像数据的封装。
void :: ( &image ) 将图像复制到剪贴板。
这是一个快速方法:
setData(new QImageDrag(image))
另请参见图像()、() 和()。
void :: ( & ) 复制到剪贴板。 请注意,这比 () 慢,因为它需要转换为 .
另请参阅 ( )、( ) 和 ( )。
void :: ( ) 设置剪贴板选择模式。 如果为 true,则后续调用 ::() 和其他将数据放入剪贴板的函数会将数据放入鼠标选择中,否则数据将放入剪贴板。
另请参阅 () 和 ()。
void :: ( &text ) 将文本作为简单文本复制到剪贴板。
另请参见text() 和()。
bool::() const 如果剪贴板支持鼠标选择,则返回 true,否则返回 false。 ::text ( & ) const 返回剪贴板文本的子类型,如果剪贴板不包含任何文本,则返回无效字符串。 如果为空,则任何子类型都可接受并设置为选定的子类型。
的值应该是“plain”和“html”。
另请参见 ()、data() 和 ::!()。
::text () const 这是一个为了方便起见的重载成员函数。 它的行为与上面的函数基本相同。
以纯文本形式返回剪贴板文本,如果剪贴板不包含文本,则返回无效字符串。
另请参见 ()、data() 和 ::!()。