这个问题我之前也碰到过，核心原因是QGraphicsItem的键盘事件依赖于item本身拥有焦点——当你点击窗口外部时，整个Qt窗口会失去系统焦点；等你再点回窗口时，焦点默认不会自动回到你的rectangle item上，自然就接收不到键盘事件了。下面给你一步步的解决方案：

1. 让你的rectangle item具备获取焦点的资格 #

首先要在rectangle的构造函数里开启ItemIsFocusable标志，这是item能接收键盘事件的前提：

rectangle::rectangle()
{
    // 开启焦点可获取标志，让item有资格接收键盘事件
    setFlag(QGraphicsItem::ItemIsFocusable);
    // 其他初始化代码（比如设置矩形大小、样式等）
}

2. 确保item能重新获得焦点 #

有两种常见的方式来处理焦点恢复场景：

方式一：点击item时主动获取焦点 #

给rectangle类添加mousePressEvent的重写，当用户点击item时，让它主动抢占焦点：

// 头文件里添加声明
void mousePressEvent(QGraphicsSceneMouseEvent *event) override;

// cpp文件实现
void rectangle::mousePressEvent(QGraphicsSceneMouseEvent *event)
{
    setFocus(); // 点击item时主动获取焦点
    QGraphicsRectItem::mousePressEvent(event); // 别忘了调用父类的默认实现
}

这样用户点击item后，它就会持有焦点，键盘事件就能正常触发了。

方式二：窗口重新获焦时让item自动获焦 #

如果希望用户点击窗口空白处也能让item恢复焦点，可以给你的QGraphicsView或者主窗口重写focusInEvent，在窗口重新获得系统焦点时，主动让目标item获取焦点：

// 假设你的视图类是MyView，继承自QGraphicsView
void MyView::focusInEvent(QFocusEvent *event)
{
    QGraphicsView::focusInEvent(event);
    // 找到你的rectangle item实例并设置焦点
    if (myRectangleItem) {
        myRectangleItem->setFocus();
    }
}

3. 验证键盘事件的传递链路 #

还要确保你的QGraphicsScene和QGraphicsView没有拦截键盘事件。默认情况下，view会把键盘事件传递给scene，scene再传递给有焦点的item；但如果你的view或者scene重写了keyPressEvent却没有调用父类实现，就会导致事件无法传递下去。

比如如果你的view重写了keyPressEvent，一定要加上：

void MyView::keyPressEvent(QKeyEvent *event)
{
    QGraphicsView::keyPressEvent(event); // 让事件继续传递给scene和item
    // 你的其他自定义处理代码...
}

完整代码示例 #

头文件 #

#include <QObject>
#include <QGraphicsRectItem>
#include <QKeyEvent>
#include <QGraphicsSceneMouseEvent>

class rectangle : public QObject, public QGraphicsRectItem
{
    Q_OBJECT // 继承QObject必须添加这个宏
public:
    rectangle();
    void keyPressEvent(QKeyEvent *event) override;
    void mousePressEvent(QGraphicsSceneMouseEvent *event) override;
};

cpp文件 #

#include "rectangle.h"

rectangle::rectangle()
{
    setFlag(QGraphicsItem::ItemIsFocusable);
    // 设置默认样式，方便区分焦点状态
    setPen(QPen(Qt::red));
    setBrush(QBrush(Qt::lightGray));
    setRect(0, 0, 100, 100); // 设置矩形大小
}

void rectangle::keyPressEvent(QKeyEvent *event)
{
    if (event->key() == Qt::Key_Space) {
        // 空格键触发的自定义逻辑，比如向右移动item
        moveBy(10, 0);
    }
    QGraphicsRectItem::keyPressEvent(event); // 调用父类实现，保证事件传递
}

void rectangle::mousePressEvent(QGraphicsSceneMouseEvent *event)
{
    setFocus();
    // 焦点状态下切换样式，方便可视化区分
    setPen(QPen(Qt::blue));
    QGraphicsRectItem::mousePressEvent(event);
}

这样修改后，即使你点击窗口外部再回来，只要点击一下你的rectangle item，或者通过窗口焦事件自动设置，键盘事件就能正常响应了。

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