QQmlExpression Class
La clase QQmlExpression evalúa código JavaScript en un contexto QML. Más información...
| Encabezado: | #include <QQmlExpression> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Qml) target_link_libraries(mytarget PRIVATE Qt6::Qml) |
| qmake: | QT += qml |
| Heredado de: | QObject |
Funciones públicas
| QQmlExpression() | |
| QQmlExpression(QQmlContext *ctxt, QObject *scope, const QString &expression, QObject *parent = nullptr) | |
| QQmlExpression(const QQmlScriptString &script, QQmlContext *ctxt = nullptr, QObject *scope = nullptr, QObject *parent = nullptr) | |
| 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 |
Señales
| void | valueChanged() |
Descripción detallada
Por ejemplo, dado un archivo « main.qml » como este:
import QtQuick 2.0
Item {
width: 200; height: 200
}El siguiente código evalúa una expresión JavaScript en el contexto del QML anterior:
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 = 400Documentación de funciones de miembro
QQmlExpression::QQmlExpression()
Crea una expresión QQmlExpression no válida.
Dado que la expresión no tendrá un ` QQmlContext` asociado, se tratará de un objeto de expresión nulo y su valor siempre será un ` QVariant` no válido.
QQmlExpression::QQmlExpression(QQmlContext *ctxt, QObject *scope, const QString &expression, QObject *parent = nullptr)
Crea un objeto QQmlExpression que sea un elemento secundario de parent.
El código JavaScript de ` expression ` se ejecutará en ` ctxt ` QQmlContext. Si se especifica, las propiedades del objeto ` scope ` también estarán disponibles durante la ejecución de la expresión.
[explicit] QQmlExpression::QQmlExpression(const QQmlScriptString &script, QQmlContext *ctxt = nullptr, QObject *scope = nullptr, QObject *parent = nullptr)
Crea un objeto `QQmlExpression` que sea un elemento secundario de ` parent`.
script proporciona la expresión que se va a evaluar, el contexto en el que se va a evaluar y el objeto de ámbito con el que se va a evaluar. Si se proporcionan, ctxt y scope anularán el contexto y el objeto de ámbito proporcionados por script.
Véase también QQmlScriptString.
[override virtual noexcept] QQmlExpression::~QQmlExpression()
Elimina la instancia de « QQmlExpression ».
void QQmlExpression::clearError()
Elimina cualquier error de expresión. Las llamadas a hasError() que se realicen a continuación devolverán «false».
Véanse también hasError() y error().
int QQmlExpression::columnNumber() const
Devuelve el número de columna del archivo de origen correspondiente a esta expresión. La ubicación de origen debe haberse establecido previamente mediante la llamada a la función ` setSourceLocation()`.
QQmlContext *QQmlExpression::context() const
Devuelve el objeto ` QQmlContext ` al que está asociada esta expresión, o ` nullptr ` si no existe ninguna asociación o si el objeto ` QQmlContext ` ha sido destruido.
QQmlEngine *QQmlExpression::engine() const
Devuelve el objeto ` QQmlEngine ` al que está asociada esta expresión, o ` nullptr ` si no existe ninguna asociación o si el objeto ` QQmlEngine ` ha sido destruido.
QQmlError QQmlExpression::error() const
Devuelve cualquier error producido en la última llamada a evaluate(). Si no se produjo ningún error, devuelve una instancia no válida de QQmlError.
Véanse también hasError() y clearError().
QVariant QQmlExpression::evaluate(bool *valueIsUndefined = nullptr)
Evalúa la expresión y devuelve el resultado de la evaluación, o un objeto « QVariant » no válido si la expresión no es válida o contiene un error.
valueIsUndefined Se establece en «true» si la expresión ha dado como resultado un valor indefinido.
Véase también ` hasError()` y ` error()`.
QString QQmlExpression::expression() const
Devuelve la cadena de la expresión.
Véase también setExpression().
bool QQmlExpression::hasError() const
Devuelve «true» si la última llamada a ` evaluate()` dio lugar a un error; en caso contrario, devuelve «false».
Véanse también error() y clearError().
int QQmlExpression::lineNumber() const
Devuelve el número de línea del archivo fuente correspondiente a esta expresión. La ubicación del archivo fuente debe haberse establecido previamente mediante la llamada a la función « setSourceLocation()».
bool QQmlExpression::notifyOnValueChanged() const
Devuelve «true» si se emite la señal « valueChanged()» cuando cambia el valor de la expresión tras su evaluación.
Véase también ` setNotifyOnValueChanged()`.
QObject *QQmlExpression::scopeObject() const
Devuelve el objeto de ámbito de la expresión, si se ha proporcionado; en caso contrario, devuelve 0.
Además de los datos proporcionados por la ` QQmlContext` de la expresión, las propiedades del objeto de ámbito también están disponibles durante la evaluación de la expresión.
void QQmlExpression::setExpression(const QString &expression)
Establece la expresión en « expression ».
Véase también expression().
void QQmlExpression::setNotifyOnValueChanged(bool notifyOnChange)
Establece si se emite la señal « valueChanged()» cuando cambia el valor evaluado de la expresión.
Si ` notifyOnChange ` es `true`, ` QQmlExpression ` supervisará las propiedades implicadas en la evaluación de la expresión y emitirá ` QQmlExpression::valueChanged()` si han cambiado. Esto permite a una aplicación garantizar que cualquier valor asociado al resultado de la expresión se mantenga actualizado.
Si ` notifyOnChange ` es falso (valor por defecto), el ` QQmlExpression ` no supervisará las propiedades implicadas en la evaluación de la expresión, y nunca se emitirá ` QQmlExpression::valueChanged()`. Esto resulta más eficiente si una aplicación desea una evaluación «única» de la expresión.
Véase también notifyOnValueChanged().
void QQmlExpression::setSourceLocation(const QString &url, int line, int column = 0)
Establece la ubicación de esta expresión en line y column de url. El motor de scripts utiliza esta información.
QString QQmlExpression::sourceFile() const
Devuelve la URL del archivo de origen de esta expresión. La ubicación del archivo de origen debe haberse establecido previamente mediante la llamada a la función ` setSourceLocation()`.
[signal] void QQmlExpression::valueChanged()
Se emite cada vez que el valor de la expresión cambia con respecto a la última vez que se evaluó. La expresión debe haberse evaluado al menos una vez (mediante la llamada a QQmlExpression::evaluate()) para que se emita esta señal.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.