QStateMachine Class

QPushButton button;

QStateMachine machine;
QState *s1 = new QState();
s1->assignProperty(&button, "text", "Click me");

QFinalState *s2 = new QFinalState();
s1->addTransition(&button, &QPushButton::clicked, s2);

machine.addState(s1);
machine.addState(s2);
machine.setInitialState(s1);
machine.start();

Dokumentation zu den Mitgliedsfunktionen

[explicit] QStateMachine::QStateMachine(QObject *parent = nullptr)

Erstellt eine neue Zustandsmaschine mit dem angegebenen „ parent “.

[virtual noexcept] QStateMachine::~QStateMachine()

Löscht diese Zustandsmaschine.

void QStateMachine::addDefaultAnimation(QAbstractAnimation *animation)

Fügt eine Standard- animation hinzu, die bei jedem Übergang berücksichtigt werden soll.

void QStateMachine::addState(QAbstractState *state)

Fügt die angegebene „ state “ zu dieser Zustandsmaschine hinzu. Der Zustand wird zu einem Zustand der obersten Ebene, und die Zustandsmaschine übernimmt die Verantwortung für diesen Zustand.

Befindet sich der Zustand bereits in einer anderen Maschine, wird er zunächst aus der alten Maschine entfernt und anschließend dieser Maschine hinzugefügt.

Siehe auch „ removeState()“ und „ setInitialState()“.

bool QStateMachine::cancelDelayedEvent(int id)

Hebt das verzögerte Ereignis auf, das durch die angegebene ` id` identifiziert wird. Die ID sollte ein Wert sein, der durch einen Aufruf von ` postDelayedEvent()` zurückgegeben wurde. Gibt ` true ` zurück, wenn das Ereignis erfolgreich aufgehoben wurde, andernfalls ` false`.

Hinweis: Diese Funktion ist threadsicher.

Siehe auch postDelayedEvent().

void QStateMachine::clearError()

Löscht die Fehlermeldung und den Fehlercode der Zustandsmaschine.

QSet<QAbstractState *> QStateMachine::configuration() const

Gibt die maximale konsistente Menge von Zuständen (einschließlich Parallel- und Endzustände) zurück, in der sich diese Zustandsmaschine derzeit befindet. Befindet sich ein Zustand s in der Konfiguration, so gilt immer, dass sich auch der übergeordnete Zustand von s in c befindet. Beachten Sie jedoch, dass die Maschine selbst kein explizites Element der Konfiguration ist.

QList<QAbstractAnimation *> QStateMachine::defaultAnimations() const

Gibt die Liste der Standardanimationen zurück, die bei jedem Übergang berücksichtigt werden.

QStateMachine::Error QStateMachine::error() const

Gibt den Fehlercode des letzten Fehlers zurück, der in der Zustandsmaschine aufgetreten ist.

QString QStateMachine::errorString() const

Gibt die Fehlerzeichenfolge des letzten Fehlers zurück, der in der Zustandsmaschine aufgetreten ist.

[override virtual protected] bool QStateMachine::event(QEvent *e)

Implementiert: ` QState::event(QEvent *e)`.

[override virtual] bool QStateMachine::eventFilter(QObject *watched, QEvent *event)

Implementiert neu: ` QObject::eventFilter` (`QObject *watched, QEvent *event`).

QState::RestorePolicy QStateMachine::globalRestorePolicy() const

Gibt die Wiederherstellungsrichtlinie der Zustandsmaschine zurück.

Siehe auch „ setGlobalRestorePolicy()“.

bool QStateMachine::isAnimated() const

Gibt zurück, ob Animationen für diese Zustandsmaschine aktiviert sind.

[override virtual protected] void QStateMachine::onEntry(QEvent *event)

Implementiert: ` QState::onEntry(QEvent *event)`.

Diese Funktion ruft ` start()` auf, um die Zustandsmaschine zu starten.

[override virtual protected] void QStateMachine::onExit(QEvent *event)

Implementiert: ` QState::onExit(QEvent *event)`.

Diese Funktion ruft „ stop()“ auf, um die Zustandsmaschine anzuhalten, und sendet anschließend das Signal „ stopped()“ aus.

int QStateMachine::postDelayedEvent(QEvent *event, int delay)

Sendet das angegebene Ereignis „ event “ zur Verarbeitung durch diese Zustandsmaschine mit der angegebenen Verzögerung „ delay “ in Millisekunden. Gibt eine Kennung zurück, die dem verzögerten Ereignis zugeordnet ist, oder -1, falls das Ereignis nicht gesendet werden konnte.

