如何在槽函数中禁用QTableWidget的Tab/Shift+Tab单元格选中功能

核心问题原因 #

关闭tabKeyNavigation属性无效，是因为单元格处于编辑状态时，Tab按键事件会被单元格内的编辑器（如QLineEdit）接管，而非表格控件处理，所以需要直接拦截Tab相关的按键事件。

解决方案：使用事件过滤器拦截Tab事件 #

通过给QTableWidget安装事件过滤器，判断并拦截跳转到不可编辑单元格的Tab/Shift+Tab操作，步骤如下：

1. 在窗口类头文件中声明事件过滤器

class YourWindowClass : public QWidget
{
    Q_OBJECT
public:
    explicit YourWindowClass(QWidget *parent = nullptr);
    ~YourWindowClass();
private:
    Ui::YourWindowClass *ui;
    // 声明事件过滤器函数
    bool eventFilter(QObject *watched, QEvent *event) override;
};

2. 在构造函数中为表格安装过滤器

YourWindowClass::YourWindowClass(QWidget *parent) : QWidget(parent), ui(new Ui::YourWindowClass)
{
    ui->setupUi(this);
    // 为表格安装事件过滤器
    ui->tableWidgetAdminEmployee->installEventFilter(this);
}

3. 实现事件过滤器，处理Tab/Shift+Tab事件

bool YourWindowClass::eventFilter(QObject *watched, QEvent *event)
{
    if (watched == ui->tableWidgetAdminEmployee && event->type() == QEvent::KeyPress)
    {
        QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
        // 匹配Tab和Shift+Tab（Backtab）
        if (keyEvent->key() == Qt::Key_Tab || keyEvent->key() == Qt::Key_Backtab)
        {
            QModelIndex currentIdx = ui->tableWidgetAdminEmployee->currentIndex();
            int row = currentIdx.row();
            int col = currentIdx.column();
            int totalCols = ui->tableWidgetAdminEmployee->columnCount();
            int totalRows = ui->tableWidgetAdminEmployee->rowCount();

            // 计算目标单元格的行列
            if (keyEvent->key() == Qt::Key_Tab)
            {
                col++;
                if (col >= totalCols)
                {
                    col = 0;
                    row = (row + 1) % totalRows;
                }
            }
            else
            {
                col--;
                if (col < 0)
                {
                    col = totalCols - 1;
                    row = (row - 1 + totalRows) % totalRows;
                }
            }

            // 根据你的规则判断目标列是否不可编辑
            if (col == 0 || col == 7 || col == 8 || col == 9)
            {
                // 拦截事件，阻止跳转
                return true;
            }
        }
    }
    // 其他事件交给默认处理逻辑
    return QWidget::eventFilter(watched, event);
}

辅助优化：初始化时设置不可编辑列的属性 #

在表格初始化阶段，直接给不可编辑列的单元格移除Qt::ItemIsEditable标志，从根源上禁止编辑，避免后续逻辑冲突：

// 假设表格已初始化行列数
for (int row = 0; row < ui->tableWidgetAdminEmployee->rowCount(); row++)
{
    // 遍历所有不可编辑的列
    for (int col : {0, 7, 8, 9})
    {
        QTableWidgetItem *item = ui->tableWidgetAdminEmployee->item(row, col);
        if (!item)
        {
            item = new QTableWidgetItem();
            ui->tableWidgetAdminEmployee->setItem(row, col, item);
        }
        // 移除可编辑标志，保留选中和启用状态
        item->setFlags(item->flags() & ~Qt::ItemIsEditable);
    }
}

为什么之前的代码无效 #

你之前在clicked槽中设置Qt::ItemIsEnabled只是允许单元格被点击，但并未移除Qt::ItemIsEditable标志；同时Tab跳转不会触发clicked事件，所以无法拦截跳转行为。

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