QMimeType Class
QMimeType クラスは、MIME タイプ文字列で表されるファイルやデータのタイプを記述します。詳細...
Header: | #include <QMimeType> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
- 継承されたメンバを含む、すべてのメンバの一覧
- 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も参照してください 。
プロパティ Documentation
[read-only]
aliases : const QStringList
このプロパティは、このmimetypeのエイリアスのリストを保持する。
例えば text/csv の場合、返されるリストは text/x-csv, text/x-comma-separated-values となる。
すべてのQMimeType インスタンスは、適切なmimetypesを参照し、エイリアスを直接参照することはないことに注意。
リスト内のエイリアスの順序は未定義です。
このプロパティは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タイプの記述を保持します。
デフォルト言語 (QLocale().name()) は、適切な翻訳を選択するために使用されます。
このプロパティは5.10で導入されましたが、対応するアクセサ・メソッドは常に存在しています。
アクセス関数:
QString | comment() const |
[read-only]
filterString : const QString
このプロパティは、ファイルダイアログで使用可能なフィルタ文字列を保持します。
このプロパティは5.10で導入されましたが、対応するアクセサメソッドは常に存在しています。
アクセス関数:
QString | filterString() const |
[read-only]
genericIconName : const QString
このプロパティは、MIMEタイプを表す一般的なアイコンのファイル名を保持する。
これは、iconName()によって返されたアイコンがシステム上で見つからない場合に使用されるべきである。これは、共通のアイコンを使用することができる類似のタイプ(スプレッドシートやアーカイブなど)のカテゴリに使用されます。freedesktop.org Icon Naming Specification には、そのようなアイコン名の一覧があります。
アイコンを読み込むために、アイコン名を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タイプの名前を保持します。
最初の型のインスタンスが2番目の型のインスタンスでもある場合、型は別の型のサブクラスです。例えば、すべてのimage/svg+xmlファイルは、text/xml、text/plain、application/octet-streamファイルでもあります。サブクラス化は、データのカテゴリーではなく、フォーマットに関するものです(たとえば、すべてのスプレッドシートが継承する「汎用スプレッドシート」クラスは存在しません)。逆に、image/svg+xmlの親 mimetypeはtext/xmlです。
mimetypeは複数の親を持つことができます。例えば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タイプの既知のサフィックスを保持します。
先頭のドットは含まれないので、例えばこれは "jpg "を返し、image/jpegの場合は "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)
この QMimeType オブジェクトをother のコピーとして構築します。
[noexcept]
QMimeType::~QMimeType()
QMimeType オブジェクトを破棄し、d ポインタを解放します。
[invokable]
bool QMimeType::inherits(const QString &mimeTypeName) const
この mimetype がmimeTypeName である場合、またはmimeTypeName を継承している場合 (parentMimeTypes() を参照)、またはmimeTypeName がこの mimetype のエイリアスである場合はtrue
を返します。
このメソッドは5.10からQMLから呼び出せるようになりました。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[noexcept]
void QMimeType::swap(QMimeType &other)
QMimeType other をこのQMimeType オブジェクトと交換します。
この操作は非常に高速で、失敗することはありません。
swap()メソッドは例外安全な方法で代入演算子を実装するのに役立ちます。詳細については、More C++ Idioms - Copy-and-swapを参照してください。
[noexcept]
QMimeType &QMimeType::operator=(QMimeType &&other)
Move-このQMimeType インスタンスにother を代入。
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
を返します。name は mimetype の一意な識別子なので、同じ名前を持つ 2 つの mimetype は等しくなります。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。