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 der Mitgliedsfunktionen

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

Konstruiert einen neuen Zustandsautomaten mit der angegebenen parent.

[virtual noexcept] QStateMachine::~QStateMachine()

Zerstört diesen Zustandsautomaten.

void QStateMachine::addDefaultAnimation(QAbstractAnimation *animation)

Fügt einen Standard animation hinzu, der bei jedem Übergang berücksichtigt wird.

void QStateMachine::addState(QAbstractState *state)

Fügt die angegebene state zu diesem Zustandsautomaten hinzu. Der Zustand wird zu einem Top-Level-Zustand, und der Zustandsautomat übernimmt die Verantwortung für den Zustand.

Befindet sich der Zustand bereits in einem anderen Automaten, wird er zunächst aus dem alten Automaten entfernt und dann zu diesem Automaten hinzugefügt.

Siehe auch removeState() und setInitialState().

bool QStateMachine::cancelDelayedEvent(int id)

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

Hinweis: Diese Funktion ist thread-sicher.

Siehe auch postDelayedEvent().

void QStateMachine::clearError()

Löscht den Fehlerstring und den Fehlercode des Zustandsautomaten.

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

Gibt die maximal konsistente Menge von Zuständen (einschließlich Parallel- und Endzuständen) zurück, in denen sich dieser Zustandsautomat gerade befindet. Wenn sich ein Zustand s in der Konfiguration befindet, ist es immer der Fall, dass sich der Elternteil von s auch in c befindet. Beachten Sie jedoch, dass der Automat selbst kein explizites Mitglied der Konfiguration ist.

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

Gibt die Liste der Standardanimationen zurück, die für jeden Übergang berücksichtigt werden.

QStateMachine::Error QStateMachine::error() const

Gibt den Fehlercode des letzten Fehlers zurück, der im Zustandsautomaten aufgetreten ist.

QString QStateMachine::errorString() const

Gibt den Fehlerstring des letzten Fehlers zurück, der im Zustandsautomaten aufgetreten ist.

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

Reimplements: QState::event(QEvent *e).

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

Reimplements: QObject::eventFilter(QObject *watched, QEvent *event).

QState::RestorePolicy QStateMachine::globalRestorePolicy() const

Gibt die Wiederherstellungsrichtlinie des Zustandsautomaten zurück.

Siehe auch setGlobalRestorePolicy().

bool QStateMachine::isAnimated() const

Gibt zurück, ob Animationen für diesen Zustandsautomaten aktiviert sind.

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

Reimplements: QState::onEntry(QEvent *event).

Diese Funktion ruft start() auf, um den Zustandsautomaten zu starten.

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

Reimplements: QState::onExit(QEvent *event).

Diese Funktion ruft stop() auf, um den Zustandsautomaten anzuhalten und anschließend das Signal stopped() auszusenden.

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

Sendet das angegebene event zur Verarbeitung durch diesen Zustandsautomaten, mit der angegebenen delay in Millisekunden. Gibt einen Bezeichner zurück, der mit dem verzögerten Ereignis verbunden ist, oder -1, wenn das Ereignis nicht gesendet werden konnte.

Diese Funktion kehrt sofort zurück. Wenn die Verzögerungszeit abgelaufen ist, wird das Ereignis zur Verarbeitung in die Ereigniswarteschlange des Zustandsautomaten aufgenommen. Der Zustandsautomat übernimmt die Verantwortung für das Ereignis und löscht es, sobald es verarbeitet wurde.

Sie können Ereignisse nur veröffentlichen, wenn der Zustandsautomat läuft.

Hinweis: Diese Funktion ist thread-sicher.

Siehe auch cancelDelayedEvent() und postEvent().

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

Dies ist eine überladene Funktion.

Sendet das angegebene event zur Verarbeitung durch diesen Zustandsautomaten, mit der angegebenen delay in Millisekunden. Gibt einen Bezeichner zurück, der mit dem verzögerten Ereignis verbunden ist, oder -1, wenn das Ereignis nicht gesendet werden konnte.

Diese Funktion kehrt sofort zurück. Wenn die Verzögerungszeit abgelaufen ist, wird das Ereignis zur Verarbeitung in die Ereigniswarteschlange des Zustandsautomaten aufgenommen. Der Zustandsautomat übernimmt die Verantwortung für das Ereignis und löscht es, sobald es verarbeitet wurde.

Sie können Ereignisse nur veröffentlichen, wenn der Zustandsautomat läuft.

Hinweis: Diese Funktion ist thread-sicher.

Siehe auch cancelDelayedEvent() und postEvent().

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

Sendet die angegebene event der angegebenen priority zur Verarbeitung durch diesen Zustandsautomaten.

Diese Funktion kehrt sofort zurück. Das Ereignis wird der Ereigniswarteschlange des Zustandsautomaten hinzugefügt. Die Ereignisse werden in der Reihenfolge ihres Eingangs verarbeitet. Der Zustandsautomat wird Eigentümer des Ereignisses und löscht es, sobald es abgearbeitet ist.

Sie können Ereignisse nur senden, wenn der Zustandsautomat läuft oder wenn er hochgefahren wird.

Hinweis: Diese Funktion ist thread-sicher.

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 diesem Zustandsautomaten. Der Zustandsautomat gibt das Eigentum an dem Zustand frei.

Siehe auch addState().

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

Dieses Signal wird ausgesendet, wenn die laufende Eigenschaft mit running als Argument geändert wird.

Siehe auch QStateMachine::running.

void QStateMachine::setAnimated(bool enabled)

Legt fest, ob Animationen für diesen Zustandsautomaten enabled sind.

Siehe auch isAnimated().

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

Setzt die Wiederherstellungsrichtlinie des Zustandsautomaten auf restorePolicy. Die Standardwiederherstellungsrichtlinie ist QState::DontRestoreProperties.

Siehe auch globalRestorePolicy().

[slot] void QStateMachine::start()

Startet diesen Zustandsautomaten. Der Rechner setzt seine Konfiguration zurück und geht in den Ausgangszustand über. Wenn ein endgültiger Top-Level-Zustand (QFinalState) erreicht ist, gibt der Automat das Signal finished() aus.

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

[private signal] void QStateMachine::started()

Dieses Signal wird ausgegeben, wenn der Zustandsautomat seinen Anfangszustand erreicht hat (QStateMachine::initialState).

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

[slot] void QStateMachine::stop()

Hält diesen Zustandsautomaten an. Der Zustandsautomat hält die Verarbeitung von Ereignissen an und gibt dann das Signal stopped() aus.

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

[private signal] void QStateMachine::stopped()

Dieses Signal wird ausgegeben, wenn der Zustandsautomat angehalten hat.

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