QMetaEnum Class

enum AppleType {
    Big,
    Small
};
Q_ENUM(AppleType)

QMetaEnum metaEnum = QMetaEnum::fromType<ModelApple::AppleType>();
qDebug() << metaEnum.valueToKey(ModelApple::Big);

Dokumentation zu den Member-Funktionen

const char *QMetaEnum::enumName() const

Gibt den Enum-Namen des Flags zurück (ohne den Geltungsbereich).

Beispielsweise hat das Flag „ Qt::AlignmentFlag “ den Enum-Namen „ AlignmentFlag “, während der Typname „ Alignment “ lautet. Enums, die keine Flags sind, haben denselben Typ- und Enum-Namen.

Enum-Namen haben denselben Geltungsbereich wie der Typname.

Siehe auch „ isValid()“ und „ name()“.

[static] template <typename T> QMetaEnum QMetaEnum::fromType()

Gibt die „ QMetaEnum “ zurück, die dem Typ im Vorlagenparameter entspricht. Die Enumeration muss mit „ Q_ENUM “ deklariert werden.

[since 6.9] bool QMetaEnum::is64Bit() const

Gibt „ true “ zurück, wenn der zugrunde liegende Typ dieser Aufzählung 64 Bit breit ist.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch ` value64()`.

bool QMetaEnum::isFlag() const

Gibt „ true “ zurück, wenn dieser Enumerator als Flag verwendet wird; andernfalls wird „false“ zurückgegeben.

Bei Verwendung als Flags können Enumeratoren mit dem OR-Operator kombiniert werden.

Siehe auch „ keysToValue()“ und „ valueToKeys()“.

bool QMetaEnum::isScoped() const

Gibt „ true “ zurück, wenn dieser Enumerator als C++11-Enum-Klasse deklariert ist; andernfalls wird „false“ zurückgegeben.

bool QMetaEnum::isValid() const

Gibt „ true “ zurück, wenn diese Enumeration gültig ist (einen Namen hat); andernfalls wird „false“ zurückgegeben.

Siehe auch name().

const char *QMetaEnum::key(int index) const

Gibt den Schlüssel mit dem angegebenen index zurück oder nullptr, falls kein solcher Schlüssel existiert.

Siehe auch keyCount(), value() und valueToKey().

int QMetaEnum::keyCount() const

Gibt die Anzahl der Schlüssel zurück.

Siehe auch „ key()“.

[since 6.9] std::optional<quint64> QMetaEnum::keyToValue64(const char *key) const

Gibt den ganzzahligen Wert der angegebenen Aufzählung „ key “ zurück oder „ std::nullopt “, falls „ key “ nicht definiert ist.

Verwenden Sie für Flag-Typen keysToValue64().

Diese Funktion erweitert den Wert von 32-Bit-Enumerationen immer auf 64 Bit, wenn ihr zugrunde liegender Typ vorzeichenbehaftet ist (z. B. ` int`, ` short`). In den meisten Fällen entspricht dies dem erwarteten Verhalten.

Eine bemerkenswerte Ausnahme bilden Flag-Werte, bei denen Bit 31 gesetzt ist, wie z. B. 0x8000'0000, da einige Compiler (wie Microsoft Visual Studio) nicht automatisch auf einen vorzeichenlosen zugrunde liegenden Typ umschalten. Um dieses Problem zu vermeiden, geben Sie den zugrunde liegenden Typ in der Deklaration von enum explizit an.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch ` valueToKey()`, ` isFlag()` und ` keysToValue64()`.

int QMetaEnum::keyToValue(const char *key, bool *ok = nullptr) const

Gibt den ganzzahligen Wert der angegebenen Enumeration „ key “ zurück oder -1, wenn „ key “ nicht definiert ist.

Ist key nicht definiert, wird *ok auf „false“ gesetzt; andernfalls wird *ok auf „true“ gesetzt.

Verwenden Sie für Flag-Typen die Funktion „ keysToValue()“.

Handelt es sich um eine 64-Bit-Enumeration (siehe is64Bit()), gibt diese Funktion die unteren 32 Bit des Werts zurück. Verwenden Sie stattdessen keyToValue64(), um den vollständigen Wert zu erhalten.

Siehe auch „ keyToValue64“ , „ valueToKey()“, „ isFlag()“, „ keysToValue()“ und „ is64Bit()“.

std::optional<quint64> QMetaEnum::keysToValue64(const char *keys) const

Gibt den Wert zurück, der sich aus der Verknüpfung der Werte von „ keys “ mit dem OR-Operator ergibt, oder „ std::nullopt “, falls „ keys “ nicht definiert ist. Beachten Sie, dass die Zeichenfolgen in „ keys “ durch „|“ getrennt sein müssen.

Diese Funktion erweitert den Wert von 32-Bit-Enumerationen stets auf 64 Bit, wenn ihr zugrunde liegender Typ vorzeichenbehaftet ist (z. B. ` int`, ` short`). In den meisten Fällen entspricht dies dem erwarteten Verhalten.

