QScxmlDataModel Class
La clase `QScxmlDataModel` es la clase base del modelo de datos para una máquina de estados de ` Qt SCXML `. Más información...
| Encabezado: | #include <QScxmlDataModel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Scxml) target_link_libraries(mytarget PRIVATE Qt6::Scxml) |
| qmake: | QT += scxml |
| Heredado de: | QObject |
| Heredado por: |
Tipos públicos
| class | ForeachLoopBody |
Propiedades
- stateMachine : QScxmlStateMachine*
Funciones públicas
| QScxmlDataModel(QObject *parent = nullptr) | |
| QBindable<QScxmlStateMachine *> | bindableStateMachine() |
| virtual void | evaluateAssignment(QScxmlExecutableContent::EvaluatorId id, bool *ok) = 0 |
| virtual void | evaluateForeach(QScxmlExecutableContent::EvaluatorId id, bool *ok, QScxmlDataModel::ForeachLoopBody *body) = 0 |
| virtual void | evaluateInitialization(QScxmlExecutableContent::EvaluatorId id, bool *ok) = 0 |
| virtual bool | evaluateToBool(QScxmlExecutableContent::EvaluatorId id, bool *ok) = 0 |
| virtual QString | evaluateToString(QScxmlExecutableContent::EvaluatorId id, bool *ok) = 0 |
| virtual QVariant | evaluateToVariant(QScxmlExecutableContent::EvaluatorId id, bool *ok) = 0 |
| virtual void | evaluateToVoid(QScxmlExecutableContent::EvaluatorId id, bool *ok) = 0 |
| virtual bool | hasScxmlProperty(const QString &name) const = 0 |
| virtual QVariant | scxmlProperty(const QString &name) const = 0 |
| virtual void | setScxmlEvent(const QScxmlEvent &event) = 0 |
| virtual bool | setScxmlProperty(const QString &name, const QVariant &value, const QString &context) = 0 |
| void | setStateMachine(QScxmlStateMachine *stateMachine) |
| virtual bool | setup(const QVariantMap &initialDataValues) = 0 |
| QScxmlStateMachine * | stateMachine() const |
Señales
| void | stateMachineChanged(QScxmlStateMachine *stateMachine) |
Miembros públicos estáticos
| QScxmlDataModel * | createScxmlDataModel(const QString &pluginKey) |
Funciones protegidas
| QScxmlDataModel(QScxmlDataModelPrivate &dd, QObject *parent = nullptr) |
Descripción detallada
Los modelos de datos SCXML se describen en la especificación SCXML - 5: Modelo de datos y manipulación de datos. Para obtener más información sobre los modelos de datos compatibles, consulta «Conformidad con SCXML».
Un modelo de datos solo puede pertenecer a una máquina de estados.
Véase también « QScxmlStateMachine », « QScxmlCppDataModel » y « QScxmlNullDataModel ».
Documentación sobre propiedades
[bindable] stateMachine : QScxmlStateMachine*
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene la máquina de estados a la que pertenece este modelo de datos.
Un modelo de datos solo puede pertenecer a una única máquina de estados y una máquina de estados solo puede tener un modelo de datos. Esta relación debe configurarse antes de que se inicie la máquina de estados. Al establecer esta propiedad en un modelo de datos, se configurará automáticamente la propiedad correspondiente « dataModel » en el « stateMachine ».
Funciones de acceso:
| QScxmlStateMachine * | stateMachine() const |
| void | setStateMachine(QScxmlStateMachine *stateMachine) |
Señal del notificador:
| void | stateMachineChanged(QScxmlStateMachine *stateMachine) |
Documentación de las funciones de miembro
[explicit] QScxmlDataModel::QScxmlDataModel(QObject *parent = nullptr)
Crea un nuevo modelo de datos, cuyo objeto padre es parent.
[explicit protected] QScxmlDataModel::QScxmlDataModel(QScxmlDataModelPrivate &dd, QObject *parent = nullptr)
Crea un nuevo modelo de datos a partir del objeto privado « dd », cuyo objeto padre es « parent ».
[static] QScxmlDataModel *QScxmlDataModel::createScxmlDataModel(const QString &pluginKey)
Crea un modelo de datos a partir de un complemento especificado mediante un ` pluginKey`.
[pure virtual] void QScxmlDataModel::evaluateAssignment(QScxmlExecutableContent::EvaluatorId id, bool *ok)
Evalúa la asignación a la que apunta ` id ` y establece ` ok ` en ` false ` si se ha producido un error, o en ` true ` si no se ha producido ninguno.
[pure virtual] void QScxmlDataModel::evaluateForeach(QScxmlExecutableContent::EvaluatorId id, bool *ok, QScxmlDataModel::ForeachLoopBody *body)
Evalúa el bucle «foreach» al que apunta « id » y establece « ok » en « false » si se ha producido un error, o en « true » si no se ha producido ninguno. La expresión « body » se ejecuta en cada iteración.
[pure virtual] void QScxmlDataModel::evaluateInitialization(QScxmlExecutableContent::EvaluatorId id, bool *ok)
Evalúa la inicialización a la que apunta ` id ` y establece ` ok ` en ` false ` si se ha producido un error, o en ` true ` si no se ha producido ninguno.
[pure virtual] bool QScxmlDataModel::evaluateToBool(QScxmlExecutableContent::EvaluatorId id, bool *ok)
Evalúa el contenido ejecutable al que apunta id y establece ok en false si se ha producido un error, o en true si no se ha producido ninguno. Devuelve el resultado de la evaluación como un valor booleano.
[pure virtual] QString QScxmlDataModel::evaluateToString(QScxmlExecutableContent::EvaluatorId id, bool *ok)
Evalúa el contenido ejecutable al que apunta « id » y establece « ok » en « false » si se ha producido un error, o en « true » si no se ha producido ninguno. Devuelve el resultado de la evaluación como un « QString ».
[pure virtual] QVariant QScxmlDataModel::evaluateToVariant(QScxmlExecutableContent::EvaluatorId id, bool *ok)
Evalúa el contenido ejecutable al que apunta ` id ` y establece ` ok ` en ` false ` si se ha producido un error, o en ` true ` si no se ha producido ninguno. Devuelve el resultado de la evaluación como un ` QVariant`.
[pure virtual] void QScxmlDataModel::evaluateToVoid(QScxmlExecutableContent::EvaluatorId id, bool *ok)
Evalúa el contenido ejecutable al que apunta ` id ` y establece ` ok ` en ` false ` si se ha producido un error, o en ` true ` si no se ha producido ninguno. Se espera que la ejecución no devuelva ningún resultado.
[pure virtual] bool QScxmlDataModel::hasScxmlProperty(const QString &name) const
Devuelve ` true ` si existe una propiedad con el ` name ` indicado; en caso contrario, devuelve ` false `.
[pure virtual] QVariant QScxmlDataModel::scxmlProperty(const QString &name) const
Devuelve el valor de la propiedad « name ».
Véase también setScxmlProperty().
[pure virtual] void QScxmlDataModel::setScxmlEvent(const QScxmlEvent &event)
Establece el « event » que se utilizará en la ejecución posterior del contenido ejecutable.
[pure virtual] bool QScxmlDataModel::setScxmlProperty(const QString &name, const QVariant &value, const QString &context)
Establece el valor « value » para la propiedad « name ».
context es una cadena que se utiliza en los mensajes de error para indicar la ubicación en el archivo SCXML donde se produjo el error.
Devuelve ` true ` si la operación se realiza correctamente o ` false ` si se produce un error.
Véase también scxmlProperty().
void QScxmlDataModel::setStateMachine(QScxmlStateMachine *stateMachine)
Establece la máquina de estados a la que pertenece este modelo en « stateMachine ». Existe una relación de 1:1 entre las máquinas de estados y los modelos. Una vez establecida la máquina de estados, ya no se podrá cambiar. Cualquier intento posterior de establecer la máquina de estados mediante este método se ignorará.
Nota: Funciónde asignación para la propiedad stateMachine.
Véase también ` stateMachine()`.
[pure virtual invokable] bool QScxmlDataModel::setup(const QVariantMap &initialDataValues)
Inicializa el modelo de datos con los valores iniciales especificados en initialDataValues.
Devuelve ` false ` si se producen errores de análisis o si falla alguno de los pasos de inicialización. En caso contrario, devuelve ` true `.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
QScxmlStateMachine *QScxmlDataModel::stateMachine() const
Devuelve la máquina de estados asociada al modelo de datos.
Nota: Funcióngetter para la propiedad stateMachine.
Véase también ` setStateMachine()`.
© 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.