QMimeData Class

成员函数文档

QMimeData::QMimeData()

创建一个不包含任何数据的新 MIME 数据对象。

[virtual noexcept] QMimeData::~QMimeData()

销毁 MIME 数据对象。

void QMimeData::clear()

删除对象中的所有 MIME 类型和数据条目。

QVariant QMimeData::colorData() const

如果对象中存储的数据表示一种颜色（MIME 类型为application/x-color ），则返回该颜色；否则返回一个 null 变体。

这里使用QVariant 是因为QMimeData 属于Qt Core 模块，而QColor 属于Qt GUI 。要将QVariant 转换为QColor ，只需使用qvariant_cast() 即可。例如：

if (event->mimeData()->hasColor()) {
    QColor color = qvariant_cast<QColor>(event->mimeData()->colorData());
    //...
}

另请参阅 hasColor()、setColorData() 和data()。

QByteArray QMimeData::data(const QString &mimeType) const

以由mimeType 指定的 MIME 类型所描述的格式，返回该对象中存储的数据。如果该对象不包含mimeType MIME 类型的数据（参见hasFormat()），则本函数可能会尽最大努力将其转换为该格式。

另请参阅 hasFormat() 和setData()。

[virtual] QStringList QMimeData::formats() const

返回该对象支持的格式列表。该列表包含该对象能够返回相应数据的 MIME 类型。列表中的格式按优先级排序。

对于最常见的数据类型，您可以改用更高级的函数：hasText()、hasHtml()、hasUrls()、hasImage() 和hasColor()。

另请参阅 hasFormat()、setData()、data() 和 ()。

bool QMimeData::hasColor() const

如果对象可以返回颜色（MIME 类型为application/x-color ），则返回true ；否则返回false 。

另请参阅 setColorData()、colorData() 和hasFormat()。

[virtual] bool QMimeData::hasFormat(const QString &mimeType) const

如果对象能够返回由mimeType 指定的 MIME 类型的数据，则返回true ；否则返回false 。

对于最常见的数据类型，您可以改用更高层次的函数hasText()、hasHtml()、hasUrls()、hasImage() 和hasColor() 来调用。

另请参阅 formats()、setData()、data() 和 ()。

bool QMimeData::hasHtml() const

如果对象可以返回 HTML（MIME 类型为text/html ），则返回true ；否则返回false 。

另请参阅 setHtml()、html() 和hasFormat()。

bool QMimeData::hasImage() const

如果对象能够返回图像，则返回true ；否则返回 false。

另请参阅 setImageData()、imageData() 和hasFormat()。

bool QMimeData::hasText() const

如果对象可以返回纯文本（MIME 类型为text/plain ），则返回true ；否则返回false 。

另请参阅 setText()、text()、hasHtml() 和hasFormat()。

bool QMimeData::hasUrls() const

如果对象可以返回一个 URL 列表，则返回true ；否则返回false 。

这些 URL 对应于 MIME 类型text/uri-list 。

另请参阅 setUrls()、urls()，以及hasFormat()。

QString QMimeData::html() const

如果对象中存储的数据是 HTML（MIME 类型为text/html ），则返回一个字符串；否则返回一个空字符串。

另请参阅 setHtml()、hasHtml() 和setData()。

QVariant QMimeData::imageData() const

如果对象可以返回图像，则返回一个存储QImage 的QVariant ；否则返回一个空变体。

之所以使用QVariant ，是因为QMimeData 属于Qt Core 模块，而QImage 属于Qt GUI 模块。要将QVariant 转换为QImage ，只需使用qvariant_cast()即可。例如：

if (event->mimeData()->hasImage()) {
    QImage image = qvariant_cast<QImage>(event->mimeData()->imageData());
    //...
}

另请参阅 setImageData() 和hasImage()。

void QMimeData::removeFormat(const QString &mimeType)

删除对象中mimeType 的数据条目。

[virtual protected] QVariant QMimeData::retrieveData(const QString &mimeType, QMetaType type) const

返回一个包含给定type 的变体，该 包含由mimeType 指定的MIME类型的数据。如果对象不支持给定的MIME类型或变体类型，则返回一个空变体。

此函数由通用data()获取器以及便捷获取器（text()、html()、urls()、imageData()和colorData()）调用。如果您希望使用自定义数据结构（而非由setData()提供的QByteArray ）来存储数据，可以重写此函数。 届时，您还需要重写hasFormat() 和formats()。

另请参阅 data()。

void QMimeData::setColorData(const QVariant &color)

将对象中的颜色数据设置为给定的color 。

颜色对应于 MIME 类型application/x-color 。

另请参阅 colorData()、hasColor() 和setData()。

void QMimeData::setData(const QString &mimeType, const QByteArray &data)

将与mimeType 指定的MIME类型相关的数据设置为指定的data 。

对于最常见的数据类型，您可以改用更高层次的函数setText()、setHtml()、setUrls()、setImageData() 和setColorData()。

请注意，若要在项目视图的拖放操作中使用自定义数据类型，必须使用Q_DECLARE_METATYPE() 宏将其注册为 Qtmeta type ，并为其实现流运算符。

另请参阅 data()、hasFormat()、QMetaType 以及Q_DECLARE_METATYPE()。

void QMimeData::setHtml(const QString &html)

将html 设置为用于表示该数据的 HTML（MIME 类型text/html ）。

另请参阅 html()、hasHtml()、setText() 和setData()。

void QMimeData::setImageData(const QVariant &image)

将对象中的数据设置为给定的image 。

之所以使用QVariant ，是因为QMimeData 属于Qt Core 模块，而QImage 属于Qt GUI 模块。从QImage 到QVariant 的转换是隐式的。例如：

mimeData->setImageData(QImage("beautifulfjord.png"));

另请参阅 imageData()、hasImage() 和setData()。

void QMimeData::setText(const QString &text)

将text 设置为用于表示该数据的纯文本（MIME 类型为text/plain ）。

另请参阅 text()、hasText()、setHtml() 以及setData()。

void QMimeData::setUrls(const QList<QUrl> &urls)

将存储在 MIME 数据对象中的 URL 设置为urls 中指定的 URL。

这些 URL 对应于 MIME 类型text/uri-list 。

从 Qt 5.0 开始，如果之前未调用setText ，setUrls 还会将 URL 作为纯文本导出，以便将其拖放到任何行编辑框和文本编辑器中。

另请参阅 urls()、hasUrls() 以及setData()。

QString QMimeData::text() const

如果该对象包含纯文本，则返回该数据的纯文本（MIME 类型为text/plain ）表示形式。如果包含其他内容，该函数将尽最大努力将其转换为纯文本。

另请参阅 setText()、hasText()、html()，以及data()。

QList<QUrl> QMimeData::urls() const

返回 MIME 数据对象中包含的 URL 列表。

这些 URL 对应于 MIME 类型text/uri-list 。

另请参阅 setUrls()、hasUrls() 和data()。