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 caractères de type MIME. En savoir plus...

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

Comparaisons de QMimeType

CatégorieTypes comparables
égalitéQMimeType

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 s'effectuer sur des tampons de données ne provenant pas de fichiers.

Déterminer le type MIME d’un fichier peut s’avérer utile pour s’assurer que votre application le prend en charge. Cela s’avère également utile dans les applications ou widgets de type gestionnaire de fichiers, afin d’afficher une icon appropriée pour le fichier, voire l’ comment descriptive dans les vues détaillées.

Pour vérifier si un fichier possède le type MIME attendu, vous devez utiliser la fonction ` inherits()` plutôt qu’une simple comparaison de chaînes basée sur la fonction ` name()`. En effet, les types MIME peuvent s’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 le navigateur de types MIME.

Documentation sur les propriétés

[read-only] aliases : const QStringList

Cette propriété contient la liste des alias de ce type MIME

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

Notez que toutes les instances d’ QMimeType s font référence à des types MIME appropriés, et jamais directement à des alias.

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

Renvoie tous les types MIME parents de ce type MIME, directs et indirects. Cela inclut le ou les parents de ses parents, et ainsi de suite.

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

Notez que « application/octet-stream » est le parent ultime de tous les types de fichiers (mais pas des 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 dans les interfaces utilisateur

Renvoie une description d’un type MIME, localisée selon les paramètres linguistiques actuels 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 filtrage utilisable dans une boîte de dialogue de sélection de fichiers

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 représentant le type MIME

Elle doit être utilisée si l'icône renvoyée par iconName() est introuvable sur le système. Elle sert pour les catégories de types similaires (comme les feuilles de calcul ou les archives) pouvant utiliser une icône commune. La spécification de nommage 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 transmis à la méthode ` 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 genericIconName() const

[read-only] globPatterns : const QStringList

Cette propriété contient la liste des modèles de correspondance « glob ».

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 du fichier d'une image d'icône représentant le type MIME

Le nom de l'icône peut être transmis à la méthode ` 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ériteraient). À l’inverse, le type MIME parent de image/svg+xml est text/xml.

Un type MIME 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 par défaut du type MIME

Aucun point n'est ajouté au début ; ainsi, par exemple, cette méthode renverrait « pdf » pour application/pdf. La valeur renvoyée peut être vide pour les types MIME auxquels aucun suffixe n'est 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 initial n'est inclus ; ainsi, par exemple, cela renverrait « jpg » et « 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 possède un objet ` name()` non vide. Le type MIME non valide est l'objet ` QMimeType` construit par défaut.

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

Crée cet objet `QMimeType` initialisé avec des valeurs de propriété par défaut indiquant un type MIME non valide.

QMimeType::QMimeType(const QMimeType &other)

Crée cet objet QMimeType en tant que 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

Renvoie « true » si ce type MIME est « mimeTypeName », s'il hérite de « mimeTypeName » (voir parentMimeTypes()), ou si « mimeTypeName » est un alias de ce type MIME.

Cette méthode peut être appelée depuis QML depuis la version 5.10.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

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

Permet de remplacer ce type MIME par other. Cette opération est très rapide et ne rencontre jamais d'échec.

La méthode swap() facilite l'implémentation d'opérateurs d'affectation sans risque d'exception. Pour plus d'informations, consultez « More C++ Idioms - Copy-and-swap ».

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

Cette opération attribue l'other à cette instance de QMimeType.

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

Attribue les données de other à cet objet QMimeType, puis renvoie une référence à cet objet.

Éléments non membres associés

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

Renvoie la valeur de hachage de key, en utilisant seed comme graine pour le 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 type MIME ; par conséquent, deux types MIME portant le même nom sont considérés comme é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.