自定义QSplitter右侧部件隐藏时，手柄按钮未消失问题求助

自定义实现了基于QWidget/QSplitter的可折叠分割器，遇到以下问题：

• 使用QWidget::hide()或show()切换右侧小部件可见性时，其对应的手柄按钮不会消失；左侧小部件切换时无此问题。
• 替换右侧小部件为其他类型（如第二个QTreeView），问题依旧。

该分割器容器包含TrueSplitter（QSplitter子类）及每个可见QSplitterHandle对应的QPushButton，负责协调按钮与分割器的联动。

核心逻辑说明 #

1. Splitter类的按钮可见性控制 #

通过元信息结构体Meta存储每个部件的按钮关联信息，监听TrueSplitter的信号切换按钮显示：

struct Meta {
        int widgetIndex;
        std::optional<QPushButton*> handleButton;
        State state = State::Expanded;
        int expandedWidth = -1;
        QPushButton* button() { return handleButton.has_value() ? handleButton.value() : nullptr; }
    };

构造函数中连接信号：

Splitter(Qt::Orientation orientation, QVector<QWidget*> widgets, QWidget* parent)
        : QWidget(parent)
    {
        /* 其他初始化逻辑 */
        connect(m_trueSplitter, &TrueSplitter::widgetVisibilityChanged, this, &Splitter::showOrHideButtons);
    }

处理信号的槽函数：

void showOrHideButtons(int widgetIndex, TrueSplitter::WidgetWas visibility)
    {
        for (auto& m_meta : m_metas) {
            if (m_meta.widgetIndex != widgetIndex) continue;
            auto button = m_meta.button();
            if (button == nullptr) continue;
            (visibility == TrueSplitter::WidgetWas::Hidden) ? button->hide() : button->show();
        }
    }

2. TrueSplitter的事件监听逻辑 #

通过给子部件安装事件过滤器，捕获Show/Hide事件并触发信号：

class TrueSplitter : public QSplitter
{
    Q_OBJECT

public:
    enum class WidgetWas {
        Hidden,
        Shown
    };

    TrueSplitter(QWidget* parent) : QSplitter(parent) {}

signals:
    void resized();
    void widgetVisibilityChanged(int widgetIndex, WidgetWas visibility);

protected:
    virtual void childEvent(QChildEvent* event) override
    {
        if (event->type() == QEvent::ChildAdded && event->child()->isWidgetType())
            installFilters();
        QSplitter::childEvent(event);
    }

    virtual bool eventFilter(QObject* object, QEvent* event) override
    {
        if (event->type() == QEvent::Show || event->type() == QEvent::Hide) {
            for (auto i = 0; i < count(); ++i) {
                if (!widget(i)->isVisible()) {
                    emit widgetVisibilityChanged(i, WidgetWas::Hidden);
                    qDebug() << "!!!" << widget(i) << ": eventFilter widgetVisibilityChanged signal (Hidden)";
                }
                else {
                    emit widgetVisibilityChanged(i, WidgetWas::Shown);
                    qDebug() << "!!!" << widget(i) << ": eventFilter widgetVisibilityChanged signal (Shown)";
                }
            }
            
            for (int i = 0; i < count(); ++i) {
                auto widget = this->widget(i);
                (widget == nullptr)
                    ? qDebug() << "Widget at index" << i << "has been removed from the QSplitter"
                    : qDebug() << "Widget at index" << i << "is still a child of the QSplitter";
            }
        }
        return QSplitter::eventFilter(object, event);
    }

    virtual void resizeEvent(QResizeEvent* event) override
    {
        QSplitter::resizeEvent(event);
        emit resized();
    }

    virtual QSplitterHandle* createHandle() override { return new SplitterHandle(orientation(), this); }

private:
    void installFilters()
    {
        for (auto i = 0; i < count(); ++i)
            widget(i)->installEventFilter(this);
    }
};

1. 检查信号槽的索引匹配问题 #

• 在showOrHideButtons函数开头添加日志，输出接收到的widgetIndex以及m_metas中所有存储的widgetIndex值，确认右侧部件的索引是否与元信息中的索引匹配。QSplitter的部件索引可能在隐藏/显示操作后发生变化，导致信号触发时找不到对应的按钮。
• 验证m_metas的更新逻辑：当QSplitter内部件顺序或可见性变化时，是否同步更新了元信息中的widgetIndex。

2. 修正事件过滤器的信号触发逻辑 #

当前事件过滤器在捕获Show/Hide事件时会遍历所有部件并逐个发送信号，容易导致重复触发或错误信号（比如隐藏右侧部件时，遍历到其他可见部件会发送Shown信号，覆盖之前的操作）。修改为仅针对触发事件的部件发送信号：

virtual bool eventFilter(QObject* object, QEvent* event) override
{
    if (event->type() == QEvent::Show || event->type() == QEvent::Hide) {
        QWidget* targetWidget = qobject_cast<QWidget*>(object);
        if (!targetWidget) return QSplitter::eventFilter(object, event);
        
        int index = indexOf(targetWidget);
        if (index == -1) return QSplitter::eventFilter(object, event);
        
        auto visibility = (event->type() == QEvent::Hide) ? WidgetWas::Hidden : WidgetWas::Shown;
        emit widgetVisibilityChanged(index, visibility);
        qDebug() << "!!!" << targetWidget << ": eventFilter widgetVisibilityChanged signal" << (visibility == WidgetWas::Hidden ? "(Hidden)" : "(Shown)");
    }
    return QSplitter::eventFilter(object, event);
}

3. 验证按钮的可见性操作是否生效 #

在showOrHideButtons中添加日志，确认按钮是否存在、hide()/show()是否被执行，以及执行后的可见性状态：

void showOrHideButtons(int widgetIndex, TrueSplitter::WidgetWas visibility)
{
    qDebug() << "Received signal for index:" << widgetIndex << ", visibility:" << (visibility == TrueSplitter::WidgetWas::Hidden ? "Hidden" : "Shown");
    for (auto& m_meta : m_metas) {
        qDebug() << "Meta index:" << m_meta.widgetIndex;
        if (m_meta.widgetIndex != widgetIndex) continue;
        auto button = m_meta.button();
        if (button == nullptr) {
            qDebug() << "Button is null for index:" << widgetIndex;
            continue;
        }
        qDebug() << "Button before:" << button << ", visible:" << button->isVisible();
        (visibility == TrueSplitter::WidgetWas::Hidden) ? button->hide() : button->show();
        qDebug() << "Button after:" << button << ", visible:" << button->isVisible();
    }
}

如果日志显示按钮已被设置为隐藏但仍可见，需检查按钮的父部件可见性、层级（是否被其他部件遮挡），或者是否存在强制设置按钮可见性的逻辑。

4. 检查手柄与按钮的关联逻辑 #

• 确认SplitterHandle（自定义手柄）与按钮的绑定是否正确，右侧部件对应的手柄按钮是否被正确存入m_metas。
• 检查m_metas的初始化流程，确认右侧部件的handleButton没有出现空指针或错误关联的情况。

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