QMimeType Class
Die Klasse „QMimeType“ beschreibt Datei- oder Datentypen, die durch eine MIME-Typ-Zeichenkette dargestellt werden. Mehr...
| Kopfzeile: | #include <QMimeType> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QMimeType gehört zu den implizit gemeinsam genutzten Klassen.
Vergleiche zu QMimeType
| Kategorie | Vergleichbare Typen |
|---|---|
| Gleichheit | QMimeType |
Eigenschaften
|
|
Öffentliche Veranstaltungen
| 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) |
Verwandte Nichtmitglieder
| 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) |
Detaillierte Beschreibung
Beispielsweise hat eine Datei namens „readme.txt“ den MIME-Typ „text/plain“. Der MIME-Typ kann anhand des Dateinamens, des Dateiinhalts oder beidem ermittelt werden. Die Ermittlung des MIME-Typs ist auch für Datenpuffer möglich, die nicht aus Dateien stammen.
Die Ermittlung des MIME-Typs einer Datei kann nützlich sein, um sicherzustellen, dass Ihre Anwendung diesen unterstützt. Sie ist außerdem in Dateimanager-ähnlichen Anwendungen oder Widgets hilfreich, um eine passende „ icon “ für die Datei oder sogar die beschreibende „ comment “ in Detailansichten anzuzeigen.
Um zu prüfen, ob eine Datei den erwarteten MIME-Typ aufweist, solltest du inherits() verwenden, anstatt einen einfachen Zeichenfolgenvergleich auf Basis von name() durchzuführen. Der Grund dafür ist, dass MIME-Typen voneinander erben können: So ist beispielsweise eine C-Quelldatei eine spezielle Art von Klartextdatei, sodass text/x-csrc den MIME-Typ text/plain erbt.
Siehe auch ` QMimeDatabase ` und MIME-Typ-Browser.
Dokumentation zu den Eigenschaften
[read-only] aliases : const QStringList
Diese Eigenschaft enthält die Liste der Aliase dieses MIME-Typs
Für „text/csv“ würde die zurückgegebene Liste beispielsweise lauten: „text/x-csv“, „text/x-comma-separated-values“.
Beachten Sie, dass sich alle „ QMimeType “-Instanzen auf die eigentlichen MIME-Typen beziehen, niemals direkt auf Aliase.
Die Reihenfolge der Aliase in der Liste ist nicht definiert.
Diese Eigenschaft wurde zwar in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QStringList | aliases() const |
[read-only] allAncestors : const QStringList
Diese Eigenschaft enthält die Namen der direkten und indirekten übergeordneten MIME-Typen
Gibt alle übergeordneten MIME-Typen dieses MIME-Typs zurück, sowohl direkte als auch indirekte. Dies umfasst auch die übergeordneten MIME-Typen der übergeordneten MIME-Typen usw.
Für „image/svg+xml“ würde die Liste beispielsweise wie folgt lauten: „application/xml“, „text/plain“, „application/octet-stream“.
Beachten Sie, dass „application/octet-stream“ der oberste übergeordnete MIME-Typ für alle Dateitypen (jedoch nicht für Verzeichnisse) ist.
Diese Eigenschaft wurde zwar in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QStringList | allAncestors() const |
[read-only] comment : const QString
Diese Eigenschaft enthält die Beschreibung des MIME-Typs, die in Benutzeroberflächen angezeigt werden soll
Gibt eine Beschreibung für einen MIME-Typ zurück, die an die aktuellen Spracheinstellungen des Benutzers angepasst ist.
Diese Eigenschaft wurde zwar in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QString | comment() const |
[read-only] filterString : const QString
Diese Eigenschaft enthält eine Filterzeichenfolge, die für einen Dateidialog verwendet werden kann
Diese Eigenschaft wurde zwar erst in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QString | filterString() const |
[read-only] genericIconName : const QString
Diese Eigenschaft enthält den Dateinamen eines generischen Symbols, das den MIME-Typ darstellt
Dies sollte verwendet werden, wenn das von iconName() zurückgegebene Symbol auf dem System nicht gefunden werden kann. Es wird für Kategorien ähnlicher Typen (wie Tabellenkalkulationen oder Archive) verwendet, für die ein gemeinsames Symbol verwendet werden kann. Die Icon Naming Specification von freedesktop.org listet eine Reihe solcher Symbolnamen auf.
Der Symbolname kann an ` QIcon::fromTheme()` übergeben werden, um das Symbol zu laden.
Diese Eigenschaft wurde zwar erst in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QString | genericIconName() const |
[read-only] globPatterns : const QStringList
Diese Eigenschaft enthält die Liste der Glob-Muster
Diese Eigenschaft wurde zwar erst in Version 5.10 eingeführt, die zugehörige Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QStringList | globPatterns() const |
[read-only] iconName : const QString
Diese Eigenschaft enthält den Dateinamen eines Symbolbildes, das den MIME-Typ darstellt
Der Name des Symbols kann an ` QIcon::fromTheme()` übergeben werden, um das Symbol zu laden.
Diese Eigenschaft wurde zwar erst in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QString | iconName() const |
[read-only] isDefault : const bool
true Wenn dieser MIME-Typ der Standard-MIME-Typ ist, der für alle Dateien gilt: application/octet-stream.
Diese Eigenschaft wurde zwar erst in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| bool | isDefault() const |
[read-only] name : const QString
Diese Eigenschaft enthält den Namen des MIME-Typs
Diese Eigenschaft wurde zwar in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QString | name() const |
[read-only] parentMimeTypes : const QStringList
Diese Eigenschaft enthält die Namen der übergeordneten MIME-Typen
Ein Typ ist eine Unterklasse eines anderen Typs, wenn jede Instanz des ersten Typs auch eine Instanz des zweiten Typs ist. Beispielsweise sind alle „image/svg+xml“-Dateien auch „text/xml“-Dateien, „text/plain“-Dateien und „application/octet-stream“-Dateien. Bei der Unterklassifizierung geht es um das Format und nicht um die Kategorie der Daten (es gibt beispielsweise keine Klasse „generische Tabellenkalkulation“, von der alle Tabellenkalkulationen ableiten). Umgekehrt ist der übergeordnete MIME-Typ von „image/svg+xml“ „text/xml“.
Ein MIME-Typ kann mehrere übergeordnete MIME-Typen haben. So hat beispielsweise „application/x-perl“ zwei übergeordnete MIME-Typen: „application/x-executable“ und „text/plain“. Dadurch ist es möglich, Perl-Skripte sowohl auszuführen als auch in Texteditoren zu öffnen.
Diese Eigenschaft wurde zwar erst in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QStringList | parentMimeTypes() const |
[read-only] preferredSuffix : const QString
Diese Eigenschaft enthält das bevorzugte Suffix für den MIME-Typ
Es wird kein führender Punkt mitgegeben, sodass beispielsweise für „application/pdf“ der Wert „pdf“ zurückgegeben würde. Der Rückgabewert kann leer sein, wenn dem MIME-Typ keine Endung zugeordnet ist.
Diese Eigenschaft wurde zwar erst in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QString | preferredSuffix() const |
[read-only] suffixes : const QStringList
Diese Eigenschaft enthält die bekannten Suffixe für den MIME-Typ
Ein führender Punkt wird nicht berücksichtigt, sodass beispielsweise für „image/jpeg“ die Werte „jpg“ und „jpeg“ zurückgegeben würden.
Diese Eigenschaft wurde zwar in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| QStringList | suffixes() const |
[read-only] valid : const bool
true Wenn das Objekt „ QMimeType “ gültige Daten enthält, false andernfalls
Ein gültiger MIME-Typ hat ein nicht leeres ` name` (). Der ungültige MIME-Typ ist das standardmäßig konstruierte ` QMimeType`.
Diese Eigenschaft wurde zwar erst in Version 5.10 eingeführt, die entsprechende Zugriffsmethode war jedoch schon immer vorhanden.
Zugriffsfunktionen:
| bool | isValid() const |
Dokumentation zu Mitgliedsfunktionen
QMimeType::QMimeType()
Erstellt dieses QMimeType-Objekt, das mit Standardwerten für die Eigenschaften initialisiert ist, die auf einen ungültigen MIME-Typ hinweisen.
QMimeType::QMimeType(const QMimeType &other)
Erstellt dieses QMimeType-Objekt als Kopie von other.
[noexcept] QMimeType::~QMimeType()
Löscht das Objekt „ QMimeType “ und gibt den Zeiger „d“ frei.
[invokable] bool QMimeType::inherits(const QString &mimeTypeName) const
Gibt „ true “ zurück, wenn dieser MIME-Typ „ mimeTypeName “ ist, „ mimeTypeName “ erbt (siehe parentMimeTypes()), oder „ mimeTypeName “ ein Alias für diesen MIME-Typ ist.
Diese Methode kann seit Version 5.10 aus QML aufgerufen werden.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[noexcept] void QMimeType::swap(QMimeType &other)
Ersetzt diesen MIME-Typ durch „ other “. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.
Die swap()-Methode hilft bei der Implementierung von Zuweisungsoperatoren auf eine ausnahmensichere Weise. Weitere Informationen finden Sie unter „More C++ Idioms – Copy-and-swap“.
[noexcept] QMimeType &QMimeType::operator=(QMimeType &&other)
Weist „ other “ dieser „ QMimeType “-Instanz zu.
QMimeType &QMimeType::operator=(const QMimeType &other)
Weist die Daten von other diesem QMimeType -Objekt zu und gibt eine Referenz auf dieses Objekt zurück.
Verwandte Nicht-Mitglieder
[noexcept] size_t qHash(const QMimeType &key, size_t seed = 0)
Gibt den Hashwert für key zurück, wobei seed als Startwert für die Berechnung verwendet wird.
[noexcept] bool operator!=(const QMimeType &lhs, const QMimeType &rhs)
Gibt „ true “ zurück, wenn „ QMimeType “ lhs nicht gleich „ QMimeType “ rhs ist; andernfalls wird „ false “ zurückgegeben.
[noexcept] bool operator==(const QMimeType &lhs, const QMimeType &rhs)
Gibt „ true “ zurück, wenn „ lhs “ dem Objekt „ rhs “ QMimeType entspricht; andernfalls wird „ false “ zurückgegeben. Der Name ist die eindeutige Kennung eines MIME-Typs, sodass zwei MIME-Typen mit demselben Namen als gleich gelten.
© 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.
