如何为QTreeView的视口设置上边距？

问题原因 #

1. setViewportMargins无效：QTreeView作为QAbstractScrollArea子类，其视口的位置和尺寸受内部滚动逻辑、表头布局约束，直接调用该方法无法修改视口上边距。
2. 修改绘制矩形导致交互异常：仅在drawRow或Delegate中调整绘制区域时，视图的交互逻辑（鼠标悬停、点击）仍基于原始项位置计算，导致显示位置与可交互位置不匹配，出现项消失、点击无响应的问题。

正确解决方案 #

方案一：手动调整视口几何位置（适合整体内容下移） #

通过重写resizeEvent直接修改视口的位置和大小，让视口整体下移20px，同时保持正确的显示范围，确保交互逻辑完全正常：

#define qq qDebug().noquote().nospace()

class TreeDelegate : public QStyledItemDelegate
{
public:
    TreeDelegate(QObject* parent) : QStyledItemDelegate(parent) {}

    void initStyleOption(QStyleOptionViewItem* option, const QModelIndex& index) const override
    {
        QStyledItemDelegate::initStyleOption(option, index);
    }

    void paint(QPainter* painter, const QStyleOptionViewItem& option, const QModelIndex& index) const override
    {
        QStyledItemDelegate::paint(painter, option, index);
    }
};

class MyTreeView : public QTreeView
{
public:
    MyTreeView(QWidget* parent = nullptr) : QTreeView(parent)
    {
        QStandardItemModel* model = new QStandardItemModel(this);
        setModel(model);
        setIndentation(0);
        setRootIsDecorated(false);
  
        model->setHorizontalHeaderItem(0, new QStandardItem("col1"));
        model->setHorizontalHeaderItem(1, new QStandardItem("col2"));
        for (int i =0; i< 22; i++)
        {
            QList<QStandardItem*> row;
            for (int j = 0; j < 2; j++)
            {
                row.append(new QStandardItem(QString::number(i)));
            }
            model->appendRow(row);
        }

        setItemDelegate(new TreeDelegate(this));

        connect(new QShortcut(QKeySequence(Qt::Key_F4), this), &QShortcut::activated, [&]
        {
            updateGeometry();
        });
        connect(new QShortcut(QKeySequence(Qt::Key_F6), this), &QShortcut::activated, [&]
        {
            qq << "\nviewport geometry: " << viewport()->geometry();
        });
    }

protected:
    void resizeEvent(QResizeEvent* event) override
    {
        QTreeView::resizeEvent(event);
        QRect vpRect = viewport()->geometry();
        // 下移视口顶部20px
        vpRect.setTop(vpRect.top() + 20);
        // 减少视口高度，避免内容超出视图范围
        vpRect.setHeight(vpRect.height() - 20);
        viewport()->setGeometry(vpRect);
    }
};


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

    QWidget w;
    QHBoxLayout layout(&w);
    MyTreeView myTreeview;
    layout.addWidget(&myTreeview);
    w.show();
    return a.exec();
}

方案二：通过Delegate同步绘制与交互区域（适合项内容下移） #

如果需要保留视口原有大小，仅让所有项的内容下移20px，需同时调整项的尺寸和绘制位置，确保交互区域与显示区域一致：

#define qq qDebug().noquote().nospace()

class TreeDelegate : public QStyledItemDelegate
{
public:
    TreeDelegate(QObject* parent) : QStyledItemDelegate(parent) {}

    void initStyleOption(QStyleOptionViewItem* option, const QModelIndex& index) const override
    {
        QStyledItemDelegate::initStyleOption(option, index);
        // 下移项的绘制区域20px
        option->rect.adjust(0, 20, 0, 0);
    }

    QSize sizeHint(const QStyleOptionViewItem& option, const QModelIndex& index) const override
    {
        QSize originalSize = QStyledItemDelegate::sizeHint(option, index);
        // 增加项的高度，避免内容被裁剪
        originalSize.setHeight(originalSize.height() + 20);
        return originalSize;
    }

    void paint(QPainter* painter, const QStyleOptionViewItem& option, const QModelIndex& index) const override
    {
        QStyledItemDelegate::paint(painter, option, index);
    }
};

class MyTreeView : public QTreeView
{
public:
    MyTreeView(QWidget* parent = nullptr) : QTreeView(parent)
    {
        QStandardItemModel* model = new QStandardItemModel(this);
        setModel(model);
        setIndentation(0);
        setRootIsDecorated(false);
  
        model->setHorizontalHeaderItem(0, new QStandardItem("col1"));
        model->setHorizontalHeaderItem(1, new QStandardItem("col2"));
        for (int i =0; i< 22; i++)
        {
            QList<QStandardItem*> row;
            for (int j = 0; j < 2; j++)
            {
                row.append(new QStandardItem(QString::number(i)));
            }
            model->appendRow(row);
        }

        setItemDelegate(new TreeDelegate(this));

        connect(new QShortcut(QKeySequence(Qt::Key_F6), this), &QShortcut::activated, [&]
        {
            qq << "\nfirst item rect: " << visualRect(model->index(0,0));
        });
    }
};


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

    QWidget w;
    QHBoxLayout layout(&w);
    MyTreeView myTreeview;
    layout.addWidget(&myTreeview);
    w.show();
    return a.exec();
}

方案选择 #

• 方案一：适合需要在视口顶部预留空白（如放置自定义控件）、整体内容下移的场景，交互逻辑完全匹配显示位置。
• 方案二：适合需要为每个项上方添加固定间距，或保持视口原始大小的场景，通过Delegate统一管理项的显示与交互区域。

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