Класс QQmlExpression

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

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

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

• 32 открытые функции унаследованные от QObject

Сигналы

• 2 сигнала унаследованных от QObject

Дополнительные унаследованные члены

• 1 свойство унаследованное от QObject
• 1 открытый слот унаследованный от QObject
• 11 статические открытые члены унаследованные от QObject
• 9 защищенные функции унаследованные от QObject

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

Класс 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

Обратите внимание, что версия Qt Quick 1 называется QDeclarativeExpression.

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

QQmlExpression::QQmlExpression()

Создаёт невалидное выражение QQmlExpression.

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

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

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

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

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

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

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

См. также QQmlScriptString.

[virtual] 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 = Q_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().

[signal] void QQmlExpression::valueChanged()

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