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 ` を返し、そうでない場合は `null` バリアントを返します。

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タイプまたはバリアントタイプをサポートしていない場合は、代わりにnullバリアントが返されます。

この関数は、汎用的な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（MIMEタイプ：text/html ）として、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 以降、setUrls は、setText が以前に呼び出されていない場合、URL をプレーンテキストとしてエクスポートするようになりました。これにより、任意のラインエディットやテキストエディタに 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()も参照してください 。