如何在QTreeView中绘制项目连接线？跨平台样式兼容咨询

Great question—this is such a common headache when trying to get consistent tree view connection lines across Qt styles and platforms. Let’s walk through the most reliable approaches to achieve the Tree Model-style lines you want, while avoiding the pitfalls you’ve mentioned.

1. Custom QTreeView with Overridden paintEvent (Most Reliable) #

Your hunch about stylesheets is spot-on: many Qt native styles (like macOS Aqua, Windows 10+, or Breeze) ignore the QTreeView::branch stylesheet selector entirely, making it impossible to get consistent lines that way.

The most foolproof method is to take direct control by subclassing QTreeView and overriding paintEvent. Here’s why this works:

• You draw the lines after Qt handles the default item rendering, so you don’t interfere with style-specific item looks.
• You can align lines with the current style’s indentation and spacing, so things don’t look misaligned.
• No reliance on style-specific behavior—your drawing logic runs the same across all platforms.

Example Implementation #

#include <QTreeView>
#include <QPainter>
#include <QStyleOptionViewItem>

class LineTreeView : public QTreeView
{
protected:
    void paintEvent(QPaintEvent* event) override
    {
        // Let Qt draw the items first
        QTreeView::paintEvent(event);

        QPainter painter(viewport());
        // Use the palette's mid tone for subtle, style-adaptive lines
        painter.setPen(palette().color(QPalette::Mid));
        int indent = style()->pixelMetric(QStyle::PM_TreeViewIndentation);

        // Iterate over all visible items to draw connections
        for (const QModelIndex& index : visibleIndexes()) {
            if (!index.parent().isValid()) continue; // Skip root items

            QRect itemRect = visualRect(index);
            int lineX = itemRect.left() - (indent / 2);
            int itemMidY = itemRect.top() + (itemRect.height() / 2);

            // Draw horizontal line connecting to parent
            QModelIndex parentIdx = index.parent();
            QRect parentRect = visualRect(parentIdx);
            painter.drawLine(lineX, itemMidY, parentRect.left() + indent, itemMidY);

            // Draw vertical line if there are sibling items below
            bool hasNextSibling = model()->hasIndex(index.row() + 1, index.column(), index.parent());
            if (hasNextSibling) {
                painter.drawLine(lineX, itemRect.top(), lineX, itemRect.bottom());
            }

            // Extend parent's vertical line if this is not the last child
            if (!hasNextSibling) {
                int parentMidY = parentRect.top() + (parentRect.height() / 2);
                painter.drawLine(parentRect.left() + indent, parentMidY, parentRect.left() + indent, itemMidY);
            }
        }
    }
};

This code draws clean, adaptive lines that match the current style’s spacing, and works across all Qt-supported platforms.

2. Improved Item Delegate (Avoiding Duplicate Drawing) #

If you prefer using a delegate instead of subclassing the view, you can avoid duplicate drawing by being precise about which lines each delegate instance draws. The key is to only draw lines relevant to the current item, and avoid overlapping lines with adjacent items.

Key Tricks for Delegates: #

• In the delegate’s paint method, first call QStyledItemDelegate::paint to render the item normally.
• Only draw the vertical line on the left of the item if it has siblings below it.
• Only draw the horizontal line connecting to the parent if the item isn’t the first child (or adjust to avoid overlapping with the parent’s existing lines).
• Use the same style metrics (like PM_TreeViewIndentation) to keep alignment consistent.

Note: This method is more prone to edge cases (like overlapping lines if not careful), so the custom view approach is generally recommended for robustness.

Cross-Platform Consistency Tips #

• Never rely on stylesheets for tree branches: As you noted, many styles ignore these rules. Stick to manual drawing.
• Use palette colors: Instead of hardcoding line colors, pull from the current QPalette (like QPalette::Mid or QPalette::Text) so lines adapt to light/dark modes and different styles.
• Test across styles: Verify your implementation with Qt’s built-in styles (Fusion, Windows, macOS, Breeze) to ensure lines align correctly and don’t clash with item content.

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