class QMimeType

QMimeType类描述了由MIME类型字符串表示的文件或数据类型。 更多...

概述

属性

• aliasesᅟ - 该MIME类型的别名单

• allAncestorsᅟ - 直接和间接父MIME类型的名称

• commentᅟ - 供用户界面显示的MIME类型描述

• filterStringᅟ - 可用于文件对话框的筛选字符串

• genericIconNameᅟ - 表示MIME类型的通用图标的文件名

• globPatternsᅟ - 匹配模式列表

• iconNameᅟ - 表示MIME类型的图标图像的文件名

• isDefault 状态 - 如果此 MIME 类型是该应用对所有文件生效的默认 MIME 类型：application/octet-stream，则为 True

• name 名称 - MIME 类型的名称

• parentMimeTypes 父 MIME 类型名称 - 父 MIME 类型的名称

• preferredSuffix 缺省后缀 - MIME 类型的首选后缀

• suffixes 已知后缀 - MIME 类型的已知后缀

• valid 是否有效 - 如果 QMimeType 对象包含有效数据，则为 True，否则为 false

方法

• def __init__()

• def aliases()

• def allAncestors()

• def comment()

• def filterString()

• def genericIconName()

• def globPatterns()

• def iconName()

• def inherits()

• def isDefault()

• def isValid()

• def name()

• def __ne__()

• def __eq__()

• def parentMimeTypes()

• def preferredSuffix()

• 定义suffixes()

• 定义swap()

备注

此文档可能包含从C++自动转换到Python的代码片段。我们始终欢迎对代码片段进行翻译的贡献。如果您发现翻译存在问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建工单来让我们知道。

详细说明

例如，一个名为“readme.txt”的文件具有MIME类型“text/plain”。MIME类型可以从文件名、文件内容或两者共同确定。MIME类型的确定也可以作用于非文件来源的数据缓冲区。

确定文件的MIME类型对于确保您的应用程序支持它很有用。在类似文件管理器或小部件的应用程序中，这也很有用，以便显示合适的icon 或在详细视图中的描述性 comment 。

要检查文件是否具有预期的MIME类型，应使用 inherits() 而不是基于 name() 的简单字符串比较。这是因为MIME类型可以继承自其他类型：例如，C源文件是普通文本文件的一种特定类型，因此text/x-csrc继承了text/plain。

另请参阅

QMimeDatabase MIME类型浏览器

备注

当使用 from __feature__ import true_property 时可以直接使用属性，否则通过访问函数。

属性 aliases: 字符串列表

此属性包含本.mime类型别名列表。

例如，对于text/csv，返回的列表将是：text/x-csv, text/x-comma-separated-values。

请注意，所有 QMimeType 实例都引用正确的mime类型，而不是直接引用别名。

列表中别名排序未定义。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• aliases()

属性 allAncestors: 字符串列表

此属性包含直接和间接父MIME类型的名称。

返回此MIME类型的所有直接和间接父MIME类型。这包括其父类型的父类型等。

例如，对于image/svg+xml，列表将是：application/xml, text/plain, application/octet-stream。

请注意，application/octet-stream是所有类型文件（但不是目录）的终极父类型。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• allAncestors()

属性 描述: str

该属性保存要在用户界面上显示的 MIME 类型的描述。

默认语言（QLocale(). name()）用于选择合适的翻译。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• comment()

属性 过滤器字符串: str

该属性保存用于文件对话框的可用的过滤器字符串。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• filterString()

属性 通用图标名称: str

该属性保存代表 MIME 类型的通用图标的文件名。

如果系统无法找到 iconName() 返回的图标，则应使用它。它用于可以使用公共图标的类似类型的类别（如电子表格或归档）。 freedesktop.org 图标命名规范列出了一组此类图标名称。

可以将图标名称提供给 QIcon::fromTheme() 来加载图标。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• genericIconName()

属性 glob 模式: strings list

该属性保存 glob 匹配模式的列表。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• globPatterns()

属性 图标名称: str

该属性保存代表 MIME 类型的图标图像的文件名。

可以将图标名称提供给 QIcon::fromTheme() 来加载图标。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• iconName()

属性 是否默认: bool

如果此 MIME 类型是应用于所有文件的默认 MIME 类型 application/octet-stream，则该属性保留 true。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• isDefault()

属性 名称: str

该属性保存 MIME 类型的名称。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• name()

属性 父 MIME 类型: strings list

该属性保存父 MIME 类型的名称。

如果一个类型的实例也是另一个类型的实例，那么这个类型就是另一个类型的子类型。例如，所有的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。这使得既可以执行perl脚本，也可以在文本编辑器中打开它们。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• parentMimeTypes()

property preferredSuffixᅟ: str

此属性保存MIME类型的首选后缀。

不包含前置的点，所以例如这会返回“pdf”对于application/pdf。返回值可以为空，对于没有关联任何后缀的MIME类型。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• preferredSuffix()

property suffixesᅟ: list of strings

此属性保存已知MIME类型的后缀。

不包含前置的点，所以例如这会返回“jpg”，“jpeg”对于image/jpeg。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• suffixes()

property validᅟ: bool

此属性保存true，如果QMimeType对象包含有效数据，否则为false。

有效的MIME类型有一个非空的name()方法。无效的MIME类型是默认构造的QMimeType。

虽然此属性在5.10版中引入，但相应的访问方法始终存在。

访问函数

• isValid()

__init__(other)

参数：

other – QMimeType

将此QMIMEType对象作为other的副本构造。

__init__()

将此QMIMEType对象构造为具有默认属性值，表示无效的MIME类型。

aliases()

返回类型：

字符串列表

属性aliasesᅟ的获取器。

allAncestors()

返回类型：

字符串列表

获取属性 allAncestors .

comment()

返回类型：

str

获取属性 comment .

filterString()

返回类型：

str

获取属性 filterString .

genericIconName()

返回类型：

str

获取属性 genericIconName .

globPatterns()

返回类型：

字符串列表

获取属性 globPatterns .

iconName()

返回类型：

str

获取属性 iconName .

inherits(mimeTypeName)

参数：

mimeTypeName - str

返回类型：

bool

如果此mimeType是mimeTypeName，或者继承自mimeTypeName（参见parentMimeTypes()），或者mimeTypeName是此mimeType的别名，则返回true。

此方法自5.10版本起可从QML中调用。

isDefault()

返回类型：

bool

获取属性 isDefault .

isValid()

返回类型：

bool

获取属性 valid .

name()

返回类型：

str

获取属性 name .

__ne__(other)

参数：

other – QMimeType

返回类型：

bool

如果 other 不等于此 QMimeType 对象，则返回 true，否则返回 false。

__eq__(other)

参数：

other – QMimeType

返回类型：

bool

如果 other 等于此 QMimeType 对象，则返回 true，否则返回 false。名称是 mimetypes 的唯一标识符，所以具有相同名称的两个 mimetypes 是相等的。

parentMimeTypes()

返回类型：

字符串列表

属性 parentMimeTypesᅟ 的获取器。

preferredSuffix()

返回类型：

str

属性 preferredSuffixᅟ 的获取器。

suffixes()

返回类型：

字符串列表

属性 suffixesᅟ 的获取器。

swap(other)

参数：

other – QMimeType

交换 QMimeType 对象 other 和此 QMimeType 对象。

此操作非常快且从未失败。

swap() 方法有助于以异常安全的方式实现赋值运算符。有关更多信息，请参阅 More C++ Idioms - Copy-and-swap 。