Класс QQmlExpression

Класс QQmlExpression вычисляет JavaScript в контексте QML. Подробнее...

Этот класс был представлен в Qt 5.0.

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

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

Сигналы

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

Например, заданный файл main.qml выглядит так:

import QtQuick 2.0

Item {
    width: 200; height: 200
}

Следующий код вычисляет выражение JavaScript в контексте вышеуказанного QML:

QQmlEngine *engine = new QQmlEngine;
QQmlComponent component(engine, QUrl::fromLocalFile("main.qml"));

QObject *myObject = component.create();
QQmlExpression *expr = new QQmlExpression(engine->rootContext(), myObject, "width * 2");
int result = expr->evaluate().toInt();  // result = 400

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

QQmlExpression::QQmlExpression(const QQmlScriptString &script, QQmlContext *ctxt = nullptr, QObject *scope = nullptr, QObject *parent = nullptr)

Создает объект QQmlExpression, который является дочерним элементом parent.

script предоставляет выражение для вычисления, контекст для вычисления и объект области видимости для вычисления. Если указаны, ctxt и scope переопределят контекст и объект области видимости, указанные в script.

См. также QQmlScriptString.

QQmlExpression::QQmlExpression(QQmlContext *ctxt, QObject *scope, const QString &expression, QObject *parent = nullptr)

Создает объект QQmlExpression, который является дочерним элементом parent.

JavaScript-выражение expression будет выполнено в QQmlContext ctxt. Если указан, свойства объекта scope также будут в области видимости во время выполнения выражения.

QQmlExpression::QQmlExpression()

Создает недействительный QQmlExpression.

Поскольку у выражения не будет связанного QQmlContext, это будет пустой объект выражения, и его значение всегда будет недействительным QVariant.

void QQmlExpression::valueChanged()

Выдаётся каждый раз, когда значение выражения изменяется с момента последнего вычисления. Выражение должно быть вычислено хотя бы один раз (вызовом QQmlExpression::evaluate()), прежде чем этот сигнал будет испущен.

QQmlExpression::~QQmlExpression()

Уничтожает экземпляр QQmlExpression.

void QQmlExpression::clearError()

Очищает любые ошибки выражения. Вызовы hasError() после этого вернут false.

См. также hasError() и error().

int QQmlExpression::columnNumber() const

Возвращает номер столбца файла исходного кода для этого выражения. Местоположение исходного кода должно быть установлено ранее вызовом setSourceLocation().

QQmlContext *QQmlExpression::context() const

Возвращает QQmlContext, с которым связано это выражение, или 0, если нет связи или QQmlContext был уничтожен.

QQmlEngine *QQmlExpression::engine() const

Возвращает QQmlEngine, связанный с этим выражением, или 0, если нет связи или QQmlEngine был уничтожен.

QQmlError QQmlExpression::error() const

Возвращает любую ошибку из последнего вызова evaluate(). Если ошибок не было, возвращается недействительный экземпляр QQmlError.

См. также hasError() и clearError().

QVariant QQmlExpression::evaluate(bool *valueIsUndefined = nullptr)

Вычисляет выражение, возвращая результат вычисления или недействительный QVariant, если выражение недействительно или содержит ошибку.

valueIsUndefined устанавливается в true, если выражение привело к неопределенному значению.

См. также hasError() и error().

QString QQmlExpression::expression() const

Возвращает строку выражения.

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

bool QQmlExpression::hasError() const

Возвращает true, если последний вызов evaluate() привёл к ошибке, в противном случае false.

См. также error() и clearError().

int QQmlExpression::lineNumber() const

Возвращает номер строки файла исходного кода для этого выражения. Местоположение исходного кода должно быть установлено ранее вызовом setSourceLocation().

bool QQmlExpression::notifyOnValueChanged() const

Возвращает true, если сигнал valueChanged() испускается при изменении вычисленного значения выражения.

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

QObject *QQmlExpression::scopeObject() const

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

Помимо данных, предоставляемых объектом QQmlContext выражения, свойства объекта области видимости также доступны во время вычисления выражения.

void QQmlExpression::setExpression(const QString &expression)

Устанавливает выражение в expression.

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

void QQmlExpression::setNotifyOnValueChanged(bool notifyOnChange)

Устанавливает, должно ли излучаться событие valueChanged(), когда значение, вычисленное по выражению, изменяется.

Если notifyOnChange имеет значение true, QQmlExpression будет отслеживать свойства, вовлечённые в вычисление выражения, и излучать QQmlExpression::valueChanged(), если они изменятся. Это позволяет приложению убедиться, что любое значение, связанное с результатом выражения, остаётся актуальным.

Если notifyOnChange имеет значение false (по умолчанию), QQmlExpression не будет отслеживать свойства, вовлечённые в вычисление выражения, и QQmlExpression::valueChanged() никогда не будет излучено. Это более эффективно, если приложение хочет однократное вычисление выражения.

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

void QQmlExpression::setSourceLocation(const QString &url, int line, int column = 0)

Устанавливает расположение этого выражения в строке line и столбце column файла url. Эта информация используется движком сценариев.

QString QQmlExpression::sourceFile() const

Возвращает URL файла исходного кода для этого выражения. Расположение исходного кода должно быть установлено ранее вызовом setSourceLocation().