QMimeData ¶

QMimeData class provides a container for data that records information about its MIME type. 更多 …

概要 ¶

函数 ¶

def clear ()
def colorData ()
def data (mimetype)
def hasColor ()
def hasHtml ()
def hasImage ()
def hasText ()
def hasUrls ()
def html ()
def imageData ()
def removeFormat (mimetype)
def setColorData (color)
def setData (mimetype, data)
def setHtml (html)
def setImageData (image)
def setText (text)
def setUrls (urls)
def text ()
def urls ()

虚函数 ¶

def formats ()
def hasFormat (mimetype)
def retrieveData (mimetype, preferredType)

详细描述 ¶

QMimeData is used to describe information that can be stored in the clipboard , and transferred via the 拖放 mechanism. QMimeData objects associate the data that they hold with the corresponding MIME types to ensure that information can be safely transferred between applications, and copied around within the same application.

QMimeData objects are usually created using new and supplied to QDrag or QClipboard objects. This is to enable Qt to manage the memory that they use.

A single QMimeData object can store the same data using several different formats at the same time. The formats() function returns a list of the available formats in order of preference. The data() function returns the raw data associated with a MIME type, and setData() allows you to set the data for a MIME type.

For the most common MIME types, QMimeData provides convenience functions to access the data:

Tester

Getter

Setter

MIME Types

hasText()

text()

setText()

text/plain

hasHtml()

html()

setHtml()

text/html

hasUrls()

urls()

setUrls()

text/uri-list

hasImage()

imageData()

setImageData()

image/ *

hasColor()

colorData()

setColorData()

application/x-color

For example, if your write a widget that accepts URL drags, you would end up writing code like this:
def dragEnterEvent(self, event):
    if event.mimeData().hasUrls():
        event.acceptProposedAction()
def dropEvent(self, event):
    if event->mimeData().hasUrls():
        for url in event.mimeData().urls():
            ...
											
There are three approaches for storing custom data in a QMimeData 对象：
Custom data can be stored directly in a QMimeData object as a QByteArray 使用 setData() 。例如：
csvData = QByteArray(...)
mimeData = QMimeData()
mimeData.setData("text/csv", csvData)
													
We can subclass QMimeData and reimplement hasFormat() , formats() ，和 retrieveData() .
If the drag and drop operation occurs within a single application, we can subclass QMimeData and add extra data in it, and use a qobject_cast() in the receiver’s drop event handler. For example:
def dropEvent(self, event):
    myData = event->mimeData()
    if myData:
        # access myData's data directly (not through QMimeData's API)
}
													

特定平台 MIME 类型 ¶

在 Windows， formats() will also return custom formats available in the MIME data, using the x-qt-windows-mime subtype to indicate that they represent data in non-standard formats. The formats will take the following form:
application/x-qt-windows-mime;value="<custom type>"
												
The following are examples of custom MIME types:
application/x-qt-windows-mime;value="FileGroupDescriptor"
application/x-qt-windows-mime;value="FileContents"
												
value declaration of each format describes the way in which the data is encoded.

In some cases (e.g. dropping multiple email attachments), multiple data values are available. They can be accessed by adding an index 值：
application/x-qt-windows-mime;value="FileContents";index=0
application/x-qt-windows-mime;value="FileContents";index=1
												
On Windows, the MIME format does not always map directly to the clipboard formats. Qt provides QWinMime to map clipboard formats to open-standard MIME formats. Similarly, the QMacPasteboardMime maps MIME to Mac flavors.

另请参阅

QClipboard QDragEnterEvent QDragMoveEvent QDropEvent QDrag 拖放

class QMimeData ¶: Constructs a new MIME data object with no data in it.

PySide2.QtCore.QMimeData. clear ( ) ¶: Removes all the MIME type and data entries in the object.

PySide2.QtCore.QMimeData. colorData ( ) ¶

返回类型: object

Returns a color if the data stored in the object represents a color (MIME type application/x-color ); otherwise returns a null variant.

A QVariant is used because QMimeData belongs to the Qt Core module, whereas QColor belongs to Qt GUI. To convert the QVariant 到 QColor , simply use qvariant_cast() 。例如：

												if event.mimeData().hasColor():
    color = QColor(event.mimeData().colorData())
    ...
												
											

另请参阅

hasColor() setColorData() data()

PySide2.QtCore.QMimeData. data ( mimetype ) ¶

参数: mimetype – unicode
返回类型: QByteArray

Returns the data stored in the object in the format described by the MIME type specified by mimeType .

另请参阅

setData()

PySide2.QtCore.QMimeData. formats ( ) ¶

返回类型: 字符串列表

Returns a list of formats supported by the object. This is a list of MIME types for which the object can return suitable data. The formats in the list are in a priority order.

For the most common types of data, you can call the higher-level functions hasText() , hasHtml() , hasUrls() , hasImage() ，和 hasColor() 代替。

另请参阅

hasFormat() setData() data()

PySide2.QtCore.QMimeData. hasColor ( ) ¶

返回类型: bool

返回 true if the object can return a color (MIME type application/x-color ); otherwise returns false .

另请参阅

setColorData() colorData() hasFormat()

PySide2.QtCore.QMimeData. hasFormat ( mimetype ) ¶

参数: mimetype – unicode
返回类型: bool

返回 true if the object can return data for the MIME type specified by mimeType ；否则返回 false .

For the most common types of data, you can call the higher-level functions hasText() , hasHtml() , hasUrls() , hasImage() ，和 hasColor() 代替。

另请参阅

formats() setData() data()

