Qt Designer开发类QTabWidget自定义插件时QListView点击无效如何解决

问题根因 #

该问题由Qt Designer的内置机制触发，核心原因有两个：

• 你给QListView设置的objectName带__qt__passive_前缀，这是Qt Designer的专属标记，代表该控件是「被动交互控件」，Designer会拦截所有发往该控件的鼠标/键盘事件，仅允许选中父级自定义控件
• 自定义控件默认未开启Designer模式下的交互权限，所有子控件事件会被Designer的全局事件过滤器捕获，无法下发到子控件

解决方案 #

1. 移除listView的被动标记 #

修改构造函数中listView的objectName配置，删掉__qt__passive_前缀：

MultiPageWidget::MultiPageWidget(QWidget *parent)
: QWidget(parent)
, stackWidget(new QStackedWidget)
, listView (new QListView)
, listModel (new ListModel)
{
    // 删除带被动标记的命名，替换为普通命名
    // listView->setObjectName(QStringLiteral("__qt__passive_listView"));
    listView->setObjectName(QStringLiteral("listView"));
    listView->setEditTriggers(QAbstractItemView::NoEditTriggers);
    listView->setModel(listModel);
    
    connect(listView, SIGNAL(clicked(QModelIndex)), this, SLOT(setCurrentIndex(QModelIndex)));
    QHBoxLayout *layout = new QHBoxLayout(this);
    layout->addWidget(listView,1);
    layout->addWidget(stackWidget,2);
}

2. 开启自定义控件的Designer交互权限 #

在MultiPageWidget类的定义开头，添加Qt Designer交互许可的标记，同时确保槽函数实现逻辑正确：

class MultiPageWidget : public QWidget
{
    Q_OBJECT
    // 新增这行配置，允许Designer中该控件接收交互事件
    Q_CLASSINFO("DesignerInteractionEnabled", "true")
public:
    explicit MultiPageWidget(QWidget *parent = nullptr);
    // 其余原有方法定义保留
private slots:
    // 确保该槽函数已正确实现，把列表索引转换为堆叠控件的页面序号
    void setCurrentIndex(const QModelIndex &index) {
        if (index.isValid()) {
            stackWidget->setCurrentIndex(index.row());
            // 可选：对外暴露页面切换信号，方便上层业务绑定逻辑
            emit pageChanged(index.row());
        }
    }
signals:
    void pageChanged(int index);
private:
    QStackedWidget *stackWidget;
    QListView *listView;
    ListModel *listModel;
};

3. 替换为Qt5新信号槽语法（可选推荐） #

把构造函数里的老宏信号槽连接替换为编译期检查的新语法，避免信号槽拼写错误导致连接失败：

connect(listView, &QListView::clicked, this, &MultiPageWidget::setCurrentIndex);

4. 插件配置无需调整 #

你现有的domXml()配置已经符合要求，不需要额外修改。所有修改完成后重新编译插件，放到Qt Creator的插件目录，重启Qt Creator即可生效，在Designer中点击列表项就能直接切换右侧页面，和QTabWidget的交互体验一致。

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