如何在Qt的QGridLayout布局中显示分隔区域的网格线？

Great question! I’ve dealt with this exact problem before—Qt doesn’t have a built-in toggle for grid lines in QGridLayout, but there are two really clean, straightforward workarounds that feel almost like native solutions.

Option 1: Use Stylesheets for Child Widget Borders #

This is probably the simplest approach. You can add borders to each widget in the layout, then tweak the layout spacing to make those borders look like unified grid lines. Here’s how:

# Assume your QGridLayout instance is named grid_layout
grid_layout.setSpacing(0)  # Remove spacing so borders connect seamlessly

# Add right and bottom borders to every child widget to avoid duplicate lines
for row in range(grid_layout.rowCount()):
    for col in range(grid_layout.columnCount()):
        item = grid_layout.itemAtPosition(row, col)
        if item and item.widget():
            item.widget().setStyleSheet("""
                QWidget {
                    border-right: 1px solid #ccc;
                    border-bottom: 1px solid #ccc;
                }
            """)

# Add top and left borders to the parent container to complete the grid frame
parent_widget.setStyleSheet("""
    QWidget {
        border-top: 1px solid #ccc;
        border-left: 1px solid #ccc;
    }
""")

You can customize the color (#ccc), border width, or even add rounded corners by adjusting the stylesheet values.

Option 2: Custom Container Widget with Grid Drawing #

If you don’t want to mess with individual widget styles, create a simple QWidget subclass that draws grid lines directly over its layout. This keeps your child widgets’ styles untouched:

from PyQt5.QtWidgets import QWidget
from PyQt5.QtGui import QPainter, QPen
from PyQt5.QtCore import Qt

class GridContainer(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.grid_layout = QGridLayout(self)
        self.grid_layout.setSpacing(5)  # Keep spacing if you want gaps between widgets

    def paintEvent(self, event):
        super().paintEvent(event)
        painter = QPainter(self)
        painter.setPen(QPen(Qt.gray, 1))  # Adjust color and thickness here

        # Draw vertical grid lines
        for col in range(self.grid_layout.columnCount() + 1):
            line_x = self.grid_layout.columnRect(col).left()
            painter.drawLine(line_x, 0, line_x, self.height())
        
        # Draw horizontal grid lines
        for row in range(self.grid_layout.rowCount() + 1):
            line_y = self.grid_layout.rowRect(row).top()
            painter.drawLine(0, line_y, self.width(), line_y)

Just use GridContainer.grid_layout to add your widgets, and the grid lines will automatically adjust as you add/remove rows/columns.

Both methods are lightweight and don’t require complex logic. It’s a shame Qt doesn’t include a native showGrid property, but these workarounds get the job done easily.

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