Instanciación de máquinas de estados
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 crear una dinámicamente en C++ a partir de un archivo SCXML, puedes utilizar:
auto *stateMachine = QScxmlStateMachine::fromFile("MyStatemachine.scxml");O, en QML:
import QtScxml
Item {
property StateMachine stateMachine: scxmlLoader.stateMachine
StateMachineLoader {
id: scxmlLoader
source: "statemachine.scxml"
}
}Una máquina de estados compilada se puede instanciar de la misma forma que cualquier objeto de C++:
auto *stateMachine = new MyStatemachine;O bien:
MyStatemachine stateMachine;Para utilizar una máquina de estados compilada en QML, puedes registrarla como un tipo QML:
struct MyStateMachineRegistration {
Q_GADGET
QML_NAMED_ELEMENT(MyStateMachine)
QML_FOREIGN(MyStateMachine)
QML_ADDED_IN_VERSION(1, 0)
};A continuación, puedes crear una instancia de ella en QML, de esta forma:
import MyStateMachine 1.0
MyStateMachine {
id: stateMachine
}Para compilar una máquina de estados, hay que añadir las siguientes líneas al archivo de compilación del proyecto:
Si se utiliza CMake:
find_package(Qt6 REQUIRED COMPONENTS Scxml)
target_link_libraries(mytarget PRIVATE Qt6::Scxml)qt_add_statecharts(mytarget
MyStatemachine.scxml
)Al utilizar qmake:
QT += scxmlSTATECHARTS = MyStatemachine.scxmlEsto indicará a qmake que ejecute qscxmlc, que genera MyStatemachine.h y MyStatemachine.cpp, y los añade adecuadamente a los encabezados y archivos fuente del proyecto. Por defecto, los archivos generados se guardan en el directorio de compilación. Se puede configurar la variable QSCXMLC_DIR de qmake o OUTPUT_DIRECTORY de cmake para especificar otro directorio. Se puede configurar la variable QSCXMLC_NAMESPACE de qmake o NAMESPACE de cmake para colocar el código de la máquina de estados en un espacio de nombres de C++.
Tras instanciar una máquina de estados, puedes conectarte a la propiedad «active» de cualquier estado de la siguiente manera. Por ejemplo, si la máquina de estados de un semáforo tiene un estado que indica que la luz está en rojo (que tiene el práctico identificador «red» en el archivo scxml), puedes escribir:
stateMachine->connectToState("red", [](bool active) {
qDebug() << (active ? "entered" : "exited") << "the red state";
});Y en QML:
Light {
id: greenLight
color: "green"
visible: stateMachine.green
}Si quieres recibir una notificación cuando una máquina de estados envíe un evento, puedes conectarte a la señal correspondiente. Por ejemplo, para una máquina de estados de un reproductor multimedia que indica que la reproducción se ha detenido enviando un evento, puedes escribir:
stateMachine->connectToEvent("playbackStopped", [](const QScxmlEvent&){
qDebug() << "Stopped!";
});Y en QML:
import QtScxml
EventConnection {
stateMachine: stateMachine
events: ["playbackStopped"]
onOccurred: console.log("Stopped!")
}Enviar eventos a una máquina de estados es igual de sencillo:
stateMachine->submitEvent("tap", QVariantMap({
{ "artist", "Fatboy Slim" },
{ "title", "The Rockafeller Skank" }
}));Esto generará un evento «tap» con el contenido del mapa disponible en _event.data dentro de la máquina de estados. En QML:
stateMachine.submitEvent("tap", {
"artist": "Fatboy Slim"
"title": "The Rockafeller Skank"
})Nota: Una máquina de estados necesita un bucle de eventos ( QEventLoop ) para funcionar correctamente. El bucle de eventos se utiliza para implementar el atributo « delay » para los eventos y para programar el procesamiento de una máquina de estados cuando se reciben eventos de máquinas de estados anidadas (o parentales). Una aplicación QML o una aplicación de widgets siempre tendrá un bucle de eventos en ejecución, por lo que no se necesita nada adicional. En el caso de otras aplicaciones, habrá que llamar a ` QApplication::run ` para iniciar el procesamiento del bucle de eventos.
© 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.