Sur cette page

QMimeType Class

La classe QMimeType décrit les types de fichiers ou de données, représentés par une chaîne de type MIME. Plus d'informations...

En-tête : #include <QMimeType>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core

Cette classe est comparable à l'égalité.

Propriétés

Fonctions publiques

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)
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)

Description détaillée

Par exemple, un fichier nommé "readme.txt" a le type MIME "text/plain". Le type MIME peut être déterminé à partir du nom du fichier, de son contenu ou des deux. La détermination du type MIME peut également être effectuée sur des tampons de données ne provenant pas de fichiers.

La détermination du type MIME d'un fichier peut être utile pour s'assurer que votre application le prend en charge. Elle est également utile dans les applications de type gestionnaire de fichiers ou dans les widgets, afin d'afficher une page icon appropriée pour le fichier, ou même la page comment descriptive dans les vues détaillées.

Pour vérifier si un fichier a le type MIME attendu, vous devez utiliser inherits() plutôt qu'une simple comparaison de chaînes de caractères basée sur name(). En effet, les types MIME peuvent hériter les uns des autres : par exemple, un fichier source C est un type spécifique de fichier texte brut, de sorte que text/x-csrc hérite de text/plain.

Voir également QMimeDatabase et MIME Type Browser.

Documentation sur les propriétés

[read-only] aliases : const QStringList

Cette propriété contient la liste des alias de ce type d'image

Par exemple, pour text/csv, la liste retournée serait : text/x-csv, text/x-comma-separated-values.

Notez que toutes les instances de QMimeType se réfèrent à des mimetypes appropriés, jamais à des alias directement.

L'ordre des alias dans la liste n'est pas défini.

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QStringList aliases() const

[read-only] allAncestors : const QStringList

Cette propriété contient les noms des types MIME parents directs et indirects

Retourne tous les types MIME parents de ce type MIME, directs et indirects. Cela inclut le(s) parent(s) de son(ses) parent(s), etc.

Par exemple, pour image/svg+xml, la liste serait : application/xml, text/plain, application/octet-stream.

Notez que application/octet-stream est le parent ultime pour tous les types de fichiers (mais pas pour les répertoires).

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QStringList allAncestors() const

[read-only] comment : const QString

Cette propriété contient la description du type MIME à afficher sur les interfaces utilisateur

Renvoie la description d'un type MIME, localisée en fonction des paramètres linguistiques de l'utilisateur.

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QString comment() const

[read-only] filterString : const QString

Cette propriété contient une chaîne de filtre utilisable pour un dialogue de fichier

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QString filterString() const

[read-only] genericIconName : const QString

Cette propriété contient le nom de fichier d'une icône générique qui représente le type MIME

Cette propriété doit être utilisée si l'icône renvoyée par iconName() est introuvable sur le système. Elle est utilisée pour les catégories de types similaires (comme les feuilles de calcul ou les archives) qui peuvent utiliser une icône commune. La spécification d'appellation des icônes de freedesktop.org répertorie un ensemble de noms d'icônes de ce type.

Le nom de l'icône peut être donné à QIcon::fromTheme() afin de charger l'icône.

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours été présente.

Fonctions d'accès :

QString genericIconName() const

[read-only] globPatterns : const QStringList

Cette propriété contient la liste des motifs de correspondance globaux

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QStringList globPatterns() const

[read-only] iconName : const QString

Cette propriété contient le nom de fichier d'une image d'icône qui représente le type MIME

Le nom de l'icône peut être donné à QIcon::fromTheme() afin de charger l'icône.

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QString iconName() const

[read-only] isDefault : const bool

true si ce type MIME est le type MIME par défaut qui s'applique à tous les fichiers : application/octet-stream.

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

bool isDefault() const

[read-only] name : const QString

Cette propriété contient le nom du type MIME

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QString name() const

[read-only] parentMimeTypes : const QStringList

Cette propriété contient les noms des types MIME parents

Un type est une sous-classe d'un autre type si toute instance du premier type est également une instance du second. Par exemple, tous les fichiers image/svg+xml sont également des fichiers text/xml, text/plain et application/octet-stream. La sous-classification concerne le format, plutôt que la catégorie des données (par exemple, il n'existe pas de classe "feuille de calcul générique" dont toutes les feuilles de calcul héritent). Inversement, le mimetype parent de image/svg+xml est text/xml.

Un mimetype peut avoir plusieurs parents. Par exemple, application/x-perl a deux parents : application/x-executable et text/plain. Cela permet à la fois d'exécuter des scripts perl et de les ouvrir dans des éditeurs de texte.

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QStringList parentMimeTypes() const

[read-only] preferredSuffix : const QString

Cette propriété contient le suffixe préféré pour le type MIME

Aucun point n'est inclus, ce qui signifie par exemple que la valeur retournée est "pdf" pour application/pdf. La valeur de retour peut être vide pour les types MIME qui n'ont pas de suffixe associé.

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QString preferredSuffix() const

[read-only] suffixes : const QStringList

Cette propriété contient les suffixes connus pour le type MIME

Aucun point n'est inclus, ce qui signifie par exemple que cette propriété renverrait "jpg", "jpeg" pour image/jpeg.

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

QStringList suffixes() const

[read-only] valid : const bool

true si l'objet QMimeType contient des données valides, false sinon

Un type MIME valide a un name() non vide. Le type MIME invalide est la construction par défaut QMimeType.

Bien que cette propriété ait été introduite dans la version 5.10, la méthode d'accès correspondante a toujours existé.

Fonctions d'accès :

bool isValid() const

Documentation des fonctions membres

QMimeType::QMimeType()

Construit cet objet QMimeType initialisé avec des valeurs de propriétés par défaut qui indiquent un type MIME invalide.

QMimeType::QMimeType(const QMimeType &other)

Construit cet objet QMimeType comme une copie de other.

[noexcept] QMimeType::~QMimeType()

Détruit l'objet QMimeType et libère le pointeur d.

[invokable] bool QMimeType::inherits(const QString &mimeTypeName) const

Retourne true si ce type de fichier est mimeTypeName, ou hérite de mimeTypeName (voir parentMimeTypes()), ou mimeTypeName est un alias pour ce type de fichier.

Cette méthode peut être invoquée à partir de QML depuis la version 5.10.

Note : Cette fonction peut être invoquée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

[noexcept] void QMimeType::swap(QMimeType &other)

Remplace ce type de mime par other. Cette opération est très rapide et n'échoue jamais.

La méthode swap() permet d'implémenter les opérateurs d'affectation de manière sécurisée. Pour plus d'informations, consultez More C++ Idioms - Copy-and-swap.

[noexcept] QMimeType &QMimeType::operator=(QMimeType &&other)

Move-assigne other à cette instance QMimeType.

QMimeType &QMimeType::operator=(const QMimeType &other)

Affecte les données de other à cet objet QMimeType et renvoie une référence à cet objet.

Non-membres apparentés

[noexcept] size_t qHash(const QMimeType &key, size_t seed = 0)

Renvoie la valeur de hachage pour key, en utilisant seed comme base de calcul.

[noexcept] bool operator!=(const QMimeType &lhs, const QMimeType &rhs)

Renvoie true si QMimeType lhs n'est pas égal à QMimeType rhs , sinon renvoie false.

[noexcept] bool operator==(const QMimeType &lhs, const QMimeType &rhs)

Renvoie true si lhs est égal à l'objet rhs QMimeType , sinon renvoie false. Le nom est l'identifiant unique d'un mimetype, de sorte que deux mimetypes portant le même nom sont égaux.

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