QMimeData Class

Documentación de las funciones miembro

QMimeData::QMimeData()

Construye un nuevo objeto de datos MIME sin datos.

[virtual noexcept] QMimeData::~QMimeData()

Destruye el objeto de datos MIME.

void QMimeData::clear()

Elimina todas las entradas de tipo y datos MIME del objeto.

QVariant QMimeData::colorData() const

Devuelve un color si los datos almacenados en el objeto representan un color (tipo MIME application/x-color); en caso contrario devuelve una variante nula.

Se utiliza QVariant porque QMimeData pertenece al módulo Qt Core, mientras que QColor pertenece a Qt GUI. Para convertir QVariant en QColor, basta con utilizar qvariant_cast(). Por ejemplo:

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

Véase también hasColor(), setColorData() y data().

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

Devuelve los datos almacenados en el objeto en el formato descrito por el tipo MIME especificado por mimeType. Si este objeto no contiene datos para el tipo MIME mimeType (véase hasFormat()), esta función puede realizar una conversión de mejor esfuerzo al mismo.

Véase también hasFormat() y setData().

[virtual] QStringList QMimeData::formats() const

Devuelve una lista de formatos soportados por el objeto. Se trata de una lista de tipos MIME para los que el objeto puede devolver datos adecuados. Los formatos de la lista están en orden de prioridad.

Para los tipos de datos más comunes, puede llamar en su lugar a las funciones de nivel superior hasText(), hasHtml(), hasUrls(), hasImage() y hasColor().

Véase también hasFormat(), setData() y data().

bool QMimeData::hasColor() const

Devuelve true si el objeto puede devolver un color (tipo MIME application/x-color); en caso contrario devuelve false.

Véase también setColorData(), colorData(), y hasFormat().

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

Devuelve true si el objeto puede devolver datos para el tipo MIME especificado por mimeType; en caso contrario devuelve false.

Para los tipos de datos más comunes, puede llamar en su lugar a las funciones de nivel superior hasText(), hasHtml(), hasUrls(), hasImage() y hasColor().

Véase también formats(), setData() y data().

bool QMimeData::hasHtml() const

Devuelve true si el objeto puede devolver HTML (tipo MIME text/html); en caso contrario devuelve false.

Véase también setHtml(), html(), y hasFormat().

bool QMimeData::hasImage() const

Devuelve true si el objeto puede devolver una imagen; en caso contrario devuelve false.

Véase también setImageData(), imageData() y hasFormat().

bool QMimeData::hasText() const

Devuelve true si el objeto puede devolver texto sin formato (tipo MIME text/plain); en caso contrario devuelve false.

Véase también setText(), text(), hasHtml() y hasFormat().

bool QMimeData::hasUrls() const

Devuelve true si el objeto puede devolver una lista de urls; en caso contrario devuelve false.

Las URL corresponden al tipo MIME text/uri-list.

Véase también setUrls(), urls() y hasFormat().

QString QMimeData::html() const

Devuelve una cadena si los datos almacenados en el objeto son HTML (tipo MIME text/html); en caso contrario devuelve una cadena vacía.

Véase también setHtml(), hasHtml() y setData().

QVariant QMimeData::imageData() const

Devuelve un QVariant almacenando un QImage si el objeto puede devolver una imagen; en caso contrario devuelve una variante nula.

Se utiliza QVariant porque QMimeData pertenece al módulo Qt Core, mientras que QImage pertenece a Qt GUI. Para convertir QVariant en QImage, basta con utilizar qvariant_cast(). Por ejemplo:

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

Véase también setImageData() y hasImage().

void QMimeData::removeFormat(const QString &mimeType)

Elimina la entrada de datos para mimeType en el objeto.

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

Devuelve una variante con el type dado que contiene datos para el tipo MIME especificado por mimeType. Si el objeto no soporta el tipo MIME o el tipo de variante dado, se devuelve una variante nula.

Esta función es llamada por el getter general data() y por los getters de conveniencia (text(), html(), urls(), imageData(), y colorData()). Puede reimplementarlo si desea almacenar sus datos utilizando una estructura de datos personalizada (en lugar de QByteArray, que es lo que proporciona setData()). En ese caso, también deberá reimplementar hasFormat() y formats().

Véase también data().

void QMimeData::setColorData(const QVariant &color)

Establece los datos de color del objeto en la dirección color.

Los colores corresponden al tipo MIME application/x-color.

Véase también colorData(), hasColor() y setData().

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

Establece los datos asociados con el tipo MIME dado por mimeType en el data especificado.

Para los tipos de datos más comunes, puede llamar en su lugar a las funciones de nivel superior setText(), setHtml(), setUrls(), setImageData() y setColorData().

Tenga en cuenta que si desea utilizar un tipo de datos personalizado en una operación de arrastrar y soltar de la vista de elementos, debe registrarlo como un Qt meta type, utilizando la macro Q_DECLARE_METATYPE(), e implementar operadores de flujo para él.

Véase también data(), hasFormat(), QMetaType, y Q_DECLARE_METATYPE().

void QMimeData::setHtml(const QString &html)

Establece html como el HTML (tipo MIME text/html) utilizado para representar los datos.

Véase también html(), hasHtml(), setText() y setData().

void QMimeData::setImageData(const QVariant &image)

Establece los datos del objeto en image.

Se utiliza QVariant porque QMimeData pertenece al módulo Qt Core, mientras que QImage pertenece a Qt GUI. La conversión de QImage a QVariant es implícita. Por ejemplo:

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

Véase también imageData(), hasImage() y setData().

void QMimeData::setText(const QString &text)

Establece text como el texto sin formato (tipo MIME text/plain) utilizado para representar los datos.

Véase también text(), hasText(), setHtml() y setData().

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

Establece las URL almacenadas en el objeto de datos MIME a las especificadas por urls.

Las URL corresponden al tipo MIME text/uri-list.

Desde Qt 5.0, setUrls también exporta las urls como texto plano, si setText no fue llamado antes, para hacer posible soltarlas en cualquier editor de texto y lineedit.

Véase también urls(), hasUrls(), y setData().

QString QMimeData::text() const

Devuelve la representación en texto plano (tipo MIME text/plain) de los datos si este objeto contiene texto plano. Si contiene algún otro contenido, esta función hace un esfuerzo para convertirlo a texto plano.

Véase también setText(), hasText(), html() y data().

QList<QUrl> QMimeData::urls() const

Devuelve una lista de URLs contenidas en el objeto de datos MIME.

Las URL corresponden al tipo MIME text/uri-list.

Véase también setUrls(), hasUrls() y data().