class QMetaEnum#

《a class="reference internal" href="#PySide6.QtCore.QMetaEnum" title="PySide6.QtCore.QMetaEnum">QMetaEnum类的》类提供了枚举器的元数据。《a class="reference internal" href="#more">更多信息…

摘要#

方法#

注意

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

详细说明#

使用 name() 获取枚举器的名称。枚举器的键（每个枚举项的名称）由 key() 返回；使用 keyCount() 查找键的数量。如果枚举器用作标志，则 isFlag() 返回 True，这意味着其值可以使用 OR 运算符组合。

转换函数 keyToValue()、valueToKey()、keysToValue() 和 valueToKeys() 可以在枚举或集合值的整数表示和文字表示之间进行转换。函数 scope() 返回声明此枚举器的类作用域。

__init__()#
enumName()#
返回类型:

str

返回标志的枚举名称（不带作用域）。

例如，AlignmentFlag 标志的枚举名称为 AlignmentFlag，但类型名称为 Alignment。非标志枚举有相同的项目名称和枚举名称。

枚举名称和类型名称具有相同的范围。

另请参阅

isValid() name()

isFlag()#
返回类型:

bool

如果此枚举器用作标志，则返回 true；否则返回 false。

用作标志时，枚举器可以使用 OR 运算符进行组合。

isScoped()#
返回类型:

bool

如果此枚举器定义为 C++11 枚举类，则返回 true；否则返回 false。

isValid()#
返回类型:

bool

如果此枚举有效（有名称），则返回 true；否则返回 false。

另请参阅

name()

key(index)#
参数：

index – int

返回类型:

str

返回具有给定 index 的密钥，如果不存在此类密钥，则返回 None。

keyCount()#
返回类型:

int

返回键的数量。

另请参阅

key()

keyToValue(key)#
参数：

key – str

返回类型:

PyTuple

返回给定枚举 key 的整数值，如果 key 未定义，则返回 -1。

如果 key 未定义，则 *``ok`` 设置为 false；否则 *``ok`` 设置为 true。

对于标志类型，请使用keysToValue()函数。

另请参阅

valueToKey()isFlag()keysToValue()

keysToValue(keys)#
参数：

keys – 字符串

返回类型:

PyTuple

返回通过使用OR运算符组合keys中的值的值，如果keys未定义，则返回-1。注意，keys中的字符串必须用“|”分隔。

如果keys未定义，则将*``ok``设置为false；否则将*``ok``设置为true。

另请参阅

isFlag()valueToKey()valueToKeys()

metaType()#
返回类型:

QMetaType

返回枚举的元类型。

如果此枚举所属的QMetaObject是用Qt 6.5或更早版本生成的，这将是一个无效的元类型。

注意

这是枚举自身的元类型，而不是其基础整数类型的元类型。您可以使用underlyingType()检索枚举基础类型的元类型。

name()#
返回类型:

str

返回类型的名称（不包括作用域）。

例如，Key枚举的类型名称是Key，作用域是Qt。

对于标志，返回标志类型的名称，而不是枚举类型的名称。

另请参阅

isValid()scope()enumName()

scope()#
返回类型:

str

返回枚举声明的作用域。

例如，AlignmentFlag 枚举的作用域为 Qt，名称为 AlignmentFlag。

另请参阅

name()

value(index)#
参数：

index – int

返回类型:

int

返回具有给定索引的值；如果不存在这样的值，则返回 -1。

valueToKey(value)#
参数：

value – int

返回类型:

str

返回用作给定枚举 value 名称的字符串，如果 value 未定义，则返回 None。

对于标志类型，请使用 valueToKeys()。

另请参阅

isFlag() valueToKeys()

valueToKeys(value)#
参数：

value – int

返回类型:

QByteArray

返回表示给定 value 的键的以 | 分隔的字节数组。