QStyledItemDelegate::paint中QStyleOptionViewItem的rect为0x0的原因

为什么QStyleOptionViewItem的rect为0x0？ #

出现这个问题通常和以下几个原因有关：

• 代理sizeHint方法逻辑错误：如果你的sizeHint()在某些分支下返回了QSize(0, 0)（比如新添加项的必要数据未初始化，导致尺寸计算出错），QListView会根据这个无效尺寸分配0x0的绘制区域。另外，如果未在合适场景下调用父类QStyledItemDelegate::sizeHint()作为兜底，也可能导致异常尺寸。
• 模型数据更新不规范：添加新项时未正确调用模型的beginInsertRows()和endInsertRows()方法，QListView无法感知项的添加，也就不会为新项计算并分配正确的布局空间，最终传递给代理的rect就是无效的0x0。
• 视图布局配置问题：如果QListView的resizeMode设置为QListView::Fixed，但没有为项提供有效的尺寸参考（比如模型未返回Qt::SizeHintRole的数据，代理也没正确计算尺寸），视图无法自动计算项的大小，就会出现0x0的rect。

QStyleOptionViewItem的属性来源 #

QStyleOptionViewItem的核心属性来源如下：

• rect：由QListView根据代理返回的sizeHint()、视图的布局模式（列表/图标模式）、项间距、视图当前的可视区域，以及项在模型中的位置计算得出，用于确定项在视图中的绘制范围。
• 状态类属性（state）：来自项的当前交互状态，比如是否被选中、是否处于hover状态，由QListView根据用户操作和项的选中状态设置。
• 样式类属性（palette、font等）：优先使用模型中Qt::FontRole、Qt::ForegroundRole、Qt::BackgroundRole返回的数据；如果模型未提供，则继承QListView自身的样式属性。
• 其他元数据：比如index属性直接对应模型中的项索引，text属性默认来自模型Qt::DisplayRole的数据，用于简化代理的绘制逻辑。

排查建议 #

1. 检查sizeHint()实现：确保所有分支都返回有效的非零尺寸，必要时调用父类实现作为默认值：

QSize Delegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    // 自定义尺寸计算逻辑
    QSize customSize = calculateCustomSize(index);
    if (customSize.isValid() && customSize.width() > 0 && customSize.height() > 0) {
        return customSize;
    }
    // 兜底调用父类方法
    return QStyledItemDelegate::sizeHint(option, index);
}

2. 规范模型项添加流程：添加新项时必须包裹在beginInsertRows和endInsertRows之间：

void MyModel::addItem(const ItemData &data)
{
    beginInsertRows(QModelIndex(), rowCount(), rowCount());
    m_items.append(data);
    endInsertRows();
}

3. 检查视图配置：确保QListView的resizeMode设置为QListView::Adjust，让视图能根据项的尺寸自动调整布局：

ui->listView->setResizeMode(QListView::Adjust);

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