QTreeWidget项遍历与测试步骤UI切换联动问题求助

原代码的核心问题在于未正确处理QTreeWidget的层级结构，且用局部行号作为哈希表索引的逻辑完全错误，导致步骤切换与表单匹配完全混乱。以下是具体问题点和修正方案：

原代码的关键问题 #

• 用currentTestStep.row() + 1作为哈希表key：QTreeWidget的row是当前父节点下的局部行号，并非全局步骤索引，父项与子项的row独立计数，该逻辑不成立。
• itemBelow()判断逻辑错误：当当前项是父项（如Test2），itemBelow()会直接跳到Test3，但实际应进入Test2的第一个子项TestA。
• 表单切换依赖错误索引：y值是局部行号，与哈希表的全局key不匹配，导致表单与选中测试项对应不上。
• 未处理子项的兄弟切换：TestA完成后，无逻辑选中同层级的TestB。

修正方案 #

步骤1：给每个TreeWidgetItem绑定对应表单索引 #

初始化QTreeWidget时，给每个需显示表单的测试项（含子项）用setData()绑定哈希表key，父项无需绑定（直接跳转至子项）：

// 创建Test1项
QTreeWidgetItem* test1Item = new QTreeWidgetItem(ui->treeWidget);
test1Item->setText(0, "Test 1");
test1Item->setData(0, Qt::UserRole, 0); // 绑定哈希表key=0，对应Test1FormObj

// 创建Test2父项及子项
QTreeWidgetItem* test2Item = new QTreeWidgetItem(ui->treeWidget);
test2Item->setText(0, "Test 2");
QTreeWidgetItem* test2AItem = new QTreeWidgetItem(test2Item);
test2AItem->setText(0, "Test A");
test2AItem->setData(0, Qt::UserRole, 1); // 绑定key=1，对应Test2AFormObj
QTreeWidgetItem* test2BItem = new QTreeWidgetItem(test2Item);
test2BItem->setText(0, "Test B");
test2BItem->setData(0, Qt::UserRole, 2); // 绑定key=2，对应Test2BFormObj

// 同理处理Test3、Test4及其子项
QTreeWidgetItem* test3Item = new QTreeWidgetItem(ui->treeWidget);
test3Item->setText(0, "Test 3");
test3Item->setData(0, Qt::UserRole, 3);

QTreeWidgetItem* test4Item = new QTreeWidgetItem(ui->treeWidget);
test4Item->setText(0, "Test 4");
QTreeWidgetItem* test4AItem = new QTreeWidgetItem(test4Item);
test4AItem->setText(0, "Test A");
test4AItem->setData(0, Qt::UserRole, 4);
QTreeWidgetItem* test4BItem = new QTreeWidgetItem(test4Item);
test4BItem->setText(0, "Test B");
test4BItem->setData(0, Qt::UserRole, 5);

步骤2：实现正确的“下一步”切换逻辑 #

重写on_Next_btn_clicked()函数，按层级规则查找下一个测试项：

void on_Next_btn_clicked() 
{
    QTreeWidgetItem* currentItem = ui->treeWidget->currentItem();
    if (!currentItem) return;

    QTreeWidgetItem* nextItem = nullptr;

    // 情况1：当前是父项，展开并选中第一个子项
    if (currentItem->childCount() > 0 && !currentItem->isExpanded()) {
        currentItem->setExpanded(true);
        nextItem = currentItem->child(0);
    } 
    // 情况2：当前是子项，先找同层级下一个兄弟
    else if (currentItem->parent() != nullptr) {
        QTreeWidgetItem* parentItem = currentItem->parent();
        int currentRow = parentItem->indexOfChild(currentItem);
        // 存在下一个兄弟项
        if (currentRow < parentItem->childCount() - 1) {
            nextItem = parentItem->child(currentRow + 1);
        } 
        // 无兄弟项，跳转至父项的下一个兄弟
        else {
            int parentRow = ui->treeWidget->indexOfTopLevelItem(parentItem);
            if (parentRow < ui->treeWidget->topLevelItemCount() - 1) {
                QTreeWidgetItem* nextParent = ui->treeWidget->topLevelItem(parentRow + 1);
                nextItem = nextParent->childCount() > 0 ? nextParent->child(0) : nextParent;
            }
        }
    } 
    // 情况3：当前是顶层无父子项，跳转至下一个顶层项
    else {
        int currentRow = ui->treeWidget->indexOfTopLevelItem(currentItem);
        if (currentRow < ui->treeWidget->topLevelItemCount() - 1) {
            QTreeWidgetItem* nextTopItem = ui->treeWidget->topLevelItem(currentRow + 1);
            nextItem = nextTopItem->childCount() > 0 ? nextTopItem->child(0) : nextTopItem;
        }
    }

    // 选中下一项并切换表单
    if (nextItem) {
        ui->treeWidget->setCurrentItem(nextItem);
        int formKey = nextItem->data(0, Qt::UserRole).toInt();
        if (treeFormHash.contains(formKey)) {
            // 隐藏并移除当前表单
            QWidget* currentForm = ui->verticalLayout->itemAt(0)->widget();
            if (currentForm) {
                currentForm->setVisible(false);
                ui->verticalLayout->removeWidget(currentForm);
            }
            // 显示目标表单
            QWidget* targetForm = treeFormHash[formKey];
            targetForm->setVisible(true);
            ui->verticalLayout->insertWidget(0, targetForm);
        }
    }
}

步骤3：初始化默认显示第一个表单 #

构造函数中添加默认选中与表单显示逻辑：

// 保留原哈希表初始化代码
treeFormHash.insert(0,  Test1FormObj);
treeFormHash.insert(1,  Test2AFormObj);
treeFormHash.insert(2,  Test2BFormObj);
treeFormHash.insert(3,  Test3FormObj);
treeFormHash.insert(4,  Test4AFormObj);
treeFormHash.insert(5,  Test4BFormObj);

// 默认选中第一个项并显示对应表单
ui->treeWidget->setCurrentItem(ui->treeWidget->topLevelItem(0));
int firstKey = ui->treeWidget->currentItem()->data(0, Qt::UserRole).toInt();
QWidget* firstForm = treeFormHash[firstKey];
firstForm->setVisible(true);
ui->verticalLayout->insertWidget(0, firstForm);

额外注意事项 #

• 确保所有表单初始状态为setVisible(false)，避免重叠显示。
• 可通过样式表设置选中项高亮：ui->treeWidget->setStyleSheet("QTreeWidget::item:selected { background-color: #0078d7; color: white; }");

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