Diese Funktion kehrt sofort zurück. Nach Ablauf der Verzögerungszeit wird das Ereignis zur Verarbeitung in die Ereigniswarteschlange der Zustandsmaschine aufgenommen. Die Zustandsmaschine übernimmt die Verantwortung für das Ereignis und löscht es, sobald es verarbeitet wurde.

Sie können Ereignisse nur einreichen, wenn die Zustandsmaschine läuft.

Hinweis: Diese Funktion ist threadsicher.

Siehe auch cancelDelayedEvent() und postEvent().

int QStateMachine::postDelayedEvent(QEvent *event, std::chrono::milliseconds delay)

Sendet das angegebene Ereignis „ event “ zur Verarbeitung durch diese Zustandsmaschine mit der angegebenen Verzögerung „ delay “ in Millisekunden. Gibt eine Kennung zurück, die dem verzögerten Ereignis zugeordnet ist, oder -1, falls das Ereignis nicht gesendet werden konnte.

Diese Funktion kehrt sofort zurück. Nach Ablauf der Verzögerungszeit wird das Ereignis zur Verarbeitung in die Ereigniswarteschlange der Zustandsmaschine aufgenommen. Die Zustandsmaschine übernimmt die Verantwortung für das Ereignis und löscht es, sobald es verarbeitet wurde.

Ereignisse können nur gesendet werden, wenn die Zustandsmaschine läuft.

Hinweis: Diese Funktion ist threadsicher.

Siehe auch cancelDelayedEvent() und postEvent().

void QStateMachine::postEvent(QEvent *event, QStateMachine::EventPriority priority = NormalPriority)

Leitet das angegebene „ event “ des angegebenen „ priority “ zur Verarbeitung durch diese Zustandsmaschine weiter.

Diese Funktion kehrt sofort zurück. Das Ereignis wird der Ereigniswarteschlange der Zustandsmaschine hinzugefügt. Ereignisse werden in der Reihenfolge ihrer Übermittlung verarbeitet. Die Zustandsmaschine übernimmt die Verantwortung für das Ereignis und löscht es, sobald es verarbeitet wurde.

Sie können Ereignisse nur senden, wenn die Zustandsmaschine läuft oder gerade startet.

Hinweis: Diese Funktion ist threadsicher.

Siehe auch ` postDelayedEvent()`.

void QStateMachine::removeDefaultAnimation(QAbstractAnimation *animation)

Entfernt „ animation “ aus der Liste der Standardanimationen.

void QStateMachine::removeState(QAbstractState *state)

Entfernt den angegebenen „ state “ aus dieser Zustandsmaschine. Die Zustandsmaschine gibt die Eigentumsrechte an dem Zustand frei.

Siehe auch ` addState()`.

[signal] void QStateMachine::runningChanged(bool running)

Dieses Signal wird ausgelöst, wenn die Eigenschaft „running“ mit dem Argument „ running “ geändert wird.

Siehe auch „ QStateMachine::running “.

void QStateMachine::setAnimated(bool enabled)

Legt fest, ob Animationen für diese Zustandsmaschine „ enabled “ sind.

Siehe auch „ isAnimated()“.

void QStateMachine::setGlobalRestorePolicy(QState::RestorePolicy restorePolicy)

Legt die Wiederherstellungsrichtlinie der Zustandsmaschine auf „ restorePolicy “ fest. Die Standard-Wiederherstellungsrichtlinie lautet „ QState::DontRestoreProperties “.

Siehe auch „ globalRestorePolicy()“.

[slot] void QStateMachine::start()

Startet diese Zustandsmaschine. Die Maschine setzt ihre Konfiguration zurück und wechselt in den Anfangszustand. Wenn ein endgültiger Zustand der obersten Ebene (QFinalState) erreicht wird, gibt die Maschine das Signal „ finished()“ aus.

Siehe auch started(), finished(), stop(), initialState() und setRunning().

[private signal] void QStateMachine::started()

Dieses Signal wird ausgesendet, wenn die Zustandsmaschine ihren Anfangszustand (QStateMachine::initialState) erreicht hat.

Siehe auch „ QStateMachine::finished()“ und „ QStateMachine::start()“.

[slot] void QStateMachine::stop()

Hält diese Zustandsmaschine an. Die Zustandsmaschine stellt die Verarbeitung von Ereignissen ein und sendet anschließend das Signal „ stopped()“ aus.

Siehe auch „ stopped()“, „ start()“ und „ setRunning()“.

[private signal] void QStateMachine::stopped()

Dieses Signal wird ausgesendet, wenn die Zustandsmaschine angehalten hat.

Siehe auch QStateMachine::stop() und QStateMachine::finished().