PyQt - QGridLayout Class

A GridLayout class object presents with a grid of cells arranged in rows and columns. The class contains addWidget() method. Any widget can be added by specifying the number of rows and columns of the cell. Optionally, a spanning factor for row as well as column, if specified makes the widget wider or taller than one cell.

Two overloads of addWidget() method are as follows −

A child layout object can also be added at any cell in the grid.

Columns methods in QGridLayout

The QGridLayout contains two column methods −

• setColumnMinimumWidth() − Set the minimum width of the container.
• setColumnStretch() − Set the amount of additional space for a column that will get beyond its necessary.

Grid Layout using nested loop and setGeometry() method

The Grid Layout is constructed using the setGeometry() method and this method refers to the size and location of the pushbutton. So we have nested for loop and addWidget() method to perform this task.

Example

In the following example, we create a grid layout of 16 push buttons that are arranged in 4 rows and columns.

import sys
from PyQt6.QtWidgets import QApplication, QWidget, QGridLayout, QPushButton
def window():
   app = QApplication(sys.argv)
   win = QWidget()
   grid = QGridLayout()

   for i in range(1, 5):
      for j in range(1, 5):
         grid.addWidget(QPushButton("B" + str(i) + str(j)), i, j)

   win.setLayout(grid)
   win.setGeometry(100, 100, 200, 100)
   win.setWindowTitle("PyQt")
   win.show()
   sys.exit(app.exec())

if __name__ == '__main__':
   window()

Output

The above code produces the following output −

The code uses two nested for loops for row and column numbers, denoted by variables i and j. They are converted to string to concatenate the caption of each push button to be added at i^th row and j^th column.

Two Column Layout using QGridLayout

The two column layout uses the columns having equal-height, equal-width, and side-by-side visibility on computer or mobile screens. In PyQt, we develop the group of boxes into two separate column which can be built through various built-in function of QGridLayout class- QGridLayout(), QPushButton(), setLayout(), and setLayout().

Example

Following example demonstrate the code of two-columns layout using QGridlayout.

from PyQt6.QtWidgets import QApplication, QWidget, QGridLayout, QPushButton
class TwoColumnLayout(QWidget):
   def __init__(self):
      super().__init__()

      # Create a QGridLayout instance
      layout = QGridLayout()
      # Add widgets to the layout
      for i in range(10):
         layout.addWidget(QPushButton(f'Box {i+1}'), i // 2, i % 2)
      # Set the layout on the application's window
      self.setLayout(layout)

app = QApplication([])
window = TwoColumnLayout()
window.setWindowTitle('PyQt')
window.show()
app.exec()

Output

The above code produces the following output −