PySide.QtGui.QClipboard class provides access to the window system clipboard.
剪贴板提供在应用程序之间拷贝和粘贴数据的简单机制。
PySide.QtGui.QClipboard supports the same data types that PySide.QtGui.QDrag 做的，且使用类似机制。对于高级剪贴板用法，请阅读 拖放 .
There is a single PySide.QtGui.QClipboard object in an application, accessible as QApplication.clipboard() .
范例：
clipboard = QApplication.clipboard()
originalText = clipboard.text()
...
clipboard.setText(newText)
PySide.QtGui.QClipboard features some convenience functions to access common data types: PySide.QtGui.QClipboard.setText() allows the exchange of Unicode text and PySide.QtGui.QClipboard.setPixmap() and PySide.QtGui.QClipboard.setImage() allows the exchange of QPixmaps and QImages between applications. The PySide.QtGui.QClipboard.setMimeData() function is the ultimate in flexibility: it allows you to add any PySide.QtCore.QMimeData into the clipboard. There are corresponding getters for each of these, e.g. PySide.QtGui.QClipboard.text() , PySide.QtGui.QClipboard.image() and PySide.QtGui.QClipboard.pixmap() . You can clear the clipboard by calling PySide.QtGui.QClipboard.clear() .
A typical example of the use of these functions follows:
def paste(self):
clipboard = QApplication.clipboard()
mimeData = clipboard.mimeData()
if mimeData.hasImage():
setPixmap(mimeData.imageData())
elif mimeData.hasHtml():
setText(mimeData.html())
setTextFormat(Qt.RichText)
elif (mimeData.hasText():
setText(mimeData.text())
setTextFormat(Qt.PlainText)
else:
setText(tr("Cannot display data"))
This enum type is used to control which part of the system clipboard is used by QClipboard.mimeData() , QClipboard.setMimeData() and related functions.
| 常量 | 描述 |
|---|---|
| QClipboard.Clipboard | indicates that data should be stored and retrieved from the global clipboard. |
| QClipboard.Selection | indicates that data should be stored and retrieved from the global mouse selection. Support for Selection is provided only on systems with a global mouse selection (e.g. X11). |
| QClipboard.FindBuffer | indicates that data should be stored and retrieved from the Find buffer. This mode is used for holding search strings on Mac OS X. |
| 参数： | mode – PySide.QtGui.QClipboard.Mode |
|---|
| 参数： | mode – PySide.QtGui.QClipboard.Mode |
|---|
清零剪贴板内容。
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , this function clears the global clipboard contents. If mode is QClipboard.Selection , this function clears the global mouse selection contents. If mode is QClipboard.FindBuffer , this function clears the search string buffer.
另请参阅
QClipboard.Mode PySide.QtGui.QClipboard.supportsSelection()
| 参数： | mode – PySide.QtGui.QClipboard.Mode |
|---|
| 参数： | mode – PySide.QtGui.QClipboard.Mode |
|---|---|
| 返回类型： | PySide.QtGui.QImage |
Returns the clipboard image, or returns a null image if the clipboard does not contain an image or if it contains an image in an unsupported image format.
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , the image is retrieved from the global clipboard. If mode is QClipboard.Selection , the image is retrieved from the global mouse selection.
| 参数： | mode – PySide.QtGui.QClipboard.Mode |
|---|---|
| 返回类型： | PySide.QtCore.QMimeData |
返回引用为 PySide.QtCore.QMimeData representation of the current clipboard data.
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , the data is retrieved from the global clipboard. If mode is QClipboard.Selection , the data is retrieved from the global mouse selection. If mode is QClipboard.FindBuffer , the data is retrieved from the search string buffer.
PySide.QtGui.QClipboard.text() , PySide.QtGui.QClipboard.image() ，和 PySide.QtGui.QClipboard.pixmap() functions are simpler wrappers for retrieving text, image, and pixmap data.
| 返回类型： | PySide.QtCore.bool |
|---|
Returns true if this clipboard object owns the clipboard data; otherwise returns false.
| 返回类型： | PySide.QtCore.bool |
|---|
Returns true if this clipboard object owns the find buffer data; otherwise returns false.
| 参数： | mode – PySide.QtGui.QClipboard.Mode |
|---|---|
| 返回类型： | PySide.QtCore.bool |
| 返回类型： | PySide.QtCore.bool |
|---|
Returns true if this clipboard object owns the mouse selection data; otherwise returns false.
| 参数： | mode – PySide.QtGui.QClipboard.Mode |
|---|---|
| 返回类型： | PySide.QtGui.QPixmap |
Returns the clipboard pixmap, or null if the clipboard does not contain a pixmap. Note that this can lose information. For example, if the image is 24-bit and the display is 8-bit, the result is converted to 8 bits, and if the image has an alpha channel, the result just has a mask.
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , the pixmap is retrieved from the global clipboard. If mode is QClipboard.Selection , the pixmap is retrieved from the global mouse selection.
| 参数： |
|
|---|
拷贝 image into the clipboard.
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , the image is stored in the global clipboard. If mode is QClipboard.Selection , the data is stored in the global mouse selection.
This is shorthand for:
data = QMimeData()
data.setImageData(image)
clipboard.setMimeData(data, mode)
| 参数： |
|
|---|
Sets the clipboard data to src . Ownership of the data is transferred to the clipboard. If you want to remove the data either call PySide.QtGui.QClipboard.clear() or call PySide.QtGui.QClipboard.setMimeData() again with new data.
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , the data is stored in the global clipboard. If mode is QClipboard.Selection , the data is stored in the global mouse selection. If mode is QClipboard.FindBuffer , the data is stored in the search string buffer.
PySide.QtGui.QClipboard.setText() , PySide.QtGui.QClipboard.setImage() and PySide.QtGui.QClipboard.setPixmap() functions are simpler wrappers for setting text, image and pixmap data respectively.
| 参数： |
|
|---|
拷贝 pixmap into the clipboard. Note that this is slower than PySide.QtGui.QClipboard.setImage() because it needs to convert the PySide.QtGui.QPixmap 到 PySide.QtGui.QImage first.
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , the pixmap is stored in the global clipboard. If mode is QClipboard.Selection , the pixmap is stored in the global mouse selection.
| 参数： |
|
|---|
拷贝 text into the clipboard as plain text.
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , the text is stored in the global clipboard. If mode is QClipboard.Selection , the text is stored in the global mouse selection. If mode is QClipboard.FindBuffer , the text is stored in the search string buffer.
| 返回类型： | PySide.QtCore.bool |
|---|
Returns true if the clipboard supports a separate search buffer; otherwise returns false.
| 参数： | mode – PySide.QtGui.QClipboard.Mode |
|---|---|
| 返回类型： | PySide.QtCore.bool |
| 返回类型： | PySide.QtCore.bool |
|---|
Returns true if the clipboard supports mouse selection; otherwise returns false.
| 参数： |
|
|---|---|
| 返回类型： |
(retval, subtype) |
这是重载函数。
Returns the clipboard text in subtype subtype , or an empty string if the clipboard does not contain any text. If subtype is null, any subtype is acceptable, and subtype is set to the chosen subtype.
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , the text is retrieved from the global clipboard. If mode is QClipboard.Selection , the text is retrieved from the global mouse selection.
Common values for subtype are “plain” and “html”.
Note that calling this function repeatedly, for instance from a key event handler, may be slow. In such cases, you should use the dataChanged() signal instead.
| 参数： | mode – PySide.QtGui.QClipboard.Mode |
|---|---|
| 返回类型： | unicode |
Returns the clipboard text as plain text, or an empty string if the clipboard does not contain any text.
mode argument is used to control which part of the system clipboard is used. If mode is QClipboard.Clipboard , the text is retrieved from the global clipboard. If mode is QClipboard.Selection , the text is retrieved from the global mouse selection. If mode is QClipboard.FindBuffer , the text is retrieved from the search string buffer.