ScxmlStateMachine QML Type
Proporciona una interfaz para las máquinas de estados creadas a partir de archivos SCXML. Más...
| Import Statement: | import QtScxml 6.12 |
| In C++: | QScxmlStateMachine |
Propiedades
- dataModel : ScxmlDataModel
- initialValues : var
- initialized : bool
- invoked : bool
- invokedServices : list
- loader : Loader
- name : string
- parseErrors : var
- running : bool
- sessionId : string
Señales
- finished()
- log(string label, string msg)
- reachedStableState()
Métodos
- list<string> activeStateNames(bool compress)
- void cancelDelayedEvent(string sendId)
- bool init()
- bool isActive(string scxmlStateName)
- bool isDispatchableTarget(string target)
- void start()
- list<string> stateNames(bool compress)
- void stop()
- void submitEvent(event)
- void submitEvent(string eventName, var data)
Descripción detallada
El tipo ScxmlStateMachine es una implementación del lenguaje State Chart XML (SCXML).
Se puede acceder a todos los estados definidos en el archivo SCXML como propiedades de este tipo. Estas propiedades son valores booleanos e indican si el estado está activo o inactivo.
Documentación de las propiedades
dataModel : ScxmlDataModel
El modelo de datos que se utilizará para esta máquina de estados.
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, consulte «Cumplimiento de SCXML».
El cambio del modelo de datos una vez que la máquina de estados ha sido « initialized » no está especificado en el estándar SCXML y da lugar a un comportamiento indefinido.
Véase también « QScxmlDataModel », « QScxmlNullDataModel » y « QScxmlCppDataModel ».
initialValues : var
Los valores iniciales que se utilizarán para configurar el modelo de datos.
initialized : bool [read-only]
Esta propiedad de solo lectura toma el valor « true » si la máquina de estados se ha inicializado y « false » en caso contrario.
invoked : bool [read-only]
Si la máquina de estados se invocó desde una máquina de estados externa.
Esta propiedad de solo lectura se establece en « true » cuando la máquina de estados se inició como servicio con el elemento « <invoke> »; en caso contrario, se establece en « false ».
invokedServices : list [read-only]
Una lista de los servicios SCXML que se invocaron desde la máquina de estados principal (posiblemente de forma recursiva).
loader : Loader
El cargador que se utiliza actualmente para resolver y cargar los URI de la máquina de estados.
name : string [read-only]
El nombre de la máquina de estados, tal y como se establece en el atributo «name» de la etiqueta ` <scxml> `.
parseErrors : var [read-only]
La lista de errores de análisis sintáctico que se produjeron al crear una máquina de estados a partir de un archivo SCXML.
running : bool
El estado actual de esta máquina de estados.
sessionId : string [read-only]
El identificador de sesión de la máquina de estados actual.
El identificador de sesión se utiliza para el enrutamiento de mensajes entre máquinas de estados padre e hijo. Si una máquina de estados se inicia mediante un elemento ` <invoke> `, cualquier evento que envíe tendrá el campo ` invokeid ` establecido en el identificador de sesión. La máquina de estados utilizará el origen de un evento (que viene establecido por el atributo «target» o «targetexpr» en un elemento « <send> ») para enviar mensajes a la máquina de estados hija correcta.
Documentación de Signal
finished()
Esta señal se emite cuando la máquina de estados alcanza un estado final de nivel superior.
El controlador de señal correspondiente es onFinished().
Nota: El controlador correspondiente es onFinished.
log(string label, string msg)
Esta señal se emite si se utiliza una etiqueta ` <log> ` en el SCXML. ` label ` es el valor del atributo `label` de la etiqueta ` <log> `. ` msg ` es el valor del atributo `expr ` evaluado de la etiqueta ` <log> `. Si no hay ningún atributo `expr`, se devolverá una cadena nula.
El controlador de señales correspondiente es onLog().
Nota: El controlador correspondiente es onLog.
reachedStableState()
Esta señal se emite cuando la cola de eventos está vacía al final de un paso de macro o cuando se alcanza un estado final.
El controlador de señales correspondiente es onreachedStableState().
Nota: El controlador correspondiente es onReachedStableState.
Documentación del método
list<string> activeStateNames(bool compress)
Recupera una lista con los nombres de todos los estados activos.
Cuando un estado está activo, todos sus estados padres están activos por definición. Cuando compress es true (el valor por defecto), se filtran los estados padres y solo se devuelven los estados hoja. Cuando es false, se devuelve la lista completa de estados activos.
void cancelDelayedEvent(string sendId)
Cancela un evento aplazado con el ` sendId` especificado.
bool init()
Inicializa la máquina de estados estableciendo los valores iniciales de los elementos <data> y ejecutando las etiquetas <script> de la etiqueta <scxml>. Los valores iniciales de los datos se obtienen de la propiedad initialValues.
Devuelve « false » si se producen errores de análisis o si falla alguno de los pasos de inicialización. En caso contrario, devuelve « true ».
bool isActive(string scxmlStateName)
Devuelve « true » si el estado especificado por « scxmlStateName » está activo; en caso contrario, devuelve « false ».
bool isDispatchableTarget(string target)
Devuelve ` true ` si esta máquina de estados puede enviar un mensaje a ` target `.
Los destinos válidos son:
#_parentla máquina de estados principal, si la máquina de estados actual se ha iniciado mediante<invoke>#_internalpara la máquina de estados actual#_scxml_sessionid, dondesessionides el ID de sesión de la máquina de estados actual#_servicename, dondeservicenamees el ID o el nombre de un servicio iniciado con<invoke>por esta máquina de estados
void start()
Inicia esta máquina de estados. La máquina restablece su configuración y pasa al estado inicial. Cuando se alcanza un estado final de nivel superior, la máquina emite la señal finished().
Véase también « stop()» y « finished()».
list<string> stateNames(bool compress)
Recupera una lista con los nombres de todos los estados.
Cuando ` compress ` es ` true ` (valor por defecto), se filtran los estados que contienen estados secundarios y solo se devuelven los estados hoja. Cuando es ` false`, se devuelve la lista completa de todos los estados.
La lista devuelta no contiene los estados de posibles máquinas de estados anidadas.
Nota: El orden de los nombres de los estados en la lista es el orden en el que aparecen los estados en el documento SCXML.
void stop()
Detiene esta máquina de estados. La máquina no ejecutará más transiciones de estado. Su propiedad « running » se establece en « false ».
Véanse también start() y finished().
void submitEvent(event)
Envía el evento SCXML « event » a la cola de eventos interna o externa, en función de la prioridad del evento.
Cuando se establece un retraso, el evento se pone en cola para su entrega una vez transcurrido el tiempo de espera. La máquina de estados se hace cargo del evento y lo elimina tras su procesamiento.
Véase también QScxmlEvent.
void submitEvent(string eventName, var data)
Método de utilidad para crear y enviar un evento externo con el nombre « eventName » y los datos de carga útil « data » (opcional).
© 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.