QMimeData Class

成员函数文档

QMimeData::QMimeData()

构造一个新的 MIME 数据对象，其中不含任何数据。

[virtual noexcept] QMimeData::~QMimeData()

销毁 MIME 数据对象。

void QMimeData::clear()

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

QVariant QMimeData::colorData() const

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

使用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() ）都会调用该函数。如果您想使用自定义数据结构（而不是QByteArray ，setData() 提供的数据结构）来存储数据，可以重新实现它。这样，您还需要重新实现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() 宏将其注册为 Qt XMLmeta 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 XML 5.0 起，如果之前未调用setText ，setUrls 还会以纯文本形式导出 urls，以便将其放入任何 lineedit 和文本编辑器中。

另请参见 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()。