如何为QGraphicsItemGroup设置setFocus()属性以支持键盘事件控制？

要实现这个需求，核心是解决焦点获取和键盘事件处理两个关键点——默认的QGraphicsItemGroup并不具备接收键盘焦点和处理按键事件的能力，我们需要通过自定义子类来补足这些功能。下面是一步步的实现方法：

1. 自定义QGraphicsItemGroup子类 #

首先，继承QGraphicsItemGroup，在子类中配置焦点策略、设置必要的Item标志，并重写键盘事件处理函数：

#include <QGraphicsItemGroup>
#include <QKeyEvent>

class FocusableItemGroup : public QGraphicsItemGroup
{
public:
    FocusableItemGroup(QGraphicsItem* parent = nullptr) 
        : QGraphicsItemGroup(parent)
    {
        // 设置焦点策略为StrongFocus，确保能接收键盘焦点和事件
        setFocusPolicy(Qt::StrongFocus);
        // 开启可选中、可获取焦点的标志，支持点击选中并自动获取焦点
        setFlags(QGraphicsItem::ItemIsFocusable | QGraphicsItem::ItemIsSelectable);
    }

    // 重写boundingRect，确保点击区域覆盖所有子项
    QRectF boundingRect() const override
    {
        // 自动计算所有子项的组合边界，无需手动计算
        return childrenBoundingRect();
    }

protected:
    // 重写键盘按下事件，实现你的控制逻辑
    void keyPressEvent(QKeyEvent* event) override
    {
        switch (event->key())
        {
            case Qt::Key_Left:
                moveBy(-10, 0); // 左移10像素
                break;
            case Qt::Key_Right:
                moveBy(10, 0); // 右移10像素
                break;
            case Qt::Key_Up:
                moveBy(0, -10); // 上移10像素
                break;
            case Qt::Key_Down:
                moveBy(0, 10); // 下移10像素
                break;
            default:
                // 传递未处理的事件给父类，保证默认行为正常
                QGraphicsItemGroup::keyPressEvent(event);
                break;
        }
    }
};

2. 使用自定义Group并添加子项 #

接下来，创建这个自定义Group，添加你的三个QGraphicsRectItem，并将Group加入场景：

// 创建场景
QGraphicsScene* scene = new QGraphicsScene();

// 创建自定义焦点组
FocusableItemGroup* group = new FocusableItemGroup();

// 添加三个矩形子项
QGraphicsRectItem* rect1 = new QGraphicsRectItem(0, 0, 50, 50);
rect1->setBrush(Qt::red);
QGraphicsRectItem* rect2 = new QGraphicsRectItem(60, 0, 50, 50);
rect2->setBrush(Qt::green);
QGraphicsRectItem* rect3 = new QGraphicsRectItem(30, 60, 50, 50);
rect3->setBrush(Qt::blue);

group->addToGroup(rect1);
group->addToGroup(rect2);
group->addToGroup(rect3);

// 将Group加入场景
scene->addItem(group);

// 可选：手动设置焦点（也可以让用户点击Group来自动获取焦点）
group->setFocus();

// 关联到View并显示（假设你已有QGraphicsView实例）
QGraphicsView* view = new QGraphicsView(scene);
view->show();
// 确保View获取焦点，这样键盘事件能正常传递到场景中的Item
view->setFocus();

关键注意点 #

• 焦点策略：setFocusPolicy(Qt::StrongFocus)是让Item能接收键盘焦点的核心，它支持通过点击、代码调用等多种方式获取焦点；如果用Qt::ClickFocus则仅支持点击获取。
• Item标志：ItemIsFocusable确保Item可以成为焦点对象，ItemIsSelectable允许用户通过点击选中整个Group，进而自动获取焦点。
• boundingRect：重写该函数保证Group的点击区域覆盖所有子项，用户点击任何子项都能选中整个Group，childrenBoundingRect()是Qt提供的便捷方法，自动计算所有子项的组合边界。
• 事件传递：在keyPressEvent中处理完自定义逻辑后，记得调用父类的实现，保证未处理的按键能正常传递。

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