QMimeData Class Reference · PyQt4 中文文檔

# QMimeData Class Reference ## [[QtCore](index.htm) module] 該QMimeData類提供一個容器，用于數據記錄有關它的MIME類型的信息。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self)` * `clear (self)` * `QVariant colorData (self)` * `QByteArray data (self, QString?mimetype)` * `QStringList formats (self)` * `bool hasColor (self)` * `bool hasFormat (self, QString?mimetype)` * `bool hasHtml (self)` * `bool hasImage (self)` * `bool hasText (self)` * `bool hasUrls (self)` * `QString html (self)` * `QVariant imageData (self)` * `removeFormat (self, QString?mimetype)` * `QVariant retrieveData (self, QString?mimetype, Type?preferredType)` * `setColorData (self, QVariant?color)` * `setData (self, QString?mimetype, QByteArray?data)` * `setHtml (self, QString?html)` * `setImageData (self, QVariant?image)` * `setText (self, QString?text)` * `setUrls (self, list-of-QUrl?urls)` * `QString text (self)` * `list-of-QUrl urls (self)` * * * ## Detailed Description 該QMimeData類提供一個容器，用于數據記錄有關它的MIME類型的信息。 QMimeData是用來描述可以存儲在信息[clipboard](qclipboard.html)，并經由傳輸[drag and drop](index.htm)機制。 QMimeData對象，它們與相應的MIME類型保存數據關聯起來，以確保信息可以在應用程序之間進行安全轉移，并在同一應用程序內各地復制。通常使用創建QMimeData對象`new`并供給到[QDrag](qdrag.html) or [QClipboard](qclipboard.html)對象。這是為了讓Qt的管理他們所使用的內存。單個QMimeData對象可以使用幾種不同的格式的同時存儲相同的數據。該[formats](qmimedata.html#formats)（）函數返回按優先順序排列的可用格式的列表。該[data](qmimedata.html#data)（）函數返回一個MIME類型相關聯的原始數據，并[setData](qmimedata.html#setData)（）允許您設置一個MIME類型的數據。對于最常見的MIME類型， QMimeData提供方便的功能來訪問數據： | Tester | Getter | Setter | MIME Types | | --- | --- | --- | --- | | [hasText](qmimedata.html#hasText)() | [text](qmimedata.html#text)() | [setText](qmimedata.html#setText)() | `text/plain` | | [hasHtml](qmimedata.html#hasHtml)() | [html](qmimedata.html#html)() | [setHtml](qmimedata.html#setHtml)() | `text/html` | | [hasUrls](qmimedata.html#hasUrls)() | [urls](qmimedata.html#urls)() | [setUrls](qmimedata.html#setUrls)() | `text/uri-list` | | [hasImage](qmimedata.html#hasImage)() | [imageData](qmimedata.html#imageData)() | [setImageData](qmimedata.html#setImageData)() | `image/` * | | [hasColor](qmimedata.html#hasColor)() | [colorData](qmimedata.html#colorData)() | [setColorData](qmimedata.html#setColorData)() | `application/x-color` | 例如，如果你寫一個接受URL的小工具拖拽，你最終會編寫這樣的代碼： ``` void MyWidget.dragEnterEvent([QDragEnterEvent](qdragenterevent.html) *event) { if (event->mimeData()->hasUrls()) event->acceptProposedAction(); } void MyWidget.dropEvent([QDropEvent](qdropevent.html) *event) { if (event->mimeData()->hasUrls()) { foreach ([QUrl](qurl.html) url, event->mimeData()->urls()) { ... } } } ``` 有三種方法用于在QMimeData對象存儲自定義數據： 1. 自定義數據可以直接存儲在一個QMimeData對象作為[QByteArray](qbytearray.html) using [setData](qmimedata.html#setData)（）。例如： ``` [QByteArray](qbytearray.html) csvData = ...; QMimeData *mimeData = new QMimeData; mimeData->setData("text/csv", csvData); ``` 2. 我們可以繼承QMimeData和重新實現[hasFormat](qmimedata.html#hasFormat)（）[formats](qmimedata.html#formats)（）和[retrieveData](qmimedata.html#retrieveData)（）。 3. 如果發生在一個單一的應用程序中的拖放操作，我們可以繼承QMimeData ，并在其中添加額外的數據，并使用[qobject_cast](qobject.html#qobject_cast)（）在接收器的放置事件處理程序。例如： ``` void MyWidget.dropEvent([QDropEvent](qdropevent.html) *event) { const MyMimeData *myData = qobject_cast<const MyMimeData *>(event->mimeData()); if (myData) { // access myData's data directly (not through QMimeData's API) } } ``` ### Platform-Specific MIME Types 在Windows上，[formats](qmimedata.html#formats)（）也將返回的MIME數據可自定義格式，使用`x-qt-windows-mime`亞型，表明它們代表了非標準格式的數據。該格式將采取以下形式： ``` application/x-qt-windows-mime;value="<custom type>" ``` 下面是自定義MIME類型的示例： ``` application/x-qt-windows-mime;value="FileGroupDescriptor" application/x-qt-windows-mime;value="FileContents" ``` 該`value`聲明的每個格式的描述，其中的數據被編碼的方式。在Windows上， MIME格式并不總是直接映射到剪貼板格式。 Qt提供[QWindowsMime](index.htm)映射的剪貼板格式，打開標準的MIME格式。類似地，[QMacPasteboardMime](index.htm)MIME映射到Mac的口味。 * * * ## Method Documentation ``` QMimeData.__init__ (self) ``` 構造一個新的MIME數據對象中沒有任何數據。 ``` QMimeData.clear (self) ``` 刪除所有在該對象的MIME類型和數據條目。 ``` QVariant QMimeData.colorData (self) ``` 返回一個顏色，如果存儲在所述對象數據代表顏色（MIME類型`application/x-color`），否則返回一個空的變體。 A [QVariant](qvariant.html)被使用，因為[QMimeData](qmimedata.html)屬于[QtCore](index.htm)庫，而[QColor](qcolor.html)屬于[QtGui](index.htm)。若要轉換[QVariant](qvariant.html)到[QColor](qcolor.html)，只需使用[qvariant_cast](qvariant.html#qvariant_cast)（）。例如： ``` if (event->mimeData()->hasColor()) { [QColor](qcolor.html) color = qvariant_cast<[QColor](qcolor.html)>(event->mimeData()->colorData()); ... } ``` **See also** [hasColor](qmimedata.html#hasColor)（）[setColorData](qmimedata.html#setColorData)（）和[data](qmimedata.html#data)（）。 ``` QByteArray QMimeData.data (self, QString?mimetype) ``` [ 返回存儲在該對象中由指定的MIME類型所描述的格式的數據_mimeType_。 ](qbytearray.html) [**See also**](qbytearray.html) [setData](qmimedata.html#setData)（）。 ``` QStringList QMimeData.formats (self) ``` 返回由對象所支持的格式列表。這是MIME類型的量，對象可以返回合適的數據的列表。在列表中的格式是一個優先順序。對于數據的最常見的類型，你可以調用高級功能[hasText](qmimedata.html#hasText)（）[hasHtml](qmimedata.html#hasHtml)（）[hasUrls](qmimedata.html#hasUrls)（）[hasImage](qmimedata.html#hasImage)（）和[hasColor](qmimedata.html#hasColor)（）來代替。 **See also** [hasFormat](qmimedata.html#hasFormat)（）[setData](qmimedata.html#setData)（）和[data](qmimedata.html#data)（）。 ``` bool QMimeData.hasColor (self) ``` 返回True如果對象可以返回一個顏色（ MIME類型`application/x-color`），否則返回False 。 **See also** [setColorData](qmimedata.html#setColorData)（）[colorData](qmimedata.html#colorData)（）和[hasFormat](qmimedata.html#hasFormat)（）。 ``` bool QMimeData.hasFormat (self, QString?mimetype) ``` 返回True如果對象可以返回的數據由指定的MIME類型_mimeType_否則返回False 。對于數據的最常見的類型，你可以調用高級功能[hasText](qmimedata.html#hasText)（）[hasHtml](qmimedata.html#hasHtml)（）[hasUrls](qmimedata.html#hasUrls)（）[hasImage](qmimedata.html#hasImage)（）和[hasColor](qmimedata.html#hasColor)（）來代替。 **See also** [formats](qmimedata.html#formats)（）[setData](qmimedata.html#setData)（）和[data](qmimedata.html#data)（）。 ``` bool QMimeData.hasHtml (self) ``` 返回True如果對象可以返回的HTML （ MIME類型`text/html`），否則返回False 。 **See also** [setHtml](qmimedata.html#setHtml)（）[html](qmimedata.html#html)（）和[hasFormat](qmimedata.html#hasFormat)（）。 ``` bool QMimeData.hasImage (self) ``` 返回True如果對象可以返回一個圖像，否則返回False 。 **See also** [setImageData](qmimedata.html#setImageData)（）[imageData](qmimedata.html#imageData)（）和[hasFormat](qmimedata.html#hasFormat)（）。 ``` bool QMimeData.hasText (self) ``` 返回True如果對象可以返回純文本（ MIME類型`text/plain`），否則返回False 。 **See also** [setText](qmimedata.html#setText)（）[text](qmimedata.html#text)（）[hasHtml](qmimedata.html#hasHtml)（）和[hasFormat](qmimedata.html#hasFormat)（）。 ``` bool QMimeData.hasUrls (self) ``` 返回True如果對象可以返回的URL列表，否則返回False 。網址對應的MIME類型`text/uri-list`。 **See also** [setUrls](qmimedata.html#setUrls)（）[urls](qmimedata.html#urls)（）和[hasFormat](qmimedata.html#hasFormat)（）。 ``` QString QMimeData.html (self) ``` 返回一個字符串，如果存儲在對象中的數據是HTML （ MIME類型`text/html`），否則返回一個空字符串。 **See also** [setHtml](qmimedata.html#setHtml)（）[hasHtml](qmimedata.html#hasHtml)（）和[setData](qmimedata.html#setData)（）。 ``` QVariant QMimeData.imageData (self) ``` 返回[QVariant](qvariant.html)存儲[QImage](qimage.html)如果該對象可以返回一個圖像，否則返回一個空的變體。 A [QVariant](qvariant.html)被使用，因為[QMimeData](qmimedata.html)屬于[QtCore](index.htm)庫，而[QImage](qimage.html)屬于[QtGui](index.htm)。若要轉換[QVariant](qvariant.html)到[QImage](qimage.html)，只需使用[qvariant_cast](qvariant.html#qvariant_cast)（）。例如： ``` if (event->mimeData()->hasImage()) { [QImage](qimage.html) image = qvariant_cast<[QImage](qimage.html)>(event->mimeData()->imageData()); ... } ``` **See also** [setImageData](qmimedata.html#setImageData)（）和[hasImage](qmimedata.html#hasImage)（）。 ``` QMimeData.removeFormat (self, QString?mimetype) ``` 刪除數據條目_mimeType_在該對象。此功能被引入Qt的4.4 。 ``` QVariant QMimeData.retrieveData (self, QString?mimetype, Type?preferredType) ``` 返回一個變量與給定的_type_包含的數據由指定的MIME類型_mimeType_。如果對象不支持的MIME類型或特定變量類型，則返回一個空的變體來代替。調用此函數由一般[data](qmimedata.html#data)（） getter和通過便捷的getter （[text](qmimedata.html#text)（）[html](qmimedata.html#html)（）[urls](qmimedata.html#urls)（）[imageData](qmimedata.html#imageData)（）和[colorData](qmimedata.html#colorData)（））。您可以重新實現它，如果你想使用一個自定義的數據結構，而不是一個（存儲數據[QByteArray](qbytearray.html)，這是[setData](qmimedata.html#setData)（）提供）。那么你就還需要重新實現[hasFormat](qmimedata.html#hasFormat)（）和[formats](qmimedata.html#formats)（）。 **See also** [data](qmimedata.html#data)（）。 ``` QMimeData.setColorData (self, QVariant?color) ``` 在對象的顏色數據設置為給定_color_。顏色對應的MIME類型`application/x-color`。 **See also** [colorData](qmimedata.html#colorData)（）[hasColor](qmimedata.html#hasColor)（）和[setData](qmimedata.html#setData)（）。 ``` QMimeData.setData (self, QString?mimetype, QByteArray?data) ``` 設置與由下式給出的MIME類型相關聯的數據_mimeType_到指定的_data_。對于數據的最常見的類型，你可以調用高級功能[setText](qmimedata.html#setText)（）[setHtml](qmimedata.html#setHtml)（）[setUrls](qmimedata.html#setUrls)（）[setImageData](qmimedata.html#setImageData)（）和[setColorData](qmimedata.html#setColorData)（）來代替。請注意，如果你想使用自定義數據類型中的項目視圖拖放操作，您必須注冊為一個Qt[meta type](qmetatype.html)使用[Q_DECLARE_METATYPE](qmetatype.html#Q_DECLARE_METATYPE)（）宏，并實現流運算符吧。流運營商然后必須與所登記的[qRegisterMetaTypeStreamOperators](qmetatype.html#qRegisterMetaTypeStreamOperators)（）函數。 **See also** [data](qmimedata.html#data)（）[hasFormat](qmimedata.html#hasFormat)（）[QMetaType](qmetatype.html)和[qRegisterMetaTypeStreamOperators](qmetatype.html#qRegisterMetaTypeStreamOperators)（）。 ``` QMimeData.setHtml (self, QString?html) ``` Sets _html_作為HTML （ MIME類型`text/html`）用于表示數據。 **See also** [html](qmimedata.html#html)（）[hasHtml](qmimedata.html#hasHtml)（）[setText](qmimedata.html#setText)（）和[setData](qmimedata.html#setData)（）。 ``` QMimeData.setImageData (self, QVariant?image) ``` 在對象中的數據設置為給定_image_。 A [QVariant](qvariant.html)被使用，因為[QMimeData](qmimedata.html)屬于[QtCore](index.htm)庫，而[QImage](qimage.html)屬于[QtGui](index.htm)。從轉換[QImage](qimage.html)至[QVariant](qvariant.html)是隱式的。例如： ``` mimeData->setImageData([QImage](qimage.html)("beautifulfjord.png")); ``` **See also** [imageData](qmimedata.html#imageData)（）[hasImage](qmimedata.html#hasImage)（）和[setData](qmimedata.html#setData)（）。 ``` QMimeData.setText (self, QString?text) ``` Sets _text_作為純文本（ MIME類型`text/plain`）用于表示數據。 **See also** [text](qmimedata.html#text)（）[hasText](qmimedata.html#hasText)（）[setHtml](qmimedata.html#setHtml)（）和[setData](qmimedata.html#setData)（）。 ``` QMimeData.setUrls (self, list-of-QUrl?urls) ``` 設置存儲在MIME數據對象通過那些指定的URL_urls_。網址對應的MIME類型`text/uri-list`。 **See also** [urls](qmimedata.html#urls)（）[hasUrls](qmimedata.html#hasUrls)（）和[setData](qmimedata.html#setData)（）。 ``` QString QMimeData.text (self) ``` 返回一個純文本（ MIME類型`text/plain`的數據）表示。 **See also** [setText](qmimedata.html#setText)（）[hasText](qmimedata.html#hasText)（）[html](qmimedata.html#html)（）和[data](qmimedata.html#data)（）。 ``` list-of-QUrl QMimeData.urls (self) ``` 返回包含MIME數據對象中的URL列表。網址對應的MIME類型`text/uri-list`。 **See also** [setUrls](qmimedata.html#setUrls)（）[hasUrls](qmimedata.html#hasUrls)（）和[data](qmimedata.html#data)（）。