PySide2.QtCore.QMimeData. hasHtml ( ) ¶

返回类型: bool

返回 true if the object can return HTML (MIME type text/html ); otherwise returns false .

另请参阅

setHtml() html() hasFormat()

PySide2.QtCore.QMimeData. hasImage ( ) ¶

返回类型: bool

返回 true if the object can return an image; otherwise returns false.

另请参阅

setImageData() imageData() hasFormat()

PySide2.QtCore.QMimeData. hasText ( ) ¶

返回类型: bool

返回 true if the object can return plain text (MIME type text/plain ); otherwise returns false .

另请参阅

setText() text() hasHtml() hasFormat()

PySide2.QtCore.QMimeData. hasUrls ( ) ¶

返回类型: bool

返回 true if the object can return a list of urls; otherwise returns false .

URLs correspond to the MIME type text/uri-list .

另请参阅

setUrls() urls() hasFormat()

PySide2.QtCore.QMimeData. html ( ) ¶

返回类型: unicode

Returns a string if the data stored in the object is HTML (MIME type text/html ); otherwise returns an empty string.

另请参阅

setHtml() hasHtml() setData()

PySide2.QtCore.QMimeData. imageData ( ) ¶

返回类型: object

返回 QVariant storing a QImage if the object can return an image; otherwise returns a null variant.

A QVariant is used because QMimeData belongs to the Qt Core module, whereas QImage belongs to Qt GUI. To convert the QVariant 到 QImage , simply use qvariant_cast() 。例如：

												if event.mimeData().hasImage():
    image = QImage(event.mimeData().imageData())
    ...
												
											

另请参阅

setImageData() hasImage()

PySide2.QtCore.QMimeData. removeFormat ( mimetype ) ¶

参数: mimetype – unicode

Removes the data entry for mimeType in the object.

PySide2.QtCore.QMimeData. retrieveData ( mimetype , preferredType ) ¶

参数

mimetype – unicode
preferredType – QVariant::Type

返回类型

object

Returns a variant with the given type containing data for the MIME type specified by mimeType . If the object does not support the MIME type or variant type given, a null variant is returned instead.

This function is called by the general data() getter and by the convenience getters ( text() , html() , urls() , imageData() ，和 colorData() ). You can reimplement it if you want to store your data using a custom data structure (instead of a QByteArray , which is what setData() provides). You would then also need to reimplement hasFormat() and formats() .

另请参阅

data()

PySide2.QtCore.QMimeData. setColorData ( color ) ¶

参数: color – object

Sets the color data in the object to the given color .

Colors correspond to the MIME type application/x-color .

另请参阅

colorData() hasColor() setData()

PySide2.QtCore.QMimeData. setData ( mimetype , data ) ¶

参数

mimetype – unicode
data – QByteArray

Sets the data associated with the MIME type given by mimeType 到指定 data .

For the most common types of data, you can call the higher-level functions setText() , setHtml() , setUrls() , setImageData() ，和 setColorData() 代替。

Note that if you want to use a custom data type in an item view drag and drop operation, you must register it as a Qt meta type ，使用 Q_DECLARE_METATYPE() macro, and implement stream operators for it. The stream operators must then be registered with the qRegisterMetaTypeStreamOperators() 函数。

另请参阅

data() hasFormat() QMetaType qRegisterMetaTypeStreamOperators()

PySide2.QtCore.QMimeData. setHtml ( html ) ¶

参数: html – unicode

集 html as the HTML (MIME type text/html ) used to represent the data.

另请参阅

html() hasHtml() setText() setData()

PySide2.QtCore.QMimeData. setImageData ( image ) ¶

参数: image – object

Sets the data in the object to the given image .

A QVariant is used because QMimeData belongs to the Qt Core module, whereas QImage belongs to Qt GUI. The conversion from QImage to QVariant is implicit. For example:

												mimeData.setImageData(QImage("beautifulfjord.png"))
												
											

另请参阅

imageData() hasImage() setData()

PySide2.QtCore.QMimeData. setText ( text ) ¶

参数: text – unicode

集 text as the plain text (MIME type text/plain ) used to represent the data.

另请参阅

text() hasText() setHtml() setData()

PySide2.QtCore.QMimeData. setUrls ( urls ) ¶

参数: urls –

Sets the URLs stored in the MIME data object to those specified by urls .

URLs correspond to the MIME type text/uri-list .

Since Qt 5.0, also exports the urls as plain text, if setText was not called before, to make it possible to drop them into any lineedit and text editor.

另请参阅

urls() hasUrls() setData()

PySide2.QtCore.QMimeData. text ( ) ¶

返回类型: unicode

Returns a plain text (MIME type text/plain ) representation of the data.

另请参阅

setText() hasText() html() data()

PySide2.QtCore.QMimeData. urls ( ) ¶

返回类型

Returns a list of URLs contained within the MIME data object.

URLs correspond to the MIME type text/uri-list .

另请参阅

setUrls() hasUrls() data()

Tester	Getter	Setter	MIME Types
`hasText()`	`text()`	`setText()`	`text/plain`
`hasHtml()`	`html()`	`setHtml()`	`text/html`
`hasUrls()`	`urls()`	`setUrls()`	`text/uri-list`
`hasImage()`	`imageData()`	`setImageData()`	`image/` *
`hasColor()`	`colorData()`	`setColorData()`	`application/x-color`

内容表

上一话题

下一话题

快速搜索

QMimeData ¶

概要 ¶

函数 ¶

虚函数 ¶

详细描述 ¶

特定平台 MIME 类型 ¶