使用自定义CellWidget时QTableWidget单元格选中颜色不一致问题

我编写了一个继承自QTableWidget的自定义表格部件，最后两列使用了自定义单元格部件（一列包含QCheckBox，另一列包含QLineEdit及可选QPushButtons）。已实现根据复选框勾选状态将整行设置为深蓝色或橙色的功能，核心代码如下：

// 为标准表格单元格设置颜色
for (auto j = 0; j < FIRST_FOUR_COLUMNS; j++) {
    tableWidget->item(i, j)->setBackground(isCheckedColor);
}

QPalette palette;
palette.setColor(QPalette::Base, isCheckedColor); // 适配按钮背景
palette.setColor(QPalette::Button, buttonColor);

// 为自定义单元格部件设置颜色
tableWidget->cellWidget(i, COL_CHECKBOX)->setAutoFillBackground(true);
tableWidget->cellWidget(i, COL_LINE_EDIT)->setAutoFillBackground(true);
tableWidget->cellWidget(i, COL_CHECKBOX)->setPalette(palette);
tableWidget->cellWidget(i, COL_LINE_EDIT)->setPalette(palette);

该功能正常运行，但选中某一行时，最后两列自定义部件的高亮颜色与其他标准表格单元格不一致，希望所有单元格的选中高亮效果保持统一。

已尝试的方法：

• 通过样式表修改背景色：tableWidget->setStyleSheet("QTableWidget::item{ selection-background-color:#ff0000; }");
• 子类化QItemDelegate并重写paint方法自定义颜色

以上方法均未解决问题，仍存在显示异常。

最小复现代码 #

#include <QApplication>
#include <QHBoxLayout>
#include <QMainWindow>
#include <QTableWidget>
#include <QWidget>

int
main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    // 初始化部件
    auto* const tableWidget = new QTableWidget(1, 2);
    tableWidget->setSelectionBehavior(QAbstractItemView::SelectRows);
    tableWidget->setItem(0, 0, new QTableWidgetItem());
    auto *const cellWidget = new QWidget;
    tableWidget->setCellWidget(0, 1, cellWidget);

    // 设置调色板颜色
    QPalette palette;
    palette.setColor(QPalette::Base, QColor(255, 194, 10, 60));
    tableWidget->item(0, 0)->setBackground(palette.color(QPalette::Base));
    tableWidget->cellWidget(0, 1)->setAutoFillBackground(true);
    tableWidget->cellWidget(0, 1)->setPalette(palette);

    // 布局与主窗口
    auto* const mainWindow = new QMainWindow;
    mainWindow->setCentralWidget(tableWidget);
    mainWindow->show();

    return app.exec();
}

CMake配置 #

cmake_minimum_required(VERSION 3.8)

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)

project(ExampleProject LANGUAGES CXX)

find_package(QT NAMES Qt5 COMPONENTS Widgets REQUIRED)
find_package(Qt5 COMPONENTS Widgets REQUIRED)

add_executable(ExampleProject
    ${CMAKE_CURRENT_LIST_DIR}/main.cpp
)

target_link_libraries(ExampleProject
    PRIVATE Qt::Widgets
)

问题根源在于：QTableWidget的自定义单元格部件（cellWidget）不属于表格项（QTableWidgetItem）的绘制体系，默认不会响应表格的选中状态变化，需要手动同步选中状态的样式。

方法1：监听表格选中状态，动态更新部件样式 #

在自定义表格类中，监听itemSelectionChanged信号，根据行选中状态同步更新自定义单元格部件的背景色：

// 自定义表格构造函数中连接信号
connect(this, &QTableWidget::itemSelectionChanged, this, &CustomTableWidget::syncCellWidgetSelection);

// 实现同步函数
void CustomTableWidget::syncCellWidgetSelection()
{
    for (int i = 0; i < rowCount(); ++i) {
        bool isRowSelected = isRowSelected(i);
        // 获取选中/非选中状态的背景色（可替换为自定义颜色）
        QColor targetBg = isRowSelected ? palette().color(QPalette::Highlight) : getRowOriginalBgColor(i);

        // 更新复选框列的自定义部件
        if (QWidget* checkBoxWidget = cellWidget(i, COL_CHECKBOX)) {
            QPalette pal = checkBoxWidget->palette();
            pal.setColor(QPalette::Base, targetBg);
            checkBoxWidget->setPalette(pal);
        }
        // 更新输入框列的自定义部件
        if (QWidget* lineEditWidget = cellWidget(i, COL_LINE_EDIT)) {
            QPalette pal = lineEditWidget->palette();
            pal.setColor(QPalette::Base, targetBg);
            lineEditWidget->setPalette(pal);
        }
    }
}

// 辅助函数：获取行的原始背景色（根据复选框状态）
QColor CustomTableWidget::getRowOriginalBgColor(int row)
{
    // 这里复用你之前判断复选框状态获取颜色的逻辑
    bool isChecked = /* 对应行复选框的勾选状态 */;
    return isChecked ? QColor(/* 深蓝色 */) : QColor(/* 橙色 */);
}

方法2：自定义部件子类，直接响应选中状态 #

如果自定义单元格部件是自己子类化的（如CustomCheckBoxWidget、CustomLineEditWidget），可以让部件直接接收选中状态并更新样式：

// 自定义复选框部件类
class CustomCheckBoxWidget : public QWidget
{
    Q_OBJECT
public:
    explicit CustomCheckBoxWidget(QWidget* parent = nullptr) : QWidget(parent)
    {
        // 保存初始背景色
        m_originalBg = palette().color(QPalette::Base);
    }

public slots:
    void updateSelectedState(bool isSelected)
    {
        QPalette pal = palette();
        pal.setColor(QPalette::Base, isSelected ? palette().color(QPalette::Highlight) : m_originalBg);
        setPalette(pal);
    }

private:
    QColor m_originalBg;
};

之后在表格选中状态变化时，调用每个自定义部件的updateSelectedState方法即可。

关键注意事项 #

• 不要固定设置AutoFillBackground为true后使用静态颜色，需根据选中状态动态切换颜色。
• 优先使用QPalette中的系统颜色（如QPalette::Highlight），保证与系统风格一致，避免硬编码颜色导致的不一致。

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