QMimeType Class
La clase QMimeType describe los tipos de archivo o de datos, representados por una cadena de tipo MIME. Más información...
| Encabezado: | #include <QMimeType> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QMimeType forma parte de las clases compartidas implícitamente.
Comparaciones de QMimeType
| Categoría | Tipos comparables |
|---|---|
| igualdad | QMimeType |
Propiedades
|
|
Funciones públicas
| QMimeType() | |
| QMimeType(const QMimeType &other) | |
| ~QMimeType() | |
| QStringList | aliases() const |
| QStringList | allAncestors() const |
| QString | comment() const |
| QString | filterString() const |
| QString | genericIconName() const |
| QStringList | globPatterns() const |
| QString | iconName() const |
| bool | inherits(const QString &mimeTypeName) const |
| bool | isDefault() const |
| bool | isValid() const |
| QString | name() const |
| QStringList | parentMimeTypes() const |
| QString | preferredSuffix() const |
| QStringList | suffixes() const |
| void | swap(QMimeType &other) |
| QMimeType & | operator=(QMimeType &&other) |
| QMimeType & | operator=(const QMimeType &other) |
Personas no afiliadas relacionadas
| size_t | qHash(const QMimeType &key, size_t seed = 0) |
| bool | operator!=(const QMimeType &lhs, const QMimeType &rhs) |
| bool | operator==(const QMimeType &lhs, const QMimeType &rhs) |
Descripción detallada
Por ejemplo, un archivo llamado «readme.txt» tiene el tipo MIME «text/plain». El tipo MIME se puede determinar a partir del nombre del archivo, del contenido del mismo o de ambos. La determinación del tipo MIME también se puede realizar en búferes de datos que no procedan de archivos.
Determinar el tipo MIME de un archivo puede resultar útil para asegurarte de que tu aplicación lo admite. También resulta útil en aplicaciones o widgets similares a gestores de archivos, con el fin de mostrar un « icon » adecuado para el archivo, o incluso el « comment » descriptivo en vistas detalladas.
Para comprobar si un archivo tiene el tipo MIME esperado, debes utilizar inherits() en lugar de una simple comparación de cadenas basada en name(). Esto se debe a que los tipos MIME pueden heredarse entre sí: por ejemplo, un archivo fuente en C es un tipo específico de archivo de texto sin formato, por lo que text/x-csrc hereda de text/plain.
Véase también QMimeDatabase y el navegador de tipos MIME.
Documentación de propiedades
[read-only] aliases : const QStringList
Esta propiedad contiene la lista de alias de este tipo MIME
Por ejemplo, para text/csv, la lista devuelta sería: text/x-csv, text/x-comma-separated-values.
Ten en cuenta que todas las instancias de ` QMimeType ` hacen referencia a tipos MIME propiamente dichos, nunca a alias directamente.
El orden de los alias en la lista no está definido.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QStringList | aliases() const |
[read-only] allAncestors : const QStringList
Esta propiedad contiene los nombres de los tipos MIME padres, tanto directos como indirectos
Devuelve todos los tipos MIME padres de este tipo MIME, tanto directos como indirectos. Esto incluye a los padres de sus padres, y así sucesivamente.
Por ejemplo, para «image/svg+xml», la lista sería: «application/xml», «text/plain» y «application/octet-stream».
Ten en cuenta que «application/octet-stream» es el tipo MIME padre último de todos los tipos de archivos (pero no de los directorios).
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QStringList | allAncestors() const |
[read-only] comment : const QString
Esta propiedad contiene la descripción del tipo MIME que se mostrará en las interfaces de usuario
Devuelve una descripción de un tipo MIME, adaptada a la configuración de idioma actual del usuario.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QString | comment() const |
[read-only] filterString : const QString
Esta propiedad contiene una cadena de filtro que se puede utilizar en un cuadro de diálogo de archivos
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QString | filterString() const |
[read-only] genericIconName : const QString
Esta propiedad contiene el nombre del archivo de un icono genérico que representa el tipo MIME
Debe utilizarse si el icono devuelto por iconName() no se encuentra en el sistema. Se utiliza para categorías de tipos similares (como hojas de cálculo o archivos comprimidos) que pueden utilizar un icono común. La especificación de nomenclatura de iconos de freedesktop.org recoge un conjunto de nombres de iconos de este tipo.
El nombre del icono se puede pasar a QIcon::fromTheme() para cargarlo.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QString | genericIconName() const |
[read-only] globPatterns : const QStringList
Esta propiedad contiene la lista de patrones de coincidencia «glob»
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QStringList | globPatterns() const |
[read-only] iconName : const QString
Esta propiedad contiene el nombre del archivo de una imagen de icono que representa el tipo MIME
El nombre del icono se puede pasar a QIcon::fromTheme() para cargarlo.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QString | iconName() const |
[read-only] isDefault : const bool
true si este tipo MIME es el tipo MIME predeterminado que se aplica a todos los archivos: application/octet-stream.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| bool | isDefault() const |
[read-only] name : const QString
Esta propiedad contiene el nombre del tipo MIME
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QString | name() const |
[read-only] parentMimeTypes : const QStringList
Esta propiedad contiene los nombres de los tipos MIME principales
Un tipo es una subclase de otro tipo si cualquier instancia del primer tipo es también una instancia del segundo. Por ejemplo, todos los archivos image/svg+xml son también archivos text/xml, text/plain y application/octet-stream. La subclasificación se refiere al formato, más que a la categoría de los datos (por ejemplo, no existe una clase «hoja de cálculo genérica» de la que hereden todas las hojas de cálculo). Por el contrario, el tipo MIME padre de image/svg+xml es text/xml.
Un tipo MIME puede tener varios padres. Por ejemplo, «application/x-perl» tiene dos padres: «application/x-executable» y «text/plain». Esto permite tanto ejecutar scripts de Perl como abrirlos en editores de texto.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QStringList | parentMimeTypes() const |
[read-only] preferredSuffix : const QString
Esta propiedad contiene el sufijo preferido para el tipo MIME
No se incluye ningún punto inicial, por lo que, por ejemplo, devolvería «pdf» para application/pdf. El valor devuelto puede estar vacío en el caso de los tipos MIME que no tengan ningún sufijo asociado.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QString | preferredSuffix() const |
[read-only] suffixes : const QStringList
Esta propiedad contiene los sufijos conocidos para el tipo MIME
No se incluye ningún punto inicial, por lo que, por ejemplo, esto devolvería «jpg» y «jpeg» para image/jpeg.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| QStringList | suffixes() const |
[read-only] valid : const bool
true si el objeto ` QMimeType ` contiene datos válidos, ` false ` en caso contrario
Un tipo MIME válido tiene un name() no vacío. El tipo MIME no válido es el QMimeType construido por defecto.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha estado presente.
Funciones de acceso:
| bool | isValid() const |
Documentación de funciones de miembro
QMimeType::QMimeType()
Crea este objeto QMimeType inicializado con valores predeterminados para las propiedades que indican un tipo MIME no válido.
QMimeType::QMimeType(const QMimeType &other)
Crea este objeto QMimeType como una copia de other.
[noexcept] QMimeType::~QMimeType()
Destruye el objeto ` QMimeType ` y libera el puntero `d`.
[invokable] bool QMimeType::inherits(const QString &mimeTypeName) const
Devuelve ` true ` si este tipo MIME es ` mimeTypeName`, o hereda de ` mimeTypeName ` (véase ` parentMimeTypes()`), o si ` mimeTypeName ` es un alias de este tipo MIME.
Este método se puede invocar desde QML a partir de la versión 5.10.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[noexcept] void QMimeType::swap(QMimeType &other)
Cambia este tipo MIME por other. Esta operación es muy rápida y nunca falla.
El método swap() facilita la implementación de operadores de asignación de forma segura frente a excepciones. Para más información, consulta «More C++ Idioms - Copy-and-swap».
[noexcept] QMimeType &QMimeType::operator=(QMimeType &&other)
Asigna « other » a esta instancia de « QMimeType ».
QMimeType &QMimeType::operator=(const QMimeType &other)
Asigna los datos de other a este objeto QMimeType y devuelve una referencia a dicho objeto.
Elementos no miembros relacionados
[noexcept] size_t qHash(const QMimeType &key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
[noexcept] bool operator!=(const QMimeType &lhs, const QMimeType &rhs)
Devuelve « true » si « QMimeType » lhs no es igual a « QMimeType » rhs; en caso contrario, devuelve « false ».
[noexcept] bool operator==(const QMimeType &lhs, const QMimeType &rhs)
Devuelve « true » si « lhs » es igual al objeto « rhs » de « QMimeType »; en caso contrario, devuelve « false ». El nombre es el identificador único de un tipo MIME, por lo que dos tipos MIME con el mismo nombre se consideran iguales.
© 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.