QMimeType Class
Die Klasse QMimeType beschreibt Datei- oder Datentypen, die durch einen MIME-Typ-String 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 ist Teil von Implicitly Shared Classes.
Diese Klasse ist gleichwertig vergleichbar.
Eigenschaften
|
|
Öffentliche Funktionen
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 Nicht-Mitglieder
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
Eine Datei mit dem Namen "readme.txt" hat zum Beispiel den MIME-Typ "text/plain". Der MIME-Typ kann aus dem Dateinamen oder aus dem Inhalt der Datei oder aus beidem bestimmt werden. Die Bestimmung des MIME-Typs kann auch für Datenpuffer durchgeführt werden, die nicht von Dateien stammen.
Die Bestimmung des MIME-Typs einer Datei kann nützlich sein, um sicherzustellen, dass Ihre Anwendung den Typ unterstützt. Sie ist auch in Dateimanager-ähnlichen Anwendungen oder Widgets nützlich, um ein passendes icon für die Datei anzuzeigen, oder sogar die beschreibende comment in detaillierten Ansichten.
Um zu prüfen, ob eine Datei den erwarteten MIME-Typ hat, sollten Sie inherits() verwenden und nicht einen einfachen String-Vergleich auf der Grundlage von name(). Der Grund dafür ist, dass MIME-Typen voneinander erben können: Eine C-Quelldatei ist beispielsweise ein bestimmter Typ einer reinen Textdatei, so dass text/x-csrc von text/plain erbt.
Siehe auch QMimeDatabase und MIME Type Browser.
Dokumentation der Eigenschaften
[read-only]
aliases : const QStringList
Diese Eigenschaft enthält die Liste der Aliasnamen dieses Mimetyps
Für text/csv wäre die zurückgegebene Liste zum Beispiel: text/x-csv, text/x-comma-separated-values.
Beachten Sie, dass sich alle Instanzen von QMimeType auf eigene Mimetypen beziehen, niemals auf Aliase direkt.
Die Reihenfolge der Aliase in der Liste ist undefiniert.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
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 Mimetypen dieses Mimetyps zurück, direkt und indirekt. Dazu gehören auch die übergeordneten Typen der übergeordneten Typen, usw.
Für image/svg+xml wäre die Liste zum Beispiel: application/xml, text/plain, application/octet-stream.
Beachten Sie, dass application/octet-stream der ultimative Elternteil für alle Dateitypen (aber nicht für Verzeichnisse) ist.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
QStringList | allAncestors() const |
[read-only]
comment : const QString
Diese Eigenschaft enthält die Beschreibung des MIME-Typs, die auf Benutzeroberflächen angezeigt werden soll
Die Standardsprache (QLocale().name()) wird verwendet, um die passende Übersetzung auszuwählen.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
QString | comment() const |
[read-only]
filterString : const QString
Diese Eigenschaft enthält eine Filterzeichenfolge, die für einen Dateidialog verwendet werden kann.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
QString | filterString() const |
[read-only]
genericIconName : const QString
Diese Eigenschaft enthält den Dateinamen eines generischen Symbols, das den MIME-Typ
Diese Eigenschaft sollte verwendet werden, wenn das von iconName() zurückgegebene Symbol im System nicht gefunden werden kann. Es wird für Kategorien ähnlicher Typen (wie Tabellenkalkulationen oder Archive) verwendet, die ein gemeinsames Symbol verwenden können. Die freedesktop.org Icon Naming Specification listet eine Reihe von solchen Icon-Namen auf.
Der Icon-Name kann an QIcon::fromTheme() übergeben werden, um das Icon zu laden.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
QString | genericIconName() const |
[read-only]
globPatterns : const QStringList
Diese Eigenschaft enthält die Liste der global passenden Muster
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
QStringList | globPatterns() const |
[read-only]
iconName : const QString
Diese Eigenschaft enthält den Dateinamen eines Icon-Bildes, das den MIME-Typ
Der Icon-Name kann an QIcon::fromTheme() übergeben werden, um das Icon zu laden.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
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.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
bool | isDefault() const |
[read-only]
name : const QString
Diese Eigenschaft enthält den Namen des MIME-Typs
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
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 ist. Zum Beispiel sind alle image/svg+xml-Dateien auch text/xml-, text/plain- und application/octet-stream-Dateien. Bei der Unterklassifizierung geht es um das Format und nicht um die Kategorie der Daten (es gibt z. B. keine "generische Tabellenkalkulationsklasse", von der alle Tabellenkalkulationsblätter erben). Umgekehrt ist der übergeordnete Mimetyp von image/svg+xml text/xml.
Ein Mimetyp kann mehrere Elterntypen haben. Zum Beispiel hat application/x-perl zwei Eltern: application/x-executable und text/plain. Damit ist es möglich, Perl-Skripte sowohl auszuführen als auch in Texteditoren zu öffnen.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
QStringList | parentMimeTypes() const |
[read-only]
preferredSuffix : const QString
Diese Eigenschaft enthält das bevorzugte Suffix für den MIME-Typ
Es ist kein führender Punkt enthalten, so dass beispielsweise "pdf" für application/pdf zurückgegeben würde. Der Rückgabewert kann leer sein, für MIME-Typen, die keine Suffixe zugeordnet haben.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
QString | preferredSuffix() const |
[read-only]
suffixes : const QStringList
Diese Eigenschaft enthält die bekannten Suffixe für den MIME-Typ
Es wird kein führender Punkt eingefügt, so dass zum Beispiel "jpg", "jpeg" für image/jpeg zurückgegeben würde.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
QStringList | suffixes() const |
[read-only]
valid : const bool
true
wenn das Objekt QMimeType gültige Daten enthält, andernfalls false
Ein gültiger MIME-Typ hat einen nicht leeren name(). Der ungültige MIME-Typ ist der standardmäßig konstruierte QMimeType.
Während diese Eigenschaft in 5.10 eingeführt wurde, gab es die entsprechende Accessor-Methode schon immer.
Zugriffsfunktionen:
bool | isValid() const |
Dokumentation der Mitgliedsfunktionen
QMimeType::QMimeType()
Konstruiert dieses QMimeType-Objekt, das mit Standard-Eigenschaftswerten initialisiert wird, die einen ungültigen MIME-Typ anzeigen.
QMimeType::QMimeType(const QMimeType &other)
Konstruiert dieses QMimeType-Objekt als Kopie von other.
[noexcept]
QMimeType::~QMimeType()
Zerstört das Objekt QMimeType und gibt den Zeiger d frei.
[invokable]
bool QMimeType::inherits(const QString &mimeTypeName) const
Gibt true
zurück, wenn dieser Mimetyp mimeTypeName ist, oder mimeTypeName erbt (siehe parentMimeTypes()), oder mimeTypeName ein Alias für diesen Mimetyp ist.
Diese Methode kann seit Version 5.10 von QML aus aufgerufen werden.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[noexcept]
void QMimeType::swap(QMimeType &other)
Tauscht diesen Mime-Typ mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.
Die Methode swap() hilft bei der Implementierung von Zuweisungsoperatoren auf ausnahmesichere Weise. Weitere Informationen finden Sie in More C++ Idioms - Copy-and-swap.
[noexcept]
QMimeType &QMimeType::operator=(QMimeType &&other)
Verschieben - 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 Hash-Wert 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 gibt es false
zurück.
[noexcept]
bool operator==(const QMimeType &lhs, const QMimeType &rhs)
Gibt true
zurück, wenn lhs gleich dem Objekt rhs QMimeType ist, andernfalls false
. Der Name ist der eindeutige Bezeichner für einen Mimetyp, so dass zwei Mimetypen mit demselben Namen gleich sind.
© 2025 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.