En esta página

QUtiMimeConverter Class

La clase QUtiMimeConverter permite convertir entre un tipo MIME y un formato de identificador de tipo uniforme (UTI). Más información...

Encabezado: #include <QUtiMimeConverter>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Desde: Qt 6.5

Funciones públicas

QUtiMimeConverter()
virtual ~QUtiMimeConverter()
bool canConvert(const QString &mime, const QString &uti) const
virtual QList<QByteArray> convertFromMime(const QString &mime, const QVariant &data, const QString &uti) const = 0
virtual QVariant convertToMime(const QString &mime, const QList<QByteArray> &data, const QString &uti) const = 0
virtual int count(const QMimeData *mimeData) const
virtual QString mimeForUti(const QString &uti) const = 0
virtual QString utiForMime(const QString &mime) const = 0

Descripción detallada

Las funciones de arrastrar y soltar y de portapapeles de Qt utilizan el estándar MIME. En X11, esto se corresponde de forma sencilla con el protocolo Xdnd. En Mac, aunque algunas aplicaciones utilizan MIME para describir el contenido del portapapeles, es más habitual utilizar el formato UTI de Apple.

La función de QUtiMimeConverter es servir de puente entre MIME y UTI; al crear subclases de esta clase, se puede ampliar la gestión de la función de arrastrar y soltar y del portapapeles de Qt para convertir a y desde formatos UTI no compatibles o propietarios.

Crea una instancia de tu implementación del convertidor tras instanciar ` QGuiApplication`:

int main(int argc, char **argv)
{
    QGuiApplication app(argc, argv);
    JsonMimeConverter jsonConverter;
}

Al destruir la instancia se dará de baja el convertidor y se eliminará el soporte para la conversión. También es válido asignar la instancia del convertidor en el montón; Qt asume la propiedad y eliminará el objeto convertidor durante el cierre de QGuiApplication.

Qt ofrece soporte predefinido para los siguientes UTI:

  • public.utf8-plain-text: convierte a «text/plain»
  • public.utf16-plain-text: convierte a «text/plain»
  • public.text: convierte a «text/plain»
  • public.html: convierte a «text/html»
  • public.url: se convierte en «text/uri-list»
  • public.file-url: se convierte a «text/uri-list»
  • public.tiff: se convierte a «application/x-qt-image»
  • public.vcard: se convierte a «text/plain»
  • com.apple.traditional-mac-plain-text: se convierte en «text/plain»
  • com.apple.pict: se convierte a «application/x-qt-image»

Al trabajar con datos MIME, Qt recorrerá todas las instancias de QUtiMimeConverter para encontrar una que pueda convertir a un tipo MIME específico, o desde él. Para ello, llamará a mimeForUti() o utiForMime() en cada instancia, comenzando (y seleccionando) primero la última instancia creada. Las conversiones propiamente dichas se realizarán utilizando convertToMime() y convertFromMime().

Documentación de las funciones de miembro

QUtiMimeConverter::QUtiMimeConverter()

Crea un nuevo objeto de conversión y lo añade a la lista de convertidores disponibles de acceso global.

Llama a este constructor una vez que se haya creado QGuiApplication.

[virtual noexcept] QUtiMimeConverter::~QUtiMimeConverter()

Elimina un objeto de conversión, retirándolo de la lista global de convertidores disponibles.

bool QUtiMimeConverter::canConvert(const QString &mime, const QString &uti) const

Devuelve ` true ` si el convertidor puede realizar la conversión (en ambos sentidos) entre ` mime ` y ` uti`; en caso contrario, devuelve ` false`.

[pure virtual] QList<QByteArray> QUtiMimeConverter::convertFromMime(const QString &mime, const QVariant &data, const QString &uti) const

Devuelve « data », convertido del tipo MIME « mime » al UTI de Mac « uti ».

Ten en cuenta que todas las UTI de Mac deben ser autoterminantes. El valor de retorno puede contener datos finales.

Todas las subclases deben reimplementar esta función virtual pura.

[pure virtual] QVariant QUtiMimeConverter::convertToMime(const QString &mime, const QList<QByteArray> &data, const QString &uti) const

Devuelve « data », convertido del formato UTI de Mac « uti » al tipo MIME « mime ».

Ten en cuenta que todos los UTI de Mac deben ser autoterminantes. La entrada data puede contener datos finales.

Todas las subclases deben reimplementar esta función virtual pura.

[virtual] int QUtiMimeConverter::count(const QMimeData *mimeData) const

Devuelve el número de elementos del mimeData

[pure virtual] QString QUtiMimeConverter::mimeForUti(const QString &uti) const

Devuelve el tipo MIME utilizado para Mac UTI uti, o una cadena vacía si este conversor no admite la conversión desde uti.

Todas las subclases deben reimplementar esta función virtual pura.

[pure virtual] QString QUtiMimeConverter::utiForMime(const QString &mime) const

Devuelve el UTI de Mac utilizado para el tipo MIME « mime », o una cadena vacía si este convertidor no admite la conversión desde « mime ».

Todas las subclases deben reimplementar esta función virtual pura.

© 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.