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 variant를 반환합니다.

` 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

mimeType 에 지정된 MIME 유형에 대한 데이터가 포함된, 주어진 type 를 가진 변형을 반환합니다. 객체가 주어진 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() 매크로를 사용하여 해당 데이터형을 Qt meta 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부터 setUrls는 이전에 setText 가 호출되지 않은 경우, 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()도 참조하십시오 .