The QQmlExpression class evaluates JavaScript in a QML context. More...
Header: | #include <QQmlExpression> |
CMake: | find_package(Qt6 COMPONENTS Qml REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Qml) |
qmake: | QT += qml |
Since: | Qt 5.0 |
Inherits: | QObject |
QQmlExpression(const QQmlScriptString &script, QQmlContext *ctxt = nullptr, QObject *scope = nullptr, QObject *parent = nullptr) | |
QQmlExpression(QQmlContext *ctxt, QObject *scope, const QString &expression, QObject *parent = nullptr) | |
QQmlExpression() | |
virtual | ~QQmlExpression() override |
void | clearError() |
int | columnNumber() const |
QQmlContext * | context() const |
QQmlEngine * | engine() const |
QQmlError | error() const |
QVariant | evaluate(bool *valueIsUndefined = nullptr) |
QString | expression() const |
bool | hasError() const |
int | lineNumber() const |
bool | notifyOnValueChanged() const |
QObject * | scopeObject() const |
void | setExpression(const QString &expression) |
void | setNotifyOnValueChanged(bool notifyOnChange) |
void | setSourceLocation(const QString &url, int line, int column = 0) |
QString | sourceFile() const |
void | valueChanged() |
For example, given a file main.qml
like this:
import QtQuick 2.0 Item { width: 200; height: 200 }
The following code evaluates a JavaScript expression in the context of the above 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
Create a QQmlExpression object that is a child of parent.
The script provides the expression to be evaluated, the context to evaluate it in, and the scope object to evaluate it with. If provided, ctxt and scope will override the context and scope object provided by script.
See also QQmlScriptString.
Create a QQmlExpression object that is a child of parent.
The expression JavaScript will be executed in the ctxt QQmlContext. If specified, the scope object's properties will also be in scope during the expression's execution.
Create an invalid QQmlExpression.
As the expression will not have an associated QQmlContext, this will be a null expression object and its value will always be an invalid QVariant.
[signal]
void QQmlExpression::valueChanged()
Emitted each time the expression value changes from the last time it was evaluated. The expression must have been evaluated at least once (by calling QQmlExpression::evaluate()) before this signal will be emitted.
[override virtual]
QQmlExpression::~QQmlExpression()
Destroy the QQmlExpression instance.
Clear any expression errors. Calls to hasError() following this will return false.
See also hasError() and error().
Returns the source file column number for this expression. The source location must have been previously set by calling setSourceLocation().
Returns the QQmlContext this expression is associated with, or nullptr
if there is no association or the QQmlContext has been destroyed.
Returns the QQmlEngine this expression is associated with, or nullptr
if there is no association or the QQmlEngine has been destroyed.
Return any error from the last call to evaluate(). If there was no error, this returns an invalid QQmlError instance.
See also hasError() and clearError().
Evaulates the expression, returning the result of the evaluation, or an invalid QVariant if the expression is invalid or has an error.
valueIsUndefined is set to true if the expression resulted in an undefined value.
See also hasError() and error().
Returns the expression string.
See also setExpression().
Returns true if the last call to evaluate() resulted in an error, otherwise false.
See also error() and clearError().
Returns the source file line number for this expression. The source location must have been previously set by calling setSourceLocation().
Returns true if the valueChanged() signal is emitted when the expression's evaluated value changes.
See also setNotifyOnValueChanged().
Returns the expression's scope object, if provided, otherwise 0.
In addition to data provided by the expression's QQmlContext, the scope object's properties are also in scope during the expression's evaluation.
Set the expression to expression.
See also expression().
Sets whether the valueChanged() signal is emitted when the expression's evaluated value changes.
If notifyOnChange is true, the QQmlExpression will monitor properties involved in the expression's evaluation, and emit QQmlExpression::valueChanged() if they have changed. This allows an application to ensure that any value associated with the result of the expression remains up to date.
If notifyOnChange is false (default), the QQmlExpression will not montitor properties involved in the expression's evaluation, and QQmlExpression::valueChanged() will never be emitted. This is more efficient if an application wants a "one off" evaluation of the expression.
See also notifyOnValueChanged().
Set the location of this expression to line and column of url. This information is used by the script engine.
Returns the source file URL for this expression. The source location must have been previously set by calling setSourceLocation().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qqmlexpression.html