QMimeType Class
La clase QMimeType describe tipos de ficheros o datos, representados por una cadena de tipo MIME. Más...
| Cabecera: | #include <QMimeType> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluyendo los heredados
- QMimeType es parte de Clases Implícitamente Compartidas.
Esta clase es igual-comparable.
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) |
Relacionados No Miembros
| 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 puede determinarse a partir del nombre del archivo, de su contenido o de ambos. La determinación del tipo MIME también puede realizarse en buffers de datos que no procedan de ficheros.
Determinar el tipo MIME de un fichero puede ser útil para asegurarse de que su aplicación lo soporta. También es útil en aplicaciones tipo gestor de archivos o widgets, para mostrar un icon apropiado para el archivo, o incluso el descriptivo comment en vistas detalladas.
Para comprobar si un archivo tiene el tipo MIME esperado, debería utilizar inherits() en lugar de una simple comparación de cadenas basada en name(). Esto se debe a que los tipos MIME pueden heredar unos de otros: por ejemplo, un archivo fuente C es un tipo específico de archivo de texto plano, por lo que text/x-csrc hereda text/plain.
Véase también QMimeDatabase y Navegador de tipos MIME.
Documentación de propiedades
[read-only] aliases : const QStringList
Esta propiedad contiene la lista de alias de este mimetype.
Por ejemplo, para text/csv, la lista devuelta sería: text/x-csv, text/x-comma-separated-values.
Tenga en cuenta que todas las instancias de QMimeType hacen referencia a mimetypes propios, nunca a alias directamente.
El orden de los alias en la lista no está definido.
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha existido.
Funciones de acceso:
| QStringList | aliases() const |
[read-only] allAncestors : const QStringList
Esta propiedad contiene los nombres de los tipos MIME padre directos e indirectos
Devuelve todos los tipos MIME padre de este tipo MIME, directos e indirectos. Esto incluye el/los padre(s) de su(s) padre(s), etc.
Por ejemplo, para image/svg+xml la lista sería: application/xml, text/plain, application/octet-stream.
Nótese que application/octet-stream es el padre último para todos los tipos de ficheros (pero no para los directorios).
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha estado ahí.
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 para un tipo MIME, localizada a la configuración de idioma actual del usuario.
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha existido.
Funciones de acceso:
| QString | comment() const |
[read-only] filterString : const QString
Esta propiedad contiene una cadena de filtro utilizable para un diálogo de archivo
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha existido.
Funciones de acceso:
| QString | filterString() const |
[read-only] genericIconName : const QString
Esta propiedad contiene el nombre de archivo de un icono genérico que representa el tipo MIME
Debe utilizarse si el icono devuelto por iconName() no puede encontrarse en el sistema. Se utiliza para categorías de tipos similares (como hojas de cálculo o archivos) que pueden utilizar un icono común. La Especificación de Nombres de Iconos de freedesktop.org enumera un conjunto de nombres de iconos de este tipo.
El nombre del icono se puede dar a QIcon::fromTheme() para cargar el icono.
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha estado ahí.
Funciones de acceso:
| QString | genericIconName() const |
[read-only] globPatterns : const QStringList
Esta propiedad contiene la lista de patrones de concordancia glob
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha existido.
Funciones de acceso:
| QStringList | globPatterns() const |
[read-only] iconName : const QString
Esta propiedad contiene el nombre de archivo de una imagen de icono que representa el tipo MIME
El nombre del icono se puede dar a QIcon::fromTheme() para cargar el icono.
Aunque esta propiedad se introdujo en la versión 5.10, el método de acceso correspondiente siempre ha existido.
Funciones de acceso:
| QString | iconName() const |
[read-only] isDefault : const bool
true si este tipo MIME es el tipo MIME por defecto que se aplica a todos los ficheros: application/octet-stream.
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha estado ahí.
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, siempre ha existido el método de acceso correspondiente.
Funciones de acceso:
| QString | name() const |
[read-only] parentMimeTypes : const QStringList
Esta propiedad contiene los nombres de los tipos MIME padre.
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 text/xml, text/plain y application/octet-stream. La subclasificación tiene que ver con el formato, no con 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 mimetype padre de image/svg+xml es text/xml.
Un mimetype puede tener varios padres. Por ejemplo, application/x-perl tiene dos padres: application/x-executable y text/plain. Esto permite tanto ejecutar scripts perl como abrirlos en editores de texto.
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha existido.
Funciones de acceso:
| QStringList | parentMimeTypes() const |
[read-only] preferredSuffix : const QString
Esta propiedad contiene el sufijo preferido para el tipo MIME
No se incluye el punto inicial, por lo que, por ejemplo, devolvería "pdf" para application/pdf. El valor devuelto puede estar vacío para los tipos MIME que no tienen ningún sufijo asociado.
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha existido.
Funciones de acceso:
| QString | preferredSuffix() const |
[read-only] suffixes : const QStringList
Esta propiedad contiene los sufijos conocidos para el tipo MIME
No se incluye el punto inicial, por lo que, por ejemplo, devolvería "jpg", "jpeg" para image/jpeg.
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha existido.
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 inválido es el construido por defecto QMimeType.
Aunque esta propiedad se introdujo en 5.10, el método de acceso correspondiente siempre ha existido.
Funciones de acceso:
| bool | isValid() const |
Documentación de funciones miembro
QMimeType::QMimeType()
Construye este objeto QMimeType inicializado con valores de propiedad por defecto que indican un tipo MIME inválido.
QMimeType::QMimeType(const QMimeType &other)
Construye 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 mimetype es mimeTypeName, o hereda mimeTypeName (véase parentMimeTypes()), o mimeTypeName es un alias de este mimetype.
Este método puede invocarse desde QML desde la versión 5.10.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[noexcept] void QMimeType::swap(QMimeType &other)
Intercambia este tipo mime con other. Esta operación es muy rápida y nunca falla.
El método swap() ayuda con la implementación de operadores de asignación de una manera a prueba de excepciones. Para obtener más información, consulte Más C ++ Modismos - Copiar y cambiar.
[noexcept] QMimeType &QMimeType::operator=(QMimeType &&other)
Mover-asigna other a esta instancia QMimeType.
QMimeType &QMimeType::operator=(const QMimeType &other)
Asigna los datos de other a este objeto QMimeType, y devuelve una referencia a este objeto.
No miembros relacionados
[noexcept] size_t qHash(const QMimeType &key, size_t seed = 0)
Devuelve el valor hash para key, utilizando seed para sembrar 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 QMimeType , en caso contrario devuelve false. El nombre es el identificador único de un mimetype, por lo que dos mimetypes con el mismo nombre, son 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.
