State QML Type
Stellt einen universell einsetzbaren Zustand für „ StateMachine “ bereit. Mehr...
| Import Statement: | import QtQml.StateMachine 6.12 |
| Inherits: | |
| Inherited By: |
Eigenschaften
- childMode : enumeration
- errorState : QAbstractState
- initialState : QAbstractState
Signale
- finished()
Ausführliche Beschreibung
Zustandsobjekte können sowohl untergeordnete Zustände als auch Übergänge zu anderen Zuständen haben. „State“ ist Teil der QML-API „Qt State Machine “
Zustände mit untergeordneten Zuständen
Die Eigenschaft „ childMode “ legt fest, wie untergeordnete Zustände behandelt werden. Bei nicht-parallelen Zustandsgruppen muss die Eigenschaft „ initialState “ verwendet werden, um den Anfangszustand festzulegen. Die untergeordneten Zustände schließen sich gegenseitig aus, und die Zustandsmaschine muss wissen, in welchen untergeordneten Zustand sie wechseln soll, wenn der übergeordnete Zustand das Ziel eines Übergangs ist.
Der Zustand sendet das Signal „ State::finished()“ aus, wenn ein endgültiger untergeordneter Zustand (FinalState) betreten wird.
Die Methode „ errorState “ legt den Fehlerzustand des Zustands fest. Der Fehlerzustand ist der Zustand, in den die Zustandsmaschine übergeht, wenn beim Versuch, in den Zustand zu wechseln, ein Fehler erkannt wird (z. B. weil kein Anfangszustand festgelegt wurde).
Anwendungsbeispiel
import QtQuick
import QtQml.StateMachine as DSM
Rectangle {
DSM.StateMachine {
id: stateMachine
initialState: state
running: true
DSM.State {
id: state
}
}
}Siehe auch „ StateMachine “ und „ FinalState “.
Dokumentation zur Eigenschaft
childMode : enumeration
Der Kindermodus dieses Zustands
Der Standardwert dieser Eigenschaft lautet „ QState.ExclusiveStates“.
Diese Enumeration legt fest, wie die untergeordneten Zustände eines Zustands behandelt werden:
- QState.ExclusiveStates Die untergeordneten Zustände schließen sich gegenseitig aus, und es muss ein Anfangszustand festgelegt werden, indem die Eigenschaft „ initialState “ gesetzt wird.
- QState.ParallelStates Die untergeordneten Zustände laufen parallel. Wenn der übergeordnete Zustand aufgerufen wird, werden alle seine untergeordneten Zustände parallel aufgerufen.
errorState : QAbstractState
Der Fehlerzustand dieses Zustands.
initialState : QAbstractState
Der Anfangszustand dieses Zustands (einer seiner Unterzustände).
Signaldokumentation
finished()
Dieses Signal wird ausgelöst, wenn ein endgültiger untergeordneter Zustand dieses Zustands erreicht wird.
Hinweis: Der entsprechende Handler lautet „ onFinished “.
Siehe auch QAbstractState::active, QAbstractState::entered und QAbstractState::exited.
© 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.