Qt开发：继承QGraphicsRectItem可实现keyPressEvent，组合方式失效求助

嘿，这个问题我太熟啦！当你用组合模式替代继承QGraphicsRectItem时，没法触发keyPressEvent的核心原因是Qt的事件分发逻辑——只有**QGraphicsItem（或其子类）**才能接收场景中的键盘事件，而且还得确保它获得了焦点。之前你用组合的时候，大概率是没处理好事件传递的路径，或者没给内部的矩形项设置可聚焦的属性。

我给你两种可行的组合模式实现方案，按需选择就行：

解决方案1：让Player继承QGraphicsItem（推荐） #

这种方式下，Player作为场景中的一个独立项，内部组合QGraphicsRectItem负责视觉呈现，Player自己处理键盘事件并控制移动。

Player.h #

#ifndef PLAYER_H
#define PLAYER_H

#include <QGraphicsItem>
#include <QGraphicsRectItem>

class Player : public QGraphicsItem
{
    Q_OBJECT
public:
    explicit Player(QGraphicsItem *parent = nullptr);

    // QGraphicsItem必须重写的纯虚函数
    QRectF boundingRect() const override;
    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override;

protected:
    void keyPressEvent(QKeyEvent *event) override;

private:
    QGraphicsRectItem *m_rectItem; // 组合的视觉项
    qreal m_moveSpeed = 5; // 移动速度
};

#endif // PLAYER_H

Player.cpp #

#include "Player.h"
#include <QKeyEvent>

Player::Player(QGraphicsItem *parent) : QGraphicsItem(parent)
{
    // 初始化内部矩形项，设置为Player的子项
    m_rectItem = new QGraphicsRectItem(QRectF(0, 0, 50, 50), this);
    m_rectItem->setBrush(Qt::blue);
    
    // 关键：必须设置这个标志才能接收键盘事件
    setFlag(QGraphicsItem::ItemIsFocusable);
    setFocus(); // 主动获取焦点，确保启动就能响应按键
}

QRectF Player::boundingRect() const
{
    // 返回Player的边界矩形，直接复用内部项的边界
    return m_rectItem->boundingRect();
}

void Player::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
{
    // 因为内部rectItem是子项，会自动被场景绘制，这里可以留空或添加额外绘制逻辑
    Q_UNUSED(painter);
    Q_UNUSED(option);
    Q_UNUSED(widget);
}

void Player::keyPressEvent(QKeyEvent *event)
{
    // 处理左右移动逻辑
    switch (event->key()) {
    case Qt::Key_Left:
        m_rectItem->setPos(m_rectItem->x() - m_moveSpeed, m_rectItem->y());
        break;
    case Qt::Key_Right:
        m_rectItem->setPos(m_rectItem->x() + m_moveSpeed, m_rectItem->y());
        break;
    default:
        // 其他事件交给父类处理
        QGraphicsItem::keyPressEvent(event);
        break;
    }
}

main.cpp #

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include "Player.h"

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    QGraphicsScene scene;
    Player* player = new Player();
    scene.addItem(player);

    QGraphicsView view(&scene);
    view.setSceneRect(0, 0, 800, 600);
    view.show();

    return a.exec();
}

解决方案2：用事件过滤器实现逻辑与视觉分离 #

如果你的Player只想做逻辑控制器，不想继承QGraphicsItem，可以给内部的QGraphicsRectItem安装事件过滤器，让Player来处理它的键盘事件。

Player.h #

#ifndef PLAYER_H
#define PLAYER_H

#include <QObject>
#include <QGraphicsRectItem>

class Player : public QObject
{
    Q_OBJECT
public:
    explicit Player(QObject *parent = nullptr);
    QGraphicsRectItem* getVisualItem() const;

protected:
    bool eventFilter(QObject *watched, QEvent *event) override;

private:
    QGraphicsRectItem *m_visualItem;
    qreal m_moveSpeed = 5;
};

#endif // PLAYER_H

Player.cpp #

#include "Player.h"
#include <QKeyEvent>

Player::Player(QObject *parent) : QObject(parent)
{
    m_visualItem = new QGraphicsRectItem(QRectF(0, 0, 50, 50));
    m_visualItem->setBrush(Qt::red);
    
    // 同样需要设置可聚焦并获取焦点
    m_visualItem->setFlag(QGraphicsItem::ItemIsFocusable);
    m_visualItem->setFocus();
    
    // 给视觉项安装事件过滤器，让Player接管事件处理
    m_visualItem->installEventFilter(this);
}

QGraphicsRectItem *Player::getVisualItem() const
{
    return m_visualItem;
}

bool Player::eventFilter(QObject *watched, QEvent *event)
{
    // 判断事件来源和类型
    if (watched == m_visualItem && event->type() == QEvent::KeyPress) {
        QKeyEvent* keyEvent = static_cast<QKeyEvent*>(event);
        switch (keyEvent->key()) {
        case Qt::Key_Left:
            m_visualItem->setPos(m_visualItem->x() - m_moveSpeed, m_visualItem->y());
            return true; // 标记事件已处理，不再传递
        case Qt::Key_Right:
            m_visualItem->setPos(m_visualItem->x() + m_moveSpeed, m_visualItem->y());
            return true;
        }
    }
    // 其他事件交给父类处理
    return QObject::eventFilter(watched, event);
}

main.cpp #

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include "Player.h"

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    QGraphicsScene scene;
    Player player;
    scene.addItem(player.getVisualItem());

    QGraphicsView view(&scene);
    view.setSceneRect(0, 0, 800, 600);
    view.show();

    return a.exec();
}

关键点总结 #

不管用哪种方案，都必须满足两个条件：

1. 负责视觉呈现的QGraphicsRectItem必须设置ItemIsFocusable标志；
2. 该矩形项必须获得焦点（通过setFocus()），否则键盘事件不会传递过来。

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