Класс QMetaEnum

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

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

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

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

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

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

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

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

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

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

[static] QMetaEnum QMetaEnum::fromType()

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

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

bool QMetaEnum::isFlag() const

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

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

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

bool QMetaEnum::isValid() const

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

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

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

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

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

int QMetaEnum::keyCount() const

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

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

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

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

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

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

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

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

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

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

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

const char *QMetaEnum::name() const

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

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

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

const char *QMetaEnum::scope() const

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

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

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

int QMetaEnum::value(int index) const

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

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

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

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

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

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

QByteArray QMetaEnum::valueToKeys(int value) const

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

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