QML状态机无QKeyEventTransition替代类型，如何实现按键事件状态切换？

QtWidgets里的QKeyEventTransition确实没有直接对应的QML原生类型，但可以通过两种实用方式实现相同的按键触发状态转换效果：

方法一：用KeyPressHandler + SignalTransition #

这是最简便的纯QML方案，借助KeyPressHandler捕获按键事件，再通过SignalTransition将按键信号绑定到状态转换逻辑。

示例代码：

import QtQuick 2.15
import QtQuick.Controls 2.15
import QtQml.StateMachine 1.0

Rectangle {
    width: 200
    height: 200
    color: stateMachine.currentState.name === "stateA" ? "red" : "blue"

    // 捕获空格键的处理器
    KeyPressHandler {
        id: spaceKeyHandler
        keys: Qt.Key_Space
        signal spacePressed()
        onPressed: spacePressed()
    }

    // 状态机核心逻辑
    StateMachine {
        id: stateMachine
        initialState: stateA

        State {
            id: stateA
            name: "stateA"
            // 绑定按键信号到状态转换
            SignalTransition {
                signal: spaceKeyHandler.spacePressed
                targetState: stateB
            }
        }

        State {
            id: stateB
            name: "stateB"
            SignalTransition {
                signal: spaceKeyHandler.spacePressed
                targetState: stateA
            }
        }
    }

    Component.onCompleted: stateMachine.start()
}

如果需要过滤修饰键（如Ctrl、Shift）或区分按键按下/释放，可在KeyPressHandler的回调里添加判断：

KeyPressHandler {
    id: enterKeyHandler
    keys: Qt.Key_Enter
    signal ctrlEnterPressed()
    onPressed: {
        if (event.modifiers & Qt.ControlModifier) {
            ctrlEnterPressed()
        }
    }
}

方法二：封装C++的QKeyEventTransition #

如果需要更贴近QtWidgets原生行为，或处理复杂按键逻辑，可以自定义QML类型封装C++的QKeyEventTransition：

1. 创建C++封装类：

#include <QKeyEventTransition>
#include <QObject>

class QmlKeyEventTransition : public QKeyEventTransition
{
    Q_OBJECT
    Q_PROPERTY(int key READ key WRITE setKey)
    Q_PROPERTY(QEvent::Type eventType READ eventType WRITE setEventType)
public:
    explicit QmlKeyEventTransition(QObject* parent = nullptr)
        : QKeyEventTransition(parent, QEvent::KeyPress, 0) {}

    int key() const { return QKeyEventTransition::key(); }
    void setKey(int key) { QKeyEventTransition::setKey(key); }

    QEvent::Type eventType() const { return QKeyEventTransition::eventType(); }
    void setEventType(QEvent::Type type) { QKeyEventTransition::setEventType(type); }
};

2. 在main函数注册QML类型：

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include "qmlkeyeventtransition.h"

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    qmlRegisterType<QmlKeyEventTransition>("CustomStateMachine", 1, 0, "KeyEventTransition");

    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    if (engine.rootObjects().isEmpty())
        return -1;

    return app.exec();
}

3. QML中使用自定义类型：

import QtQuick 2.15
import QtQml.StateMachine 1.0
import CustomStateMachine 1.0

Rectangle {
    width: 200
    height: 200
    color: stateMachine.currentState.name === "stateA" ? "green" : "yellow"

    StateMachine {
        id: stateMachine
        initialState: stateA

        State {
            id: stateA
            name: "stateA"
            KeyEventTransition {
                key: Qt.Key_Escape
                eventType: QEvent.KeyPress
                targetState: stateB
            }
        }

        State {
            id: stateB
            name: "stateB"
            KeyEventTransition {
                key: Qt.Key_Escape
                eventType: QEvent.KeyPress
                targetState: stateA
            }
        }
    }

    Component.onCompleted: stateMachine.start()
}

两种方案各有侧重：方法一纯QML实现，快速轻量；方法二更贴近原生API，适合复杂场景，可按需选择。

内容的提问来源于stack exchange，提问作者ManuelSchneid3r