QMimeType 类
QMimeType 类描述文件或数据的类型,由 MIME 类型字符串表示。 更多...
头文件 | #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) |
bool | operator!=(const QMimeType &other) const |
QMimeType & | operator=(const QMimeType &other) |
QMimeType & | operator=(QMimeType &&other) |
bool | operator==(const QMimeType &other) const |
相关的非成员函数
size_t | qHash(const QMimeType &key, size_t seed = 0) |
详细描述
例如,名为 "readme.txt" 的文件具有 "text/plain" 的 MIME 类型。MIME 类型可以通过文件名、文件内容或两者共同来确定。对于不是来自文件的文本数据的缓冲区,也可以执行 MIME 类型确定。
确定文件的 MIME 类型对于确保您的应用程序支持该文件类型非常有用。在文件管理器或小部件等应用程序中,这也很有用,以显示文件的适当 图标,甚至详细视图中的描述性 注释。
要检查文件是否具有期望的 MIME 类型,应使用 inherits() 而不是基于名称的简单字符串比较。这是因为 MIME 类型可以相互继承:例如,C 源文件是纯文本文件的特定类型,因此 text/x-csrc 继承了 text/plain。
另请参阅QMimeDatabase 和 MIME 类型浏览器。
属性文档
[只读]
aliases : const QStringList
此属性包含该 MIME 类型的别名单曲
例如,对于 text/csv,返回的列表将包括:text/x-csv, text/x-comma-separated-values。
请注意,所有 QMimeType 实例都引用了真正的 MIME 类型,从未直接引用别名。
列表中别名的顺序是未定义的。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QStringList | aliases() const |
[只读]
allAncestors : const QStringList
此属性包含直接和间接父 MIME 类型的名称
返回此 MIME 类型的所有父 MIME 类型,直接和间接。这包括其父的父等。
例如,对于 image/svg+xml,列表将为:application/xml, text/plain, application/octet-stream。
请注意,application/octet-stream 是所有类型文件(但不是目录)的最终父类型。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QStringList | allAncestors() const |
[只读]
comment : const QString
此属性包含要在用户界面显示的 MIME 类型的描述
使用默认语言(QLocale().name())选择适当的翻译。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QString | comment() const |
[只读]
filterString : const QString
此属性包含可用于文件对话框的过滤器字符串
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QString | filterString() const |
[只读]
genericIconName : const QString
此属性保存表示 MIME 类型的通用图标的文件名
如果无法在系统中找到 iconName() 返回的图标,应使用此属性。它用于具有相似类型的类别(如电子表格或存档),可以使用一个公共图标。freedesktop.org 图标命名规范列出了这样的图标名称。
可以使用 QIcon::fromTheme() 将图标名称传入以加载图标。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QString | genericIconName() const |
[只读]
globPatterns : const QStringList
此属性保存 glob 匹配模式列表
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QStringList | globPatterns() const |
[只读]
iconName : const QString
此属性保存表示 MIME 类型的图标图像的文件名
可以使用 QIcon::fromTheme() 将图标名称传入以加载图标。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QString | iconName() const |
[只读]
isDefault : const bool
true
如果此 MIME 类型是应用于所有文件的默认 MIME 类型:application/octet-stream。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
bool | isDefault() const |
[只读]
name : const QString
此属性保存 MIME 类型的名称
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QString | name() const |
[只读]
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。这使得可以使用 Perl 脚本,也可以在文本编辑器中打开它们。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QStringList | parentMimeTypes() const |
[只读]
preferredSuffix : const QString
此属性保存 MIME 类型的首选后缀
不包含前导点,例如,对于 application/pdf 返回 "pdf"。返回值可以为空,对于没有关联任何后缀的 MIME 类型。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QString | preferredSuffix() const |
[只读]
suffixes : const QStringList
此属性保存 MIME 类型的已知后缀
不包含前导点,例如,对于 image/jpeg 返回 "jpg"、"jpeg"。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
QStringList | suffixes() const |
[只读]
valid : const bool
true
如果 QMimeType 对象包含有效数据,否则 false
有效的MIME类型有一个非空的名称。无效的MIME类型是默认构造的QMIMEType。
虽然在 5.10 中引入了此属性,但相应的访问器方法一直都有。
访问函数
bool | isValid() const |
成员函数文档
QMimeType::QMIMEType()
构造一个QMIMEType对象,它使用默认属性值,表示无效的MIME类型。
QMimeType::QMIMEType(const QMIMEType &other)
将此QMIMEType对象构造为other的副本。
[noexcept]
QMimeType::~QMIMEType()
销毁QMIMEType对象,并释放d指针。
[可调用]
bool QMimeType::inherits(const QString &mimeTypeName) const
如果此mimetype是mimeTypeName,或者继承自mimeTypeName(见父MIME类型()),或者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。
bool QMimeType::operator!=(const QMIMEType &other) const
如果other不等于此QMIMEType对象,则返回true
,否则返回false
。
QMIMEType &QMIMEType::operator=(const QMIMEType &other)
将other的数据赋给此QMIMEType对象,并返回对此对象的引用。
[noexcept]
QMIMEType &QMIMEType::operator=(QMIMEType &&other)
移动赋值other到此QMIMEType实例。
bool QMimeType::operator==(const QMIMEType &other) const
如果other等于此QMIMEType对象,则返回true
,否则返回false
。名称是mimetype的唯一标识符,因此具有相同名称的两个mimetype是相等的。
© 2024 Qt公司有限。在此包括的文档贡献是各自所有者的版权。提供的文档是在自由软件基金会发布的GNU自由文档许可证版本1.3的条款下授权的。Qt和相应的标志是芬兰及其它国家/地区的The Qt Company Ltd的商标。所有其他商标均为各自所有者的财产。