Класс QQmlExpression

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

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

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

Сигналы

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

Например, имея файл 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.

[signal] void QQmlExpression::valueChanged()

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

[override virtual] QQmlExpression::~QQmlExpression()

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

void QQmlExpression::clearError()

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

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

int QQmlExpression::columnNumber() const

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

QQmlContext *QQmlExpression::context() const

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

QQmlEngine *QQmlExpression::engine() const

Возвращает QQmlEngine, с которым связано это выражение, или nullptr если нет связи или 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().