Qt中CustomSelector子部件Tab顺序异常，如何正确设置？

核心原因 #

自定义部件CustomSelector作为容器时，Qt默认不会自动将其动态生成的子部件纳入全局Tab遍历链——UI设计器仅能设置静态部件的Tab顺序，动态子部件需要手动整合到焦点逻辑中。而QWidget::setFocusProxy()仅能将焦点代理到单个部件，无法处理多动态子部件的遍历需求，因此无效。

解决方案 #

1. 重载CustomSelector的focusNextPrevChild方法 #

这是最可靠的方案，让自定义容器自主管理内部子部件的焦点切换，同时融入全局Tab链：

bool CustomSelector::focusNextPrevChild(bool next)
{
    // 筛选出可见、可用且允许获取焦点的子部件
    QList<QWidget*> focusableChildren;
    for (QWidget* child : findChildren<QWidget*>()) {
        if (child->isVisible() && child->isEnabled() && child->focusPolicy() != Qt::NoFocus) {
            focusableChildren.append(child);
        }
    }

    if (focusableChildren.isEmpty()) {
        // 无可用子部件时，交由父类处理全局Tab切换
        return QWidget::focusNextPrevChild(next);
    }

    // 定位当前获得焦点的子部件
    QWidget* currentFocus = focusWidget();
    int currentIndex = focusableChildren.indexOf(currentFocus);

    // 计算下一个要聚焦的部件索引
    int nextIndex = next 
        ? (currentIndex + 1) % focusableChildren.size() 
        : (currentIndex - 1 + focusableChildren.size()) % focusableChildren.size();

    // 切换焦点到目标部件
    focusableChildren[nextIndex]->setFocus(Qt::TabFocusReason);
    return true;
}

当用户按下Tab/Shift+Tab时，该方法会优先处理CustomSelector内部的焦点遍历，遍历完所有子部件后，才会触发全局Tab链的切换。

2. 动态维护子部件的全局Tab顺序（补充方案） #

如果需要让动态子部件完全融入全局Tab链（而非在容器内循环），可在子部件创建后调用QWidget::setTabOrder()构建关联：

// 在CustomSelector中创建动态子部件后执行
QWidget* prevWidget = nullptr;
// dynamicWidgets为存储动态子部件的列表
for (QWidget* widget : dynamicWidgets) {
    if (prevWidget) {
        setTabOrder(prevWidget, widget);
    }
    prevWidget = widget;
}

// 将CustomSelector的前序部件与第一个动态子部件关联
QWidget* parentWidget = this->parentWidget();
QList<QWidget*> parentFocusable = parentWidget->findChildren<QWidget*>(QString(), Qt::FindDirectChildrenOnly);
int selectorIndex = parentFocusable.indexOf(this);
if (selectorIndex > 0 && !dynamicWidgets.isEmpty()) {
    QWidget* parentPrev = parentFocusable[selectorIndex - 1];
    setTabOrder(parentPrev, dynamicWidgets.first());
}

// 将最后一个动态子部件与CustomSelector的后序部件关联
if (selectorIndex < parentFocusable.size() - 1 && !dynamicWidgets.isEmpty()) {
    QWidget* parentNext = parentFocusable[selectorIndex + 1];
    setTabOrder(dynamicWidgets.last(), parentNext);
}

该方式让动态子部件像静态部件一样参与全局Tab遍历，但需注意：每次新增动态子部件后，都要重新执行上述逻辑。

3. 调整CustomSelector的焦点策略 #

确保CustomSelector本身能被纳入Tab链，在构造函数中设置：

setFocusPolicy(Qt::StrongFocus);

注意事项 #

• 每次动态生成子部件后，需重新触发Tab顺序维护逻辑，否则新部件无法被纳入焦点链。
• 若子部件存在嵌套容器，需确保每个容器都正确处理焦点传递，避免焦点被拦截。

内容的提问来源于stack exchange，提问作者Сергей Генин