En esta página

QMimeData Class

La clase QMimeData proporciona un contenedor de datos que registra información sobre su tipo MIME. Más información...

Encabezado: #include <QMimeData>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredado de: QObject

Funciones públicas

QMimeData()
virtual ~QMimeData()
void clear()
QVariant colorData() const
QByteArray data(const QString &mimeType) const
virtual QStringList formats() const
bool hasColor() const
virtual bool hasFormat(const QString &mimeType) const
bool hasHtml() const
bool hasImage() const
bool hasText() const
bool hasUrls() const
QString html() const
QVariant imageData() const
void removeFormat(const QString &mimeType)
void setColorData(const QVariant &color)
void setData(const QString &mimeType, const QByteArray &data)
void setHtml(const QString &html)
void setImageData(const QVariant &image)
void setText(const QString &text)
void setUrls(const QList<QUrl> &urls)
QString text() const
QList<QUrl> urls() const

Funciones protegidas

virtual QVariant retrieveData(const QString &mimeType, QMetaType type) const

Descripción detallada

QMimeData se utiliza para describir la información que se puede almacenar en el objeto ` clipboard` y transferir mediante el mecanismo de arrastrar y soltar. Los objetos `QMimeData` asocian los datos que contienen con los tipos MIME correspondientes para garantizar que la información se pueda transferir de forma segura entre aplicaciones y copiar dentro de la misma aplicación.

Los objetos `QMimeData` suelen crearse mediante ` new ` y se pasan a objetos ` QDrag ` o ` QClipboard `. Esto permite que Qt gestione la memoria que utilizan.

Un único objeto `QMimeData` puede almacenar los mismos datos utilizando varios formatos diferentes al mismo tiempo. La función ` formats()` devuelve una lista de los formatos disponibles por orden de preferencia. La función ` data()` devuelve los datos sin procesar asociados a un tipo MIME, y ` setData()` permite establecer los datos para un tipo MIME.

Para los tipos MIME más comunes, QMimeData proporciona funciones prácticas para acceder a los datos:

TesterGetterEstablecedorTipos MIME
hasText()text()setText()text/plain
hasHtml()html()setHtml()text/html
hasUrls()urls()setUrls()text/uri-list
hasImage()imageData()setImageData()image/ *
hasColor()colorData()setColorData()application/x-color

Por ejemplo, si escribes un widget que acepta arrastres de URL, acabarías escribiendo un código como este:

void MyWidget::dragEnterEvent(QDragEnterEvent *event)
{
    if (event->mimeData()->hasUrls())
        event->acceptProposedAction();
}

void MyWidget::dropEvent(QDropEvent *event)
{
    if (event->mimeData()->hasUrls()) {
        foreach (QUrl url, event->mimeData()->urls()) {
            //...
        }
    }
}

Existen tres formas de almacenar datos personalizados en un objeto QMimeData:

  1. Los datos personalizados se pueden almacenar directamente en un objeto `QMimeData` como un ` QByteArray ` utilizando ` setData()`. Por ejemplo:
    QByteArray csvData = something;
    
    QMimeData *mimeData = new QMimeData;
    mimeData->setData("text/csv", csvData);
  2. Podemos crear una subclase de `QMimeData` y reimplementar ` hasFormat()`, ` formats()` y ` retrieveData()`.
  3. Si la operación de arrastrar y soltar tiene lugar dentro de una misma aplicación, podemos crear una subclase de `QMimeData` e añadir datos adicionales en ella, y utilizar un ` qobject_cast()` en el controlador de eventos de soltar del receptor. Por ejemplo:
    void MyWidget::dropEvent(QDropEvent *event)
    {
        const MyMimeData *myData =
                qobject_cast<const MyMimeData *>(event->mimeData());
        if (myData) {
            // access myData's data directly (not through QMimeData's API)
        }
    }

Tipos MIME específicos de cada plataforma

En Windows, ` formats()` también devolverá formatos personalizados disponibles en los datos MIME, utilizando el subtipo ` x-qt-windows-mime ` para indicar que representan datos en formatos no estándar. Los formatos adoptarán la siguiente forma:

application/x-qt-windows-mime;value="<custom type>"

A continuación se muestran ejemplos de tipos MIME personalizados:

