Класс QMetaEnum

Класс QMetaEnum предоставляет метаданные об перечислении. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Статические открытые члены

Подробное описание

Используйте name() для имени перечисления. Ключи перечисления (имена каждого элемента перечисления) возвращаются функцией key(); используйте keyCount() для получения количества ключей. isFlag() возвращает значение true, если перечисление предназначено для использования как флаг, что означает, что его значения можно комбинировать с помощью оператора ИЛИ.

Функции преобразования keyToValue(), valueToKey(), keysToValue() и valueToKeys() позволяют преобразовывать между целочисленным представлением значения перечисления или набора значений и его буквенным представлением. Функция scope() возвращает область видимости класса, в котором было объявлено это перечисление.

См. также QMetaObject, QMetaMethod и QMetaProperty.

Документация по функциям-членам

const char *QMetaEnum::enumName() const

Возвращает имя перечисления флага (без области видимости).

Например, флаг Qt::AlignmentFlag имеет AlignmentFlag в качестве имени перечисления, но Alignment в качестве имени типа. Для перечислений, не являющихся флагами, имена типа и перечисления одинаковы.

Имена перечислений имеют ту же область видимости, что и имена типов.

Эта функция была добавлена в Qt 5.12.

См. также isValid() и name().

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

Возвращает QMetaEnum, соответствующий типу в параметре шаблона. Перечисление должно быть объявлено с помощью Q_ENUM.

Эта функция была добавлена в Qt 5.5.

bool QMetaEnum::isFlag() const

Возвращает true true, если это перечисление используется как флаг, в противном случае возвращает false.

При использовании в качестве флагов перечисления могут быть объединены с помощью оператора ИЛИ.

См. также keysToValue() и valueToKeys().

bool QMetaEnum::isScoped() const

Возвращает true true, если это перечисление объявлено как C++11 enum class; в противном случае возвращает false.

Эта функция была добавлена в Qt 5.8.

bool QMetaEnum::isValid() const

Возвращает true true, если это перечисление валидно (имеет имя); в противном случае возвращает false.

См. также name().

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

Возвращает ключ с заданным индексом или nullptr nullptr, если такого ключа не существует.

См. также keyCount(), value() и valueToKey().

int QMetaEnum::keyCount() const

Возвращает количество ключей.

См. также key().

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

Возвращает целое значение заданного ключа перечисления или -1, если ключ не определён.

Если ключ не определён, *ok устанавливается в false; в противном случае *ok устанавливается в true.

Для типов флагов используйте keysToValue().

См. также valueToKey(), isFlag() и keysToValue().

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

Возвращает значение, полученное путём объединения значений ключей keys с помощью оператора ИЛИ, или -1, если keys не определён. Обратите внимание, что строки в keys должны быть разделены символом '|'.

Если keys не определён, *ok устанавливается в false; в противном случае *ok устанавливается в true.

См. также isFlag(), valueToKey() и valueToKeys().

const char *QMetaEnum::name() const

Возвращает имя типа (без области видимости).

Например, у перечисления Qt::Key есть Key как имя типа и Qt как область видимости.

Для флагов это возвращает имя типа флага, а не имя типа перечисления.

См. также isValid(), scope() и enumName().

const char *QMetaEnum::scope() const

Возвращает область видимости, в которой было объявлено это перечисление.

Например, перечисление Qt::AlignmentFlag имеет Qt в качестве области видимости и AlignmentFlag в качестве имени.

См. также name().

int QMetaEnum::value(int index) const

Возвращает значение с заданным индексом; или возвращает -1, если такого значения нет.

См. также keyCount(), key() и keyToValue().

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

Возвращает строку, используемую в качестве имени заданного значения перечисления value, или nullptr, если value не определено.

Для типов флагов используйте valueToKeys().

См. также isFlag() и valueToKeys().

QByteArray QMetaEnum::valueToKeys(int value) const

Возвращает массив байтов с разделенными символом '|' ключами, представляющими заданное значение value.

См. также isFlag(), valueToKey() и keysToValue().