StateMachine QML Type

Stellt einen hierarchischen endlichen Zustandsautomaten bereit. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• errorString : string
• globalRestorePolicy : enumeration
• running : bool

Signale

• started()
• stopped()

Methoden

• start()
• stop()

Detaillierte Beschreibung

StateMachine basiert auf den Konzepten und der Notation von Statecharts. StateMachine ist Teil der Qt State Machine QML API

Ein Zustandsautomat verwaltet eine Menge von Zuständen und Übergängen zwischen diesen Zuständen; diese Zustände und Übergänge definieren einen Zustandsgraphen. Sobald ein Zustandsgraph erstellt wurde, kann der Zustandsautomat ihn ausführen. Der Ausführungsalgorithmus von StateMachine basiert auf dem State Chart XML (SCXML) Algorithmus. In der Übersicht des Frameworks sind verschiedene Zustandsgraphen und der Code zu deren Erstellung aufgeführt.

Bevor die Maschine gestartet werden kann, muss die initialState gesetzt werden. Der Ausgangszustand ist der Zustand, in den die Maschine beim Start übergeht. Sie können dann die Eigenschaft running auf true setzen oder start() den Automaten starten. Das Startsignal wird ausgegeben, wenn der Ausgangszustand erreicht ist.

Der Zustandsautomat verarbeitet Ereignisse und nimmt Übergänge vor, bis ein Endzustand der obersten Ebene erreicht ist; dann gibt der Zustandsautomat das Signal finished() aus. Sie können den Zustandsautomaten auch explizit stop() aufrufen (Sie können auch die Eigenschaft running auf false setzen). In diesem Fall wird das Signal stopped ausgegeben.

Beispielverwendung

Der folgende Ausschnitt zeigt einen Zustandsautomaten, der beendet wird, wenn eine Schaltfläche angeklickt wird:

import QtQuick
import QtQml.StateMachine as DSM

Rectangle {
    Button {
        anchors.fill: parent
        id: button
        text: "Finish state"
        DSM.StateMachine {
            id: stateMachine
            initialState: state
            running: true
            DSM.State {
                id: state
                DSM.SignalTransition {
                    targetState: finalState
                    signal: button.clicked
                }
            }
            DSM.FinalState {
                id: finalState
            }
            onFinished: Qt.quit()
        }
    }
}

Wenn ein Fehler auftritt, sucht der Automat nach einem errorState, und wenn ein solcher vorhanden ist, wird er in diesen Zustand versetzt. Nachdem der Fehlerzustand eingetreten ist, kann die Art des Fehlers mit error() abgefragt werden. Die Ausführung des Zustandsgraphen wird nicht angehalten, wenn der Fehlerzustand erreicht ist. Trifft kein Fehlerzustand auf den fehlerhaften Zustand zu, stoppt die Ausführung des Automaten und es wird eine Fehlermeldung auf der Konsole ausgegeben.

Siehe auch QAbstractState, State, SignalTransition, TimeoutTransition, HistoryState, und Qt State Machine QML Guide.

Eigenschaft Dokumentation

Signal Dokumentation

Methode Dokumentation