ScxmlStateMachine QML Type
Fournit une interface aux machines à états créées à partir de fichiers SCXML. Plus d'informations...
| Import Statement: | import QtScxml 6.10 |
| In C++: | QScxmlStateMachine |
Propriétés
- dataModel : ScxmlDataModel
- initialValues : var
- initialized : bool
- invoked : bool
- invokedServices : list
- loader : Loader
- name : string
- parseErrors : var
- running : bool
- sessionId : string
Signaux
- finished()
- log(string label, string msg)
- reachedStableState()
Méthodes
- activeStateNames(bool compress)
- cancelDelayedEvent(string sendId)
- init()
- isActive(string scxmlStateName)
- isDispatchableTarget(string target)
- start()
- stateNames(bool compress)
- stop()
- submitEvent(event)
- submitEvent(string eventName, var data)
Description détaillée
Le type ScxmlStateMachine est une implémentation du State Chart XML (SCXML).
Tous les états définis dans le fichier SCXML sont accessibles en tant que propriétés de ce type. Ces propriétés sont des valeurs booléennes qui indiquent si l'état est actif ou inactif.
Documentation des propriétés
dataModel : ScxmlDataModel |
Le modèle de données à utiliser pour cette machine à états.
Les modèles de données SCXML sont décrits dans la spécification SCXML - 5 Modèle de données et manipulation des données. Pour plus d'informations sur les modèles de données pris en charge, voir Conformité SCXML.
La modification du modèle de données lorsque l'automate d'état a été initialized n'est pas spécifiée dans la norme SCXML et entraîne un comportement non défini.
Voir également QScxmlDataModel, QScxmlNullDataModel, et QScxmlCppDataModel.
initialValues : var |
Les valeurs initiales à utiliser pour configurer le modèle de données.
initialized : bool |
Cette propriété en lecture seule a pour valeur true si la machine à états a été initialisée, false dans le cas contraire.
invoked : bool |
Si l'automate à états a été invoqué à partir d'un automate à états externe.
Cette propriété en lecture seule prend la valeur true lorsque l'automate à états a été lancé en tant que service avec l'élément <invoke>, false dans le cas contraire.
invokedServices : list |
Une liste de services SCXML qui ont été invoqués à partir de l'automate d'état principal (éventuellement de manière récursive).
loader : Loader |
Le chargeur actuellement utilisé pour résoudre et charger les URI de l'automate à états.
name : string |
Le nom de l'automate à états tel qu'il est défini par l'attribut name de la balise <scxml>.
parseErrors : var |
La liste des erreurs d'analyse survenues lors de la création d'un automate à états à partir d'un fichier SCXML.
running : bool |
L'état d'exécution de cet automate à états.
sessionId : string |
L'identifiant de session de l'automate à états actuel.
L'identifiant de session est utilisé pour l'acheminement des messages entre les machines à états parent et enfant. Si une machine à états est démarrée par un élément <invoke>, tout événement qu'elle envoie aura le champ invokeid fixé à l'ID de session. L'automate d'état utilisera l'origine d'un événement (définie par l'attribut target ou targettexpr d'un élément <send> ) pour envoyer des messages à l'automate d'état enfant approprié.
Documentation du signal
finished() |
Ce signal est émis lorsque l'automate d'état atteint un état final de niveau supérieur.
Le gestionnaire de signal correspondant est onFinished().
Note : Le gestionnaire correspondant est onFinished.
log(string label, string msg) |
Ce signal est émis si une balise <log> est utilisée dans le SCXML. label est la valeur de l'attribut label de la balise <log>. msg est la valeur de l'attribut expr évalué de la balise <log>. S'il n'y a pas d'attribut expr, une chaîne nulle sera renvoyée.
Le gestionnaire de signal correspondant est onLog().
Note : Le gestionnaire correspondant est onLog.
reachedStableState() |
Ce signal est émis lorsque la file d'attente des événements est vide à la fin d'une étape macro ou lorsqu'un état final est atteint.
Le gestionnaire de signal correspondant est onreachedStableState().
Remarque : Le gestionnaire correspondant est onReachedStableState.
Documentation de la méthode
activeStateNames(bool compress) |
Récupère une liste de noms d'états pour tous les états actifs.
Lorsqu'un état est actif, tous ses états parents sont actifs par définition. Lorsque compress est true (valeur par défaut), les états parents sont filtrés et seuls les états feuilles sont renvoyés. Lorsque la valeur est false, la liste complète des états actifs est renvoyée.
cancelDelayedEvent(string sendId) |
Annule un événement retardé avec l'adresse sendId spécifiée.
init() |
Initialise la machine à états en définissant les valeurs initiales des éléments <data> et en exécutant toutes les balises <script> de la balise <scxml>. Les valeurs initiales des données proviennent de la propriété initialValues.
Renvoie false en cas d'erreur d'analyse ou d'échec de l'une des étapes d'initialisation. Renvoie true dans le cas contraire.
isActive(string scxmlStateName) |
Renvoie true si l'état spécifié par scxmlStateName est actif, false sinon.
isDispatchableTarget(string target) |
Renvoie true si un message à target peut être envoyé par cette machine d'état.
Les cibles valides sont
#_parentpour l'automate d'état parent si l'automate d'état actuel est démarré par<invoke>#_internalpour l'automate d'état actuel#_scxml_sessionidoùsessionidest l'identifiant de session de l'automate à états actuel#_servicenamepour la machine à états actuelle, oùservicenameest l'ID ou le nom d'un service démarré avec<invoke>par cette machine à états.
start() |
stateNames(bool compress) |
Récupère une liste de noms d'états de tous les états.
Lorsque compress est true (par défaut), les états qui contiennent des états enfants sont filtrés et seuls les états feuilles sont renvoyés. Lorsque la valeur est false, la liste complète de tous les états est renvoyée.
La liste renvoyée ne contient pas les états d'éventuelles machines à états imbriquées.
Remarque : l'ordre des noms d'états dans la liste correspond à l'ordre dans lequel les états sont apparus dans le document SCXML.
stop() |
submitEvent(event) |
Soumet l'événement SCXML event à la file d'attente d'événements interne ou externe en fonction de la priorité de l'événement.
Lorsqu'un délai est défini, l'événement est mis en file d'attente pour livraison une fois le délai écoulé. La machine d'état prend possession de l'événement et le supprime après traitement.
Voir également QScxmlEvent.
submitEvent(string eventName, var data) |
Méthode utilitaire permettant de créer et de soumettre un événement externe avec eventName comme nom et data comme données utiles (facultatif).
© 2025 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.