PySide6.QtCore.QMimeType¶

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类型的名称

• 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()

• def suffixes()

• def swap()

注意

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

详细描述¶

例如，一个名为“readme.txt”的文件具有MIME类型“text/plain”。MIME类型可以从文件名、文件内容或两者中确定。MIME类型的确定也可以在不来自文件的数据缓冲区上进行。

确定文件的MIME类型可以确保您的应用程序支持它。这在类似文件管理器的应用程序或小部件中也很有用，以便为文件显示适当的图标，甚至在详细视图中显示描述性的注释。

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

另请参阅

QMimeDatabase MIME 类型浏览器

注意

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

property aliasesᅟ: list of strings¶

此属性保存此MIME类型的别名列表。

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

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

列表中别名的顺序是未定义的。

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• aliases()

property allAncestorsᅟ: list of strings¶

此属性保存直接和间接父MIME类型的名称。

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

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

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

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• allAncestors()

property commentᅟ: str¶

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

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

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• comment()

property filterStringᅟ: str¶

此属性包含可用于文件对话框的过滤器字符串。

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• filterString()

property genericIconNameᅟ: str¶

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

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

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

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• genericIconName()

property globPatternsᅟ: list of strings¶

此属性包含全局匹配模式的列表。

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• globPatterns()

property iconNameᅟ: str¶

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

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

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• iconName()

property isDefaultᅟ: bool¶

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

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• isDefault()

property nameᅟ: str¶

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

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• name()

property parentMimeTypesᅟ: list of strings¶

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

如果一个类型的任何实例也是另一个类型的实例，则该类型是另一个类型的子类。例如，所有image/svg+xml文件也是text/xml、text/plain和application/octet-stream文件。子类化是关于格式的，而不是数据的类别（例如，没有所有电子表格都继承的“通用电子表格”类）。相反，image/svg+xml的父mimetype是text/xml。

一个MIME类型可以有多个父类型。例如，application/x-perl有两个父类型：application/x-executable和text/plain。这使得既可以执行perl脚本，也可以在文本编辑器中打开它们。

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• parentMimeTypes()

property preferredSuffixᅟ: str¶

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

不包括前导点，因此例如对于application/pdf，这将返回“pdf”。返回值可以为空，适用于没有任何关联后缀的MIME类型。

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• preferredSuffix()

property suffixesᅟ: list of strings¶

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

不包括前导点，因此例如对于image/jpeg，这将返回“jpg”，“jpeg”。

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• suffixes()

property validᅟ: bool¶

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

有效的MIME类型具有非空的name()。无效的MIME类型是默认构造的QMimeType。

虽然这个属性是在5.10版本中引入的，但相应的访问器方法一直存在。

Access functions:

• isValid()

__init__()¶

构造此QMimeType对象，并使用指示无效MIME类型的默认属性值进行初始化。

__init__(other)

Parameters:

其他 – QMimeType

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

aliases()¶

Return type:

字符串列表

属性 aliasesᅟ 的获取器。

allAncestors()¶

Return type:

字符串列表

属性 allAncestorsᅟ 的获取器。

comment()¶

Return type:

字符串

属性 commentᅟ 的获取器。

filterString()¶

Return type:

字符串

属性 filterStringᅟ 的获取器。

genericIconName()¶

Return type:

字符串

属性 genericIconNameᅟ 的获取器。

globPatterns()¶

Return type:

字符串列表

属性 globPatternsᅟ 的获取器。

iconName()¶

Return type:

字符串

属性 iconNameᅟ 的获取器。

inherits(mimeTypeName)¶

Parameters:

mimeTypeName – str

Return type:

布尔

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

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

isDefault()¶

Return type:

布尔

属性 isDefaultᅟ 的获取器。

isValid()¶

Return type:

布尔

属性 validᅟ 的获取器。

name()¶

Return type:

字符串

获取属性 nameᅟ 的Getter。

__ne__(rhs)¶

Parameters:

rhs – QMimeType

Return type:

布尔

如果 QMimeType lhs 不等于 QMimeType rhs，则返回 true，否则返回 false。

__eq__(rhs)¶

Parameters:

rhs – QMimeType

Return type:

布尔

如果 lhs 等于 rhs QMimeType 对象，则返回 true，否则返回 false。名称是 mimetype 的唯一标识符，因此具有相同名称的两个 mimetype 是相等的。

parentMimeTypes()¶

Return type:

字符串列表

属性 parentMimeTypesᅟ 的获取器。

preferredSuffix()¶

Return type:

字符串

属性 preferredSuffixᅟ 的获取器。

suffixes()¶

Return type:

字符串列表

属性 suffixesᅟ 的获取器。

swap(other)¶

Parameters:

其他 – QMimeType

将此QMimeType对象与other交换。

此操作非常快速且永远不会失败。

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