QMimeType Class
QMimeType クラスは、MIME タイプ文字列によって表されるファイルやデータのタイプを定義します。詳細...
| ヘッダー: | #include <QMimeType> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- QMimeTypeは「暗黙的に共有されるクラス」の一部です。
QMimeType の比較
| カテゴリ | 比較可能な型 |
|---|---|
| 等価性 | QMimeType |
プロパティ
|
|
公開関数
| 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) |
詳細な説明
たとえば、「readme.txt」という名前のファイルの MIME タイプは「text/plain」です。MIME タイプは、ファイル名、ファイルの内容、あるいはその両方から判別できます。また、ファイルに由来しないデータのバッファに対しても、MIME タイプの判別を行うことができます。
ファイルの MIME タイプを判定することは、アプリケーションがそのファイル形式をサポートしていることを確認するのに役立ちます。また、ファイルマネージャーのようなアプリケーションやウィジェットにおいて、ファイルに適したicon を表示したり、詳細ビューで説明的なcomment を表示したりするのにも役立ちます。
ファイルが期待されるMIMEタイプであるかどうかを確認するには、name() に基づく単純な文字列比較ではなく、inherits() を使用する必要があります。これは、MIMEタイプが互いに継承されることがあるためです。たとえば、Cソースファイルはプレーンテキストファイルの一種であるため、text/x-csrc は text/plain を継承します。
QMimeDatabase およびMIME Type Browserも参照してください 。
プロパティのドキュメント
[read-only] aliases : const QStringList
このプロパティには、このMIMEタイプのエイリアスのリストが格納されています
たとえば、text/csv の場合、返されるリストは次のようになります：text/x-csv、text/x-comma-separated-values。
すべての `QMimeType ` インスタンスは、適切な MIME タイプを参照しており、エイリアスを直接参照することは決してないことに注意してください。
リスト内のエイリアスの順序は未定義です。
このプロパティは 5.10 で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QStringList | aliases() const |
[read-only] allAncestors : const QStringList
このプロパティには、直接および間接的な親MIMEタイプ名が格納されます
このMIMEタイプのすべての親MIMEタイプ（直接および間接）を返します。これには、その親の親なども含まれます。
たとえば、image/svg+xml の場合、リストは次のようになります：application/xml、text/plain、application/octet-stream。
なお、application/octet-stream は、すべてのファイルタイプ（ただし、ディレクトリを除く）の最終的な親となります。
このプロパティは 5.10 で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QStringList | allAncestors() const |
[read-only] comment : const QString
このプロパティには、ユーザーインターフェースに表示されるMIMEタイプの説明が格納されます
ユーザーの現在の言語設定に合わせてローカライズされた、MIME タイプの説明を返します。
このプロパティはバージョン 5.10 で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QString | comment() const |
[read-only] filterString : const QString
このプロパティには、ファイルダイアログで使用できるフィルタ文字列が格納されています
このプロパティは5.10で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QString | filterString() const |
[read-only] genericIconName : const QString
このプロパティには、MIMEタイプを表す汎用アイコンのファイル名が格納されます
これは、iconName() によって返されるアイコンがシステム上で見つからない場合に使用します。これは、共通のアイコンを使用できる類似のタイプ（スプレッドシートやアーカイブなど）のカテゴリに対して使用されます。freedesktop.org のアイコン命名仕様には、そのようなアイコン名のリストが記載されています。
アイコンを読み込むには、QIcon::fromTheme() にこのアイコン名を指定します。
このプロパティは 5.10 で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QString | genericIconName() const |
[read-only] globPatterns : const QStringList
このプロパティには、グロブマッチングパターンのリストが格納されています
このプロパティは5.10で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QStringList | globPatterns() const |
[read-only] iconName : const QString
このプロパティには、MIMEタイプを表すアイコン画像のファイル名が格納されます
アイコンを読み込むには、QIcon::fromTheme() にこのアイコン名を渡すことができます。
このプロパティは 5.10 で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QString | iconName() const |
[read-only] isDefault : const bool
true このMIMEタイプが、すべてのファイルに適用されるデフォルトのMIMEタイプである場合：application/octet-stream。
このプロパティは 5.10 で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| bool | isDefault() const |
[read-only] name : const QString
このプロパティには、MIME タイプの名前が格納されます
このプロパティは5.10で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QString | name() const |
[read-only] parentMimeTypes : const QStringList
このプロパティには、親MIMEタイプの名前が格納されます
あるタイプが別のタイプのサブクラスであるとは、前者のタイプのインスタンスがすべて後者のタイプのインスタンスでもある場合を指します。例えば、すべての image/svg+xml ファイルは、text/xml、text/plain、および application/octet-stream ファイルでもあります。 サブクラス化は、データのカテゴリではなく、フォーマットに関するものです（例えば、すべてのスプレッドシートが継承する「汎用スプレッドシート」というクラスは存在しません）。逆に、image/svg+xml の親 MIME タイプは text/xml です。
MIMEタイプは複数の親を持つことができます。例えば、application/x-perlには、application/x-executableとtext/plainという2つの親があります。これにより、Perlスクリプトを実行することも、テキストエディタで開くことも可能になります。
このプロパティは5.10で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QStringList | parentMimeTypes() const |
[read-only] preferredSuffix : const QString
このプロパティには、MIME タイプに推奨される接尾辞が格納されます
先頭のドットは含まれないため、例えば application/pdf の場合は「pdf」が返されます。サフィックスが関連付けられていない MIME タイプの場合、戻り値は空になることがあります。
このプロパティはバージョン 5.10 で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QString | preferredSuffix() const |
[read-only] suffixes : const QStringList
このプロパティには、MIME タイプに対して既知のサフィックスが格納されます。
先頭のドットは含まれないため、例えば image/jpeg の場合、このプロパティは "jpg" や "jpeg" を返します。
このプロパティは 5.10 で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| QStringList | suffixes() const |
[read-only] valid : const bool
true QMimeType オブジェクトに有効なデータが含まれている場合は ` `、そうでない場合は ` `false
有効なMIMEタイプは、name()が空でないものです。無効なMIMEタイプは、デフォルトで生成されたQMimeType です。
このプロパティは5.10で導入されましたが、対応するアクセサメソッドは以前から存在していました。
アクセス関数：
| bool | isValid() const |
メンバ関数のドキュメント
QMimeType::QMimeType()
無効なMIMEタイプを示すデフォルトのプロパティ値で初期化されたこのQMimeTypeオブジェクトを構築します。
QMimeType::QMimeType(const QMimeType &other)
other のコピーとして、このQMimeTypeオブジェクトを生成します。
[noexcept] QMimeType::~QMimeType()
QMimeType オブジェクトを破棄し、dポインタを解放します。
[invokable] bool QMimeType::inherits(const QString &mimeTypeName) const
このMIMEタイプがmimeTypeName である場合、またはmimeTypeName を継承している場合（parentMimeTypes()を参照）、あるいはmimeTypeName がこのMIMEタイプの別名である場合に、true を返します。
このメソッドは、バージョン 5.10 以降、QML から呼び出せるようになりました。
注：この関数は 、メタオブジェクトシステムを介して、およびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[noexcept] void QMimeType::swap(QMimeType &other)
このMIMEタイプをother と入れ替えます。この操作は非常に高速で、失敗することはありません。
swap() メソッドは、例外安全な方法で代入演算子を実装するのに役立ちます。詳細については、『More C++ Idioms - Copy-and-swap』を参照してください。
[noexcept] QMimeType &QMimeType::operator=(QMimeType &&other)
other をこのQMimeType インスタンスに割り当てます。
QMimeType &QMimeType::operator=(const QMimeType &other)
other のデータをこのQMimeType オブジェクトに割り当て、このオブジェクトへの参照を返します。
関連する非メンバー
[noexcept] size_t qHash(const QMimeType &key, size_t seed = 0)
`key` のハッシュ値を、計算のシードとして `seed ` を使用して返します。
[noexcept] bool operator!=(const QMimeType &lhs, const QMimeType &rhs)
QMimeType lhs がQMimeType rhs と等しくない場合、true を返します。それ以外の場合は、false を返します。
[noexcept] bool operator==(const QMimeType &lhs, const QMimeType &rhs)
lhs がrhs のオブジェクトQMimeType と等しい場合はtrue を返し、そうでない場合はfalse を返します。名前はMIMEタイプの固有の識別子であるため、同じ名前を持つ2つのMIMEタイプは等しいとみなされます。
© 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.
