En esta página

Qt SCXML Descripción general

El módulo Qt SCXML proporciona clases para integrar máquinas de estados creadas a partir de archivos XML de diagramas de estado (SCXML) en aplicaciones Qt. Los archivos SCXML pueden crearse utilizando cualquier herramienta adecuada, como un editor de texto o un simulador, siempre que cumplan con la especificación SCXML, con las restricciones y extensiones descritas en «Cumplimiento de SCXML».

Partes de la lógica de la aplicación pueden sustituirse por un archivo SCXML encapsulado. Esto permite establecer una clara división entre la lógica de la aplicación y la implementación de la interfaz de usuario mediante el uso de Qt Quick o Qt Widgets.

El módulo Qt SCXML se diferencia del marco State Machine en el Qt State Machine en que « Qt SCXML » proporciona un procesador conforme capaz de analizar y procesar documentos SCXML conformes. En « Qt SCXML », las máquinas de estados se leen a partir de archivos SCXML independientes y se integran en aplicaciones Qt mediante la instanciación de la clase « QScxmlStateMachine » y la carga dinámica de un archivo SCXML, o bien utilizando el compilador « Qt SCXML » para generar una subclase de « QScxmlStateMachine » que se instancia. La comunicación con el documento SCXML se lleva a cabo mediante las señales y los métodos de la clase QScxmlStateMachine.

Los conceptos básicos de la máquina de estados —estado, transición y evento— se basan en los de la especificación SCXML. Los diagramas de estados ofrecen una forma gráfica de modelar cómo reacciona un sistema ante los estímulos. Esto se consigue definiendo los posibles estados en los que puede encontrarse el sistema y cómo este puede pasar de un estado a otro (transiciones entre estados). Una característica clave de los sistemas basados en eventos (como las aplicaciones Qt) es que el comportamiento a menudo depende no solo del último evento o del actual, sino también de los eventos que lo precedieron. Con los diagramas de estados, esta información es fácil de expresar.

Qt SCXML Se integra estrechamente con el sistema de metaobjetos de Qt; por ejemplo, las transiciones entre estados pueden activarse mediante señales, y los estados pueden configurarse para establecer propiedades e invocar métodos en QObjects. El sistema de eventos de Qt se utiliza para controlar las máquinas de estados.

El gráfico de estados de Qt SCXML es jerárquico. Los estados pueden anidarse dentro de otros estados, y la configuración actual de la máquina de estados consiste en el conjunto de estados que están activos en ese momento.

Modelos de datos

Qt SCXML admite el modelo de datos nulo, que deben soportar los procesadores SCXML conformes, y el modelo de datos ECMAScript. Además, Qt SCXML proporciona su propio modelo de datos en C++, implementado por la clase QScxmlCppDataModel. Esta clase permite escribir código en C++ para los atributos «expr» y los elementos « <script> ». La parte de datos del modelo de datos se basa en una subclase de ` QScxmlCppDataModel`, para la cual el compilador « Qt SCXML » generará los métodos de despacho.

Qt SCXML Compilador

El compilador « Qt SCXML », qscxmlc, lee un archivo .scxml y genera archivos fuente y de cabecera de C++ que contienen una clase que implementa una máquina de estados tal y como se define en SCXML. Para obtener más información sobre el uso del compilador, consulte Uso del compilador « Qt SCXML » (qscxmlc).

Tanto las máquinas de estados creadas dinámicamente como las compiladas se comportan de la misma manera, tienen las mismas propiedades, estados, modelo de datos, etc. Solo se diferencian en la forma en que se instancian. Para obtener más información, consulte Instanciación de máquinas de estados y Ejemplos de «Qt SCXML ».

Categorías de registro

El módulo « Qt SCXML » exporta las siguientes categorías de registro:

Categoría de registroDescripción
qscxmlLogHabilita el registro del módulo « Qt SCXML »
scxmlLogHabilita el registro de documentos SCXML

© 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.