QMimeData Class

メンバー関数ドキュメント

QMimeData::QMimeData()

データのない新しいMIMEデータ・オブジェクトを構築する。

[virtual noexcept] QMimeData::~QMimeData()

MIMEデータオブジェクトを破棄する。

void QMimeData::clear()

オブジェクト内のすべての MIME タイプとデータのエントリを削除する。

QVariant QMimeData::colorData() const

オブジェクトに格納されているデータが色（MIME タイプapplication/x-color ）を表している場合は色を返し、そうでない場合は null variant を返します。

QMimeData がQt Core モジュールに属しているのに対し、QColor はQt GUI に属しているため、QVariant が使用されます。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 variant を返します。

QMimeData はQt Core モジュールに属し、QImage はQt GUI に属するため、QVariant が使われます。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

mimeType で指定された MIME タイプのデータを含む、与えられたtype の variant を返します。オブジェクトが指定された MIME タイプや variant タイプをサポートしていない場合は、代わりに null variant が返されます。

この関数は、一般的な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 に設定する。

QMimeData はQt Core モジュールに属し、QImage はQt GUI に属するため、QVariant が使用される。QImage からQVariant への変換は暗黙的である。例えば

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

imageData()、hasImage()、setData()も参照 。

void QMimeData::setText(const QString &text)

データの表現に使用するプレーン・テキスト（MIMEタイプtext/plain ）としてtext を設定する。

text()、hasText()、setHtml() およびsetData()も参照 。

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

MIMEデータオブジェクトに格納されているURLを、urls で指定されているものに設定する。

URL は MIME タイプtext/uri-list に対応します。

Qt 5.0 以降、setUrls は、setText が呼び出される前であれば、URLをプレーンテキストとしてエクスポートし、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()も参照 。