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 |
- Liste de tous les membres, y compris les membres hérités
- QMimeType fait partie des classes partagées implicitement.
Comparaisons de QMimeType
| Catégorie | Types 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) |
Personnes extérieures concernées
| 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.