如何解决QGraphicsItemGroup中输入控件无法交互的问题

在QGraphicsItemGroup中添加QLineEdit、QSlider等输入控件后，控件可正常显示且组能拖动，但无法与控件交互——这是因为QGraphicsItemGroup默认会拦截子项的事件，导致焦点无法传递到子控件。需要通过自定义事件处理，实现组整体移动的同时，让点击的子控件获得焦点并响应交互。

极简复现代码 #

QSlider* slider_ = new QSlider(Qt::Horizontal);
QGraphicsProxyWidget* slider_item_ = new QGraphicsProxyWidget();
slider_item_->setWidget(slider_);

qreal sliderX = 0;
qreal sliderY = 0;
slider_item_->setPos(sliderX, sliderY);

QGraphicsItemGroup* tile_group_ = new QGraphicsItemGroup();
tile_group_->setFlags(QGraphicsItemGroup::ItemIsMovable | QGraphicsItemGroup::ItemIsFocusable | QGraphicsItemGroup::ItemIsSelectable);

tile_group_->addToGroup(slider_item_);

scene = new QGraphicsScene(this);
scene->addItem(tile_group_);

解决方案 #

核心思路是自定义QGraphicsItemGroup子类，重写事件处理函数，区分点击的是子控件还是组的空白区域：点击子控件时转发事件并让其获得焦点，点击空白区域时处理组的拖动逻辑。

1. 自定义MyGraphicsItemGroup类 #

#include <QGraphicsItemGroup>
#include <QGraphicsSceneMouseEvent>
#include <QGraphicsProxyWidget>

class MyGraphicsItemGroup : public QGraphicsItemGroup
{
public:
    using QGraphicsItemGroup::QGraphicsItemGroup;

protected:
    void mousePressEvent(QGraphicsSceneMouseEvent *event) override
    {
        // 定位点击位置对应的子项
        QGraphicsItem* clickedItem = itemAt(event->pos(), QTransform());
        if (clickedItem && clickedItem->type() == QGraphicsProxyWidget::Type)
        {
            // 让子控件代理获得焦点，并转发点击事件
            auto proxyWidget = static_cast<QGraphicsProxyWidget*>(clickedItem);
            proxyWidget->setFocus();
            clickedItem->mousePressEvent(event);
        }
        else
        {
            // 点击组空白区域，执行默认的组拖动逻辑
            QGraphicsItemGroup::mousePressEvent(event);
        }
    }

    void mouseMoveEvent(QGraphicsSceneMouseEvent *event) override
    {
        // 仅当没有子控件获得焦点时，处理组的拖动
        QGraphicsItem* focusedItem = focusItem();
        if (!focusedItem || focusedItem->type() != QGraphicsProxyWidget::Type)
        {
            QGraphicsItemGroup::mouseMoveEvent(event);
        }
    }
};

2. 修改原代码使用自定义组 #

将原代码中的QGraphicsItemGroup替换为MyGraphicsItemGroup，同时给子控件代理添加焦点和选中标志：

QSlider* slider_ = new QSlider(Qt::Horizontal);
QGraphicsProxyWidget* slider_item_ = new QGraphicsProxyWidget();
slider_item_->setWidget(slider_);
// 给代理项添加焦点和选中标志，确保能接收事件
slider_item_->setFlags(QGraphicsItem::ItemIsFocusable | QGraphicsItem::ItemIsSelectable);

qreal sliderX = 0;
qreal sliderY = 0;
slider_item_->setPos(sliderX, sliderY);

// 使用自定义的组类
MyGraphicsItemGroup* tile_group_ = new MyGraphicsItemGroup();
tile_group_->setFlags(QGraphicsItemGroup::ItemIsMovable | QGraphicsItemGroup::ItemIsFocusable | QGraphicsItemGroup::ItemIsSelectable);

tile_group_->addToGroup(slider_item_);

scene = new QGraphicsScene(this);
scene->addItem(tile_group_);

3. 额外注意事项 #

• 确保承载场景的QGraphicsView开启交互：view->setInteractive(true);
• 对于需要键盘输入的控件（如QLineEdit），可在自定义组中重写keyPressEvent，将事件转发给当前获得焦点的子控件代理：

void keyPressEvent(QKeyEvent *event) override
{
    QGraphicsItem* focusedItem = focusItem();
    if (focusedItem && focusedItem->type() == QGraphicsProxyWidget::Type)
    {
        static_cast<QGraphicsProxyWidget*>(focusedItem)->keyPressEvent(event);
    }
    else
    {
        QGraphicsItemGroup::keyPressEvent(event);
    }
}

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