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:
| Tester | Getter | Establecedor | Tipos 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:
- 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); - Podemos crear una subclase de `QMimeData` y reimplementar ` hasFormat()`, ` formats()` y ` retrieveData()`.
- 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=1En 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.
© 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.