Eine bemerkenswerte Ausnahme bilden Flag-Werte, bei denen Bit 31 gesetzt ist, wie z. B. 0x8000'0000, da einige Compiler (wie Microsoft Visual Studio) nicht automatisch auf einen vorzeichenlosen zugrunde liegenden Typ umschalten. Um dieses Problem zu vermeiden, geben Sie den zugrunde liegenden Typ in der Deklaration von ` enum ` explizit an.

Siehe auch ` isFlag()`, ` valueToKey()` und ` valueToKeys()`.

int QMetaEnum::keysToValue(const char *keys, bool *ok = nullptr) const

Gibt den Wert zurück, der sich aus der Verknüpfung der Werte von „ keys “ mit dem OR-Operator ergibt, oder -1, wenn „ keys “ nicht definiert ist. Beachten Sie, dass die Zeichenfolgen in „ keys “ durch „|“ getrennt sein müssen.

Ist „ keys “ nicht definiert, wird * „ok “ auf „false“ gesetzt; andernfalls wird * „ok “ auf „true“ gesetzt.

Handelt es sich um eine 64-Bit-Enumeration (siehe is64Bit()), gibt diese Funktion die unteren 32 Bit des Werts zurück. Verwenden Sie stattdessen keyToValue64(), um den vollständigen Wert zu erhalten.

Siehe auch keysToValue64(), isFlag(), valueToKey(), valueToKeys() und is64Bit().

[since 6.6] QMetaType QMetaEnum::metaType() const

Gibt den Metatyp der Enumeration zurück.

Wenn die „ QMetaObject “, zu der diese Enumeration gehört, mit Qt 6.5 oder früher generiert wurde, handelt es sich hierbei um einen ungültigen Metatyp.

Diese Funktion wurde in Qt 6.6 eingeführt.

const char *QMetaEnum::name() const

Gibt den Namen des Typs (ohne den Gültigkeitsbereich) zurück.

Beispielsweise hat die Aufzählung „ Qt::Key “ den Typnamen „ Key “ und den Gültigkeitsbereich „ Qt “.

Bei Flags gibt diese Funktion den Namen des Flag-Typs zurück, nicht den Namen des Enum-Typs.

Siehe auch „ isValid()“, „ scope()“ und „ enumName()“.

const char *QMetaEnum::scope() const

Gibt den Geltungsbereich zurück, in dem dieser Enumerator deklariert wurde.

Beispielsweise hat die Aufzählung „ Qt::AlignmentFlag “ den Gültigkeitsbereich „ Qt “ und den Namen „ AlignmentFlag “.

Siehe auch „ name()“.

[since 6.9] std::optional<quint64> QMetaEnum::value64(int index) const

Gibt den Wert mit dem angegebenen index zurück, sofern dieser existiert; andernfalls wird ein std::nullopt zurückgegeben.

Diese Funktion erweitert den Wert von 32-Bit-Enumerationen immer auf 64 Bit, wenn ihr zugrunde liegender Typ vorzeichenbehaftet ist (z. B. ` int`, ` short`). In den meisten Fällen entspricht dies dem erwarteten Verhalten.

Eine bemerkenswerte Ausnahme bilden Flag-Werte, bei denen Bit 31 gesetzt ist, wie z. B. 0x8000'0000, da einige Compiler (wie Microsoft Visual Studio) nicht automatisch auf einen vorzeichenlosen zugrunde liegenden Typ umschalten. Um dieses Problem zu vermeiden, geben Sie den zugrunde liegenden Typ in der Deklaration von ` enum ` explizit an.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch ` keyCount()`, ` key()`, ` keyToValue()` und ` is64Bit()`.

int QMetaEnum::value(int index) const

Gibt den Wert mit der angegebenen index zurück; andernfalls wird -1 zurückgegeben, wenn kein solcher Wert vorhanden ist.

Handelt es sich um eine Aufzählung mit einem zugrunde liegenden 64-Bit-Typ (siehe is64Bit()), gibt diese Funktion die unteren 32 Bit des Werts zurück. Verwenden Sie stattdessen value64(), um den vollständigen Wert zu erhalten.

Siehe auch value64(), keyCount(), key() und keyToValue().

const char *QMetaEnum::valueToKey(quint64 value) const

Gibt die Zeichenfolge zurück, die als Name der angegebenen Aufzählung verwendet wird: value oder nullptr, falls value nicht definiert ist.

Verwenden Sie für Flag-Typen valueToKeys().

Siehe auch isFlag() und valueToKeys().

QByteArray QMetaEnum::valueToKeys(quint64 value) const

Gibt ein Byte-Array mit durch „|“ getrennten Schlüsseln zurück, das die angegebene „ value “ darstellt.

Siehe auch „ isFlag()“, „ valueToKey()“ und „ keysToValue()“.