QWindowsMimeConverter Class
La clase QWindowsMimeConverter convierte los formatos MIME de estándar abierto a los formatos del portapapeles de Windows. Más información...
| Encabezado: | #include <QWindowsMimeConverter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
Funciones públicas
| QWindowsMimeConverter() | |
| virtual | ~QWindowsMimeConverter() |
| virtual bool | canConvertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData) const = 0 |
| virtual bool | canConvertToMime(const QString &mimeType, IDataObject *pDataObj) const = 0 |
| virtual bool | convertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData, STGMEDIUM *pmedium) const = 0 |
| virtual QVariant | convertToMime(const QString &mimeType, IDataObject *pDataObj, QMetaType preferredType) const = 0 |
| virtual QList<FORMATETC> | formatsForMime(const QString &mimeType, const QMimeData *mimeData) const = 0 |
| virtual QString | mimeForFormat(const FORMATETC &formatetc) const = 0 |
Miembros públicos estáticos
| int | registerMimeType(const QString &mimeType) |
Descripción detallada
Las funciones de arrastrar y soltar y del portapapeles de Qt utilizan el estándar MIME. En X11, esto se corresponde de forma sencilla con el protocolo Xdnd, pero en Windows, aunque algunas aplicaciones utilizan tipos MIME para describir los formatos del portapapeles, otras utilizan convenciones de nomenclatura arbitrarias y no estandarizadas, o formatos integrados de Windows sin nombre.
Al instanciar subclases de `QWindowsMimeConverter` que proporcionan conversiones entre el portapapeles de Windows y los formatos MIME, puedes convertir formatos de portapapeles propietarios a formatos MIME.
Crea una instancia de tu implementación del convertidor tras instanciar un ` QGuiApplication`:
int main(int argc, char **argv)
{
QGuiApplication app(argc, argv);
JsonMimeConverter jsonConverter;
}Al destruir la instancia, se dará de baja el registrador del conversor y se eliminará la compatibilidad con la conversión. También es válido asignar la instancia del conversor en el montón; Qt asume la propiedad y eliminará el objeto conversor durante el cierre de QGuiApplication.
Qt cuenta con soporte predefinido para los siguientes formatos del portapapeles de Windows:
| Formato de Windows | Tipo MIME equivalente |
|---|---|
CF_UNICODETEXT | text/plain |
CF_TEXT | text/plain |
CF_DIB | image/xyz, donde ` xyz ` es una Qt image format |
CF_HDROP | text/uri-list |
CF_INETURL | text/uri-list |
CF_HTML | text/html |
Un ejemplo de uso de esta clase sería mapear el formato de portapapeles de metafichero de Windows (CF_METAFILEPICT) hacia y desde el tipo MIME image/x-wmf. Esta conversión podría consistir simplemente en añadir o eliminar un encabezado, o incluso en limitarse a pasar los datos. Consulta «Arrastrar y soltar» para obtener más información sobre cómo elegir y definir tipos MIME.
Puede comprobar si un tipo MIME es convertible utilizando canConvertFromMime() y puede realizar conversiones con convertToMime() y convertFromMime().
Documentación de las funciones miembro
QWindowsMimeConverter::QWindowsMimeConverter()
Crea una instancia de QWindowsMimeConverter.
La instancia se registra automáticamente y se invocará para convertir datos durante las operaciones de portapapeles o de arrastrar y soltar.
Llama a este constructor una vez que se haya creado ` QGuiApplication `.
[virtual noexcept] QWindowsMimeConverter::~QWindowsMimeConverter()
Crea una instancia de ` QWindowsMimeConverter `.
La instancia se da de baja automáticamente.
[pure virtual] bool QWindowsMimeConverter::canConvertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData) const
Devuelve ` true ` si el convertidor puede convertir desde el ` mimeData ` al formato especificado en ` formatetc`.
Todas las subclases deben reimplementar esta función virtual pura.
[pure virtual] bool QWindowsMimeConverter::canConvertToMime(const QString &mimeType, IDataObject *pDataObj) const
Devuelve ` true ` si el conversor puede convertir a ` mimeType ` a partir de los formatos disponibles en ` pDataObj`.
Todas las subclases deben reimplementar esta función virtual pura.
[pure virtual] bool QWindowsMimeConverter::convertFromMime(const FORMATETC &formatetc, const QMimeData *mimeData, STGMEDIUM *pmedium) const
Convierte el objeto ` mimeData ` al formato especificado en ` formatetc`. A continuación, los datos convertidos deben almacenarse en una estructura ` pmedium `.
Devuelve «true» si la conversión se ha realizado correctamente.
Todas las subclases deben reimplementar esta función virtual pura.
[pure virtual] QVariant QWindowsMimeConverter::convertToMime(const QString &mimeType, IDataObject *pDataObj, QMetaType preferredType) const
Devuelve un objeto ` QVariant ` que contiene los datos convertidos para ` mimeType ` a partir de ` pDataObj`. Si es posible, el ` QVariant ` debería ser del tipo ` preferredType ` para evitar conversiones innecesarias.
Todas las subclases deben reimplementar esta función virtual pura.
[pure virtual] QList<FORMATETC> QWindowsMimeConverter::formatsForMime(const QString &mimeType, const QMimeData *mimeData) const
Devuelve una lista « QList » de estructuras «FORMATETC» que representan los distintos formatos del portapapeles de Windows que se pueden proporcionar a la función « mimeType » desde la función « mimeData ».
Todas las subclases deben reimplementar esta función virtual pura.
[pure virtual] QString QWindowsMimeConverter::mimeForFormat(const FORMATETC &formatetc) const
Devuelve el tipo MIME que se creará a partir del formato especificado en formatetc, o una cadena vacía si este conversor no es compatible con formatetc.
Todas las subclases deben reimplementar esta función virtual pura.
[static] int QWindowsMimeConverter::registerMimeType(const QString &mimeType)
Registra el tipo MIME mimeType y devuelve un número de identificación que identifica el formato en Windows.
Se registrará un tipo MIME application/x-qt-windows-mime;value="WindowsType" como formato del portapapeles para WindowsType.
© 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.