如何在移除QTableWidget行时保持滚动位置不变？

问题核心 #

用QTableWidget做只读日志展示，设置行数上限后删除首行会导致可视内容上移，现有scrollTo方案要么无效，要么依赖选中行，且无法兼容hideRow过滤后的场景。

解决方案 #

要实现删行后保持用户当前可视区域不变，关键是删除前记录顶部可见的非隐藏行索引，删行后计算新的目标索引并调整滚动位置，避免表头遮挡。

具体实现代码 #

// 1. 删除首行前，记录可视区域顶部的第一个非隐藏行
int viewportTop = ui->tableWidget->viewport()->top();
int topVisibleRow = -1;

// 遍历所有行，找到第一个可见且未隐藏的行
for (int row = 0; row < ui->tableWidget->rowCount(); ++row) {
    if (ui->tableWidget->isRowHidden(row)) {
        continue;
    }
    QRect rowRect = ui->tableWidget->visualRect(ui->tableWidget->model()->index(row, 0));
    // 找到第一个顶部在可视区域内的行
    if (rowRect.top() >= viewportTop) {
        topVisibleRow = row;
        break;
    }
}

// 2. 删除首行
ui->tableWidget->removeRow(0);

// 3. 调整滚动位置，保持可视区域不变
if (topVisibleRow > 0) {
    int targetRow = topVisibleRow - 1;
    // 跳过隐藏行，找到实际可滚动到的行
    while (targetRow >= 0 && ui->tableWidget->isRowHidden(targetRow)) {
        targetRow--;
    }
    if (targetRow >= 0) {
        QModelIndex targetIndex = ui->tableWidget->model()->index(targetRow, 0);
        // 将目标行滚动到可视区域顶部
        ui->tableWidget->scrollTo(targetIndex, QAbstractItemView::PositionAtTop);
        // 修正滚动条位置，避免被水平表头遮挡
        int headerHeight = ui->tableWidget->horizontalHeader()->height();
        int currentScrollValue = ui->tableWidget->verticalScrollBar()->value();
        ui->tableWidget->verticalScrollBar()->setValue(currentScrollValue - headerHeight);
    }
}

方案说明 #

• 不依赖选中行：通过遍历可视区域获取顶部行，不管用户是否选中内容都能生效
• 兼容隐藏行：遍历和调整时跳过隐藏行，确保目标行是实际可见的
• 避免表头遮挡：手动调整滚动条值，抵消水平表头的高度影响，解决scrollTo后行被表头挡住的问题
• 索引有效性：删除前记录索引，避免删除后索引失效导致的滚动错误

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