Qt6.5 QTreeView禁用列匹配启用列背景色的委托实现问询

问题背景 #

• Qt 6.5中，QTreeView某列设置~Qt::ItemIsEnabled和~Qt::ItemIsSelectable标记后，该行处于选中、悬停、选中且悬停状态时，该禁用列默认背景为白色，CSS样式完全无法生效
• 此为Qt官方已知BUG（QTBUG-112192），且官方明确不会修复
• 子类化QStyledItemDelegate重写paint方法时，选中状态判断（QStyle::State_Selected）无法触发；业务要求必须保留禁用标志以区分其他列的复选框，需通过同行启用列的状态背景色同步禁用列样式，避免硬编码颜色值

核心问题分析 #

禁用列因设置了~Qt::ItemIsSelectable，其QStyleOptionViewItem不会携带State_Selected状态，但整行的选中状态实际由同行可选中列决定，因此需从同行启用列获取状态对应的背景样式。

解决方案代码 #

void ModelDelegate::paint(
    QPainter* painter,
    const QStyleOptionViewItem& option,
    const QModelIndex& index) const
{
    // 非禁用列使用默认绘制逻辑
    if (index.column() != Model::DisabledColumn) {
        QStyledItemDelegate::paint(painter, option, index);
        return;
    }

    QStyleOptionViewItem option_copy(option);
    // 获取同行的启用列索引（替换为业务中实际的启用列枚举/索引）
    QModelIndex enabled_col_idx = index.siblingAtColumn(Model::EnabledColumn);
    
    QStyleOptionViewItem enabled_option(option);
    if (const QTreeView* tree_view = qobject_cast<const QTreeView*>(option.widget)) {
        // 同步整行的选中状态
        if (tree_view->selectionModel()->isSelected(enabled_col_idx)) {
            enabled_option.state |= QStyle::State_Selected;
        }
    }

    // 获取启用列对应状态的背景画刷（自动应用CSS定义的样式）
    QStyle* style = option.widget ? option.widget->style() : QApplication::style();
    QPalette::ColorGroup color_group = option.state & QStyle::State_Enabled ? QPalette::Normal : QPalette::Disabled;
    QBrush bg_brush = style->styleHint(QStyle::SH_ItemView_ItemBackground, &enabled_option, option.widget);
    if (bg_brush == Qt::NoBrush) {
        bg_brush = option.palette.brush(color_group, QPalette::Base);
    }

    // 将样式同步到禁用列
    option_copy.backgroundBrush = bg_brush;

    // 绘制背景与内容
    style->drawPrimitive(QStyle::PE_PanelItemViewItem, &option_copy, painter);
    drawDisplay(painter, option_copy, option_copy.rect, index.data(Qt::DisplayRole).toString());
    drawFocus(painter, option_copy, option_copy.rect); // 可选：绘制焦点框
}

关键说明 #

1. 状态同步：通过同行启用列的选中状态，手动为禁用列的样式选项添加State_Selected，解决选中状态判断失效问题
2. CSS样式自动适配：利用styleHint(QStyle::SH_ItemView_ItemBackground)获取启用列的背景画刷，自动应用CSS中定义的:selected、:hover、:selected:hover等状态样式，无需硬编码颜色值
3. 业务兼容性：保留原有禁用列的标志设置，不影响其他列的复选框逻辑

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