PyQt5 中的布局管理

最后修改于 2023 年 10 月 18 日

布局管理是我们如何在应用程序窗口上放置小部件的方式。我们可以使用绝对定位或布局类来放置我们的小部件。使用布局管理器管理布局是组织我们小部件的首选方式。

绝对定位

程序员以像素为单位指定每个小部件的位置和大小。当您使用绝对定位时，我们必须理解以下限制

如果我们调整窗口大小，小部件的大小和位置不会改变
应用程序在各种平台上可能看起来不同
更改应用程序中的字体可能会破坏布局
如果我们决定更改我们的布局，我们必须完全重新做我们的布局，这既乏味又耗时

以下示例使用绝对坐标定位小部件。

absolute.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

This example shows three labels on a window
using absolute positioning.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt5.QtWidgets import QWidget, QLabel, QApplication


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        lbl1 = QLabel('ZetCode', self)
        lbl1.move(15, 10)

        lbl2 = QLabel('tutorials', self)
        lbl2.move(35, 40)

        lbl3 = QLabel('for programmers', self)
        lbl3.move(55, 70)

        self.setGeometry(300, 300, 250, 150)
        self.setWindowTitle('Absolute')
        self.show()


def main():
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

我们使用 move 方法来定位我们的小部件。在我们的例子中，这些是标签。我们通过提供 x 和 y 坐标来定位它们。坐标系的起始点位于左上角。x 值从左向右增长。y 值从上到下增长。

lbl1 = QLabel('ZetCode', self)
lbl1.move(15, 10)

标签小部件位于 x=15 和 y=10。

PyQt5 QHBoxLayout

QHBoxLayout 和 QVBoxLayout 是基本的布局类，它们水平和垂直地排列小部件。

想象一下，我们想在右下角放置两个按钮。要创建这样的布局，我们使用一个水平框和一个垂直框。为了创建必要的空间，我们添加一个伸展因子。

box_layout.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, we position two push
buttons in the bottom-right corner
of the window.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt5.QtWidgets import (QWidget, QPushButton,
                             QHBoxLayout, QVBoxLayout, QApplication)


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        okButton = QPushButton("OK")
        cancelButton = QPushButton("Cancel")

        hbox = QHBoxLayout()
        hbox.addStretch(1)
        hbox.addWidget(okButton)
        hbox.addWidget(cancelButton)

        vbox = QVBoxLayout()
        vbox.addStretch(1)
        vbox.addLayout(hbox)

        self.setLayout(vbox)

        self.setGeometry(300, 300, 300, 150)
        self.setWindowTitle('Buttons')
        self.show()


def main():
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

此示例将两个按钮放置在窗口的右下角。当我们调整应用程序窗口大小时，它们会停留在那里。我们同时使用 HBoxLayout 和 QVBoxLayout。

okButton = QPushButton("OK")
cancelButton = QPushButton("Cancel")

这里我们创建了两个按钮。

hbox = QHBoxLayout()
hbox.addStretch(1)
hbox.addWidget(okButton)
hbox.addWidget(cancelButton)

我们创建一个水平框布局，并添加一个伸展因子和两个按钮。伸展添加了两个按钮之前的可伸展空间。这会将它们推到窗口的右侧。

vbox = QVBoxLayout()
vbox.addStretch(1)
vbox.addLayout(hbox)

水平布局被放置到垂直布局中。垂直框中的伸展因子将把带有按钮的水平框推到窗口的底部。

self.setLayout(vbox)

最后，我们设置窗口的主布局。

PyQt5 QGridLayout

QGridLayout 是最通用的布局类。它将空间划分为行和列。

calculator.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, we create a skeleton
of a calculator using QGridLayout.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt5.QtWidgets import (QWidget, QGridLayout,
                             QPushButton, QApplication)


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        grid = QGridLayout()
        self.setLayout(grid)

        names = ['Cls', 'Bck', '', 'Close',
                 '7', '8', '9', '/',
                 '4', '5', '6', '*',
                 '1', '2', '3', '-',
                 '0', '.', '=', '+']

        positions = [(i, j) for i in range(5) for j in range(4)]

        for position, name in zip(positions, names):

            if name == '':
                continue
            button = QPushButton(name)
            grid.addWidget(button, *position)

        self.move(300, 150)
        self.setWindowTitle('Calculator')
        self.show()


def main():
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

在我们的示例中，我们创建一个按钮网格。

grid = QGridLayout()
self.setLayout(grid)

创建 QGridLayout 的实例并将其设置为应用程序窗口的布局。

names = ['Cls', 'Bck', '', 'Close',
            '7', '8', '9', '/',
        '4', '5', '6', '*',
            '1', '2', '3', '-',
        '0', '.', '=', '+']

这些是稍后用于按钮的标签。

positions = [(i,j) for i in range(5) for j in range(4)]

我们创建一个网格中的位置列表。

for position, name in zip(positions, names):
    
    if name == '':
        continue
    button = QPushButton(name)
    grid.addWidget(button, *position)

创建按钮并使用 addWidget 方法将它们添加到布局中。

复习示例

小部件可以跨越网格中的多列或多行。在下一个示例中，我们将对此进行说明。

review.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this example, we create a bit
more complicated window layout using
the QGridLayout manager.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt5.QtWidgets import (QWidget, QLabel, QLineEdit,
                             QTextEdit, QGridLayout, QApplication)


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        title = QLabel('Title')
        author = QLabel('Author')
        review = QLabel('Review')

        titleEdit = QLineEdit()
        authorEdit = QLineEdit()
        reviewEdit = QTextEdit()

        grid = QGridLayout()
        grid.setSpacing(10)

        grid.addWidget(title, 1, 0)
        grid.addWidget(titleEdit, 1, 1)

        grid.addWidget(author, 2, 0)
        grid.addWidget(authorEdit, 2, 1)

        grid.addWidget(review, 3, 0)
        grid.addWidget(reviewEdit, 3, 1, 5, 1)

        self.setLayout(grid)

        self.setGeometry(300, 300, 350, 300)
        self.setWindowTitle('Review')
        self.show()


def main():
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

我们创建一个窗口，其中有三个标签、两个行编辑和一个文本编辑小部件。布局使用 QGridLayout 完成。

grid = QGridLayout()
grid.setSpacing(10)

我们创建一个网格布局并设置小部件之间的间距。

grid.addWidget(reviewEdit, 3, 1, 5, 1)

如果我们将小部件添加到网格，我们可以提供小部件的行跨度和列跨度。在我们的例子中，我们使 reviewEdit 小部件跨越 5 行。

PyQt5 教程的这一部分专门介绍了布局管理。

电子书

PyQt5 中的布局管理

绝对定位

PyQt5 QHBoxLayout

PyQt5 QGridLayout

复习示例