State QML Type

Bietet einen Allzweckstatus für StateMachine. Mehr...

Import Statement: import QtQml.StateMachine 6.8
Inherits:

QAbstractState

Inherited By:

StateMachine

Eigenschaften

Signale

Detaillierte Beschreibung

Zustandsobjekte können sowohl untergeordnete Zustände als auch Übergänge zu anderen Zuständen haben. State ist Teil der Qt State Machine QML API

Zustände mit untergeordneten Zuständen

Die Eigenschaft childMode bestimmt, wie Unterzustände behandelt werden. Für nicht-parallele Zustandsgruppen muss die Eigenschaft initialState verwendet werden, um den Anfangszustand festzulegen. Die Unterzustände sind einander ausschließende Zustände, und der Zustandsautomat muss wissen, in welchen Unterzustand er eintreten muss, wenn der übergeordnete Zustand das Ziel eines Übergangs ist.

Der Zustand gibt das Signal State::finished() aus, wenn ein endgültiger Unterzustand (FinalState) erreicht wird.

Das Signal errorState setzt den Fehlerzustand des Zustands. Der Fehlerzustand ist der Zustand, in den der Zustandsautomat übergeht, wenn beim Versuch, den Zustand zu betreten, ein Fehler festgestellt wird (z. B. weil kein Anfangszustand gesetzt wurde).

Beispiel für die Verwendung

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.

Eigenschaft Dokumentation

childMode : enumeration

Der Child-Modus dieses Zustands

Der Standardwert für diese Eigenschaft ist QState. ExclusiveStates.

Diese Aufzählung gibt an, wie die untergeordneten Zustände eines Zustands behandelt werden:

  • QState.ExclusiveStates Die untergeordneten Zustände schließen sich gegenseitig aus und ein Anfangszustand muss durch Setzen der Eigenschaft initialState festgelegt werden.
  • QState.ParallelStates Die untergeordneten Zustände sind parallel. Wenn der übergeordnete Zustand betreten wird, werden alle untergeordneten Zustände parallel betreten.

errorState : QAbstractState

Der Fehlerzustand dieses Zustands.


initialState : QAbstractState

Der Ausgangszustand dieses Zustands (einer der untergeordneten Zustände).


Signal Dokumentation

finished()

Dieses Signal wird ausgegeben, wenn ein endgültiger Unterzustand dieses Zustands erreicht wird.

Hinweis: Der entsprechende Handler ist onFinished.

Siehe auch QAbstractState::active, QAbstractState::entered, und QAbstractState::exited.


© 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.