application/x-qt-windows-mime;value="FileGroupDescriptor"
application/x-qt-windows-mime;value="FileContents"

La declaración ` value ` de cada formato describe la forma en que se codifican los datos.

En algunos casos (por ejemplo, al soltar varios archivos adjuntos de correo electrónico), hay varios valores de datos disponibles. Se puede acceder a ellos añadiendo un valor « index »:

application/x-qt-windows-mime;value="FileContents";index=0
application/x-qt-windows-mime;value="FileContents";index=1

En Windows, el formato MIME no siempre se corresponde directamente con los formatos del portapapeles. Qt proporciona QWindowsMimeConverter para asignar los formatos del portapapeles a formatos MIME de estándar abierto. Del mismo modo, QUtiMimeConverter asigna los formatos MIME a los identificadores de tipo uniformes (UTI) en macOS e iOS.

Véase también QClipboard, QDragEnterEvent, QDragMoveEvent, QDropEvent, QDrag y Arrastrar y soltar.

Documentación sobre funciones de miembro

QMimeData::QMimeData()

Crea un nuevo objeto de datos MIME sin contenido.

[virtual noexcept] QMimeData::~QMimeData()

Destruye el objeto de datos MIME.

void QMimeData::clear()

Elimina todas las entradas de tipo MIME y de datos 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 un « QVariant » porque « QMimeData » pertenece al módulo « Qt Core », mientras que « QColor » pertenece a « Qt GUI ». Para convertir el « QVariant » en un « 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 en mimeType. Si este objeto no contiene datos para el tipo MIME mimeType (véase hasFormat()), esta función puede realizar una conversión «lo mejor posible» a dicho tipo.

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

[virtual] QStringList QMimeData::formats() const

Devuelve una lista de los formatos compatibles con el objeto. Se trata de una lista de tipos MIME para los que el objeto puede devolver datos adecuados. Los formatos de la lista aparecen ordenados por prioridad.

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

Véanse 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éanse 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, se pueden llamar en su lugar a las funciones de nivel superior hasText(), hasHtml(), hasUrls(), hasImage() y hasColor().

Véanse 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 URL; 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 objeto ` QVariant ` que almacena un ` QImage ` si el objeto puede devolver una imagen; en caso contrario, devuelve una variante nula.

Se utiliza un ` QVariant ` porque ` QMimeData ` pertenece al módulo ` Qt Core `, mientras que ` QImage ` pertenece a ` Qt GUI`. Para convertir el ` QVariant ` en un ` 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 correspondiente a « mimeType » del objeto.

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

Devuelve una variante con el ` type ` indicado, que contiene datos para el tipo MIME especificado por ` mimeType`. Si el objeto no admite el tipo MIME o el tipo de variante indicados, se devuelve una variante nula en su lugar.

Esta función es invocada por el getter general data() y por los getters de conveniencia (text(), html(), urls(), imageData() y colorData()). Puedes reimplementarla si deseas almacenar tus datos utilizando una estructura de datos personalizada (en lugar de un QByteArray, que es lo que proporciona setData()). En ese caso, también tendrías que reimplementar hasFormat() y formats().

Véase también data().

void QMimeData::setColorData(const QVariant &color)

Establece los datos de color del objeto según lo indicado en color.

Los colores se corresponden con el 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 al tipo MIME indicado por ` mimeType ` en el valor especificado ` data`.

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

Ten en cuenta que, si deseas utilizar un tipo de datos personalizado en una operación de arrastrar y soltar en la vista de elementos, debes registrarlo como un « meta type » de Qt XML, 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 según el image indicado.

Se utiliza un 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éanse también text(), hasText(), setHtml() y setData().

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

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

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

Desde Qt 5.0, setUrls también exporta las URL como texto sin formato, si no se ha llamado previamente a setText, para que sea posible pegarlas en cualquier campo de edición de línea o editor de texto.

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

QString QMimeData::text() const

Devuelve la representación en texto sin formato (tipo MIME text/plain) de los datos si este objeto contiene texto sin formato. Si contiene algún otro tipo de contenido, esta función hace todo lo posible por convertirlo a texto sin formato.

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

QList<QUrl> QMimeData::urls() const

Devuelve una lista de las URL contenidas en el objeto de datos MIME.

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

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

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.