Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

SCXML-Ampel (einfach, QML)

Eine „ Qt Quick “-Anwendung, die eine kompilierte Zustandsmaschine verwendet, um eine vereinfachte Ampel zu implementieren.

Ampel, bei der das grüne Licht leuchtet

„Traffic Light“ veranschaulicht, wie man eine Verbindung zu den aktiven Eigenschaften eines Zustands in einer Zustandsmaschine herstellt, die zu einer Klasse kompiliert wurde.

Die Benutzeroberfläche wird mit „ Qt Quick “ erstellt.

Ausführen des Beispiels

Sie können das Beispiel wie folgt ausführen:

Kompilieren der Zustandsmaschine

Wir verknüpfen das Modul „ Qt SCXML “, indem wir die folgenden Zeilen in die Build-Dateien des Beispiels einfügen.

.pro bei Verwendung von qmake:
QT += qml scxml

Anschließend geben wir die zu kompilierende Zustandsmaschine an:

STATECHARTS = statemachine.scxml
CMakeLists.txt bei Verwendung von cmake:
find_package(Qt6 REQUIRED COMPONENTS Core Gui Qml Scxml)
target_link_libraries(trafficlight-qml-simple PRIVATE
    Qt::Core
    Qt::Gui
    Qt::Qml
    Qt::Scxml
)

Anschließend geben wir die zu kompilierende Zustandsmaschine an:

qt6_add_statecharts(trafficlight-qml-simple
    statemachine.scxml
)

Die Statechart-Direktiven STATECHARTS oder qt6_add_statecharts rufen den „ Qt SCXML Compiler“ auf ( qscxmlc), der automatisch ausgeführt wird, um die Dateien statemachine.h und statemachine.cpp zu generieren, die anschließend entsprechend als Header- und Quelldateien für die Kompilierung hinzugefügt werden.

Instanziierung der Zustandsmaschine

Wir instanziieren die Zustandsmaschine wie folgt:

    TrafficLightStateMachine {
        id: stateMachine
        running: true
    }

Verbindung zu den Zuständen

In der SCXML-Datei legen wir für jede Ampel die Zustände „rot“, „gelb“ und „grün“ fest. Im Element „ <onentry> “ geben wir das Ereignis an, das beim Eintritt in den Zustand gesendet werden soll, sowie die Verzögerung in Sekunden vor dem Senden des Ereignisses. Im Element „ <transition> “ legen wir das Ereignis fest, das den Übergang in den durch das Attribut „ target “ angegebenen Zustand auslöst:

        <state id="red">
            <onentry>
                <send event="startGoingGreen" delay="3s"/>
            </onentry>
            <transition event="startGoingGreen" target="redGoingGreen"/>
        </state>

        <state id="yellow" initial="greenGoingRed">
            <state id="redGoingGreen">
                <onentry>
                    <send event="goGreen" delay="1s"/>
                </onentry>
                <transition event="goGreen" target="green"/>
            </state>

            <state id="greenGoingRed">
                <onentry>
                    <send event="goRed" delay="1s"/>
                </onentry>
                <transition event="goRed" target="red"/>
            </state>
        </state>

        <state id="green">
            <onentry>
                <send event="startGoingRed" delay="3s"/>
            </onentry>
            <transition event="startGoingRed" target="greenGoingRed"/>
        </state>

Wir verbinden die Zustände wie folgt:

        Light {
            anchors.top: parent.top
            anchors.horizontalCenter: parent.horizontalCenter
            color: "red"
            visible: stateMachine.red || stateMachine.redGoingGreen
        }

        Light {
            anchors.centerIn: parent
            color: "yellow"
            visible: stateMachine.yellow || stateMachine.blinking
        }

        Light {
            anchors.bottom: parent.bottom
            anchors.horizontalCenter: parent.horizontalCenter
            color: "green"
            visible: stateMachine.green
        }
    }

Beispielprojekt @ code.qt.io

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