《快速掌握PyQt5》第三章布局管理

la_vie_est_belle

已于 2023-04-17 08:40:01 修改

阅读量7.5k

点赞数 15

CC 4.0 BY-SA版权

分类专栏：《快速掌握PyQt5》文章标签： PyQt5 Python PyQt PySide GUI

于 2018-09-03 19:46:23 首次发布

本文为博主原创文章，未经博主允许不得转载。

本文链接：https://blog.csdn.net/La_vie_est_belle/article/details/82346289

PyQt5 同时被 2 个专栏收录

42 篇文章

订阅专栏

《快速掌握PyQt5》

42 篇文章

订阅专栏

本文介绍了PyQt5中五种布局管理方式：垂直布局QVBoxLayout、水平布局QHBoxLayout、表单布局QFormLayout、网格布局QGridLayout。通过具体示例展示了如何使用这些布局管理器来组织界面元素。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

第三章布局管理

3.1 垂直布局QVBoxLayout

3.2 水平布局QHBoxLayout

3.3 混合使用QVBoxLayout和QHBoxLayout

3.4 表单布局QFormLayout

3.5 网格布局QGridLayout

3.6 小结

《快速掌握PyQt5》专栏已整理成书出版，书名为《PyQt编程快速上手》，详情请见该链接。感谢大家一直以来的支持！祝大家PyQt用得越来越顺！

把各个控件摆摆好，让整个界面更加有序好看，这就是布局管理器的作用。

3.1 垂直布局QVBoxLayout

该布局方式就是将各个控件按从上到下垂直的方式摆放，下面看一个例子：

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


class Demo(QWidget):

    def __init__(self):
        super(Demo, self).__init__()
        self.user_label = QLabel('Username:', self)
        self.pwd_label = QLabel('Password:', self)

        self.v_layout = QVBoxLayout()                   # 1
        self.v_layout.addWidget(self.user_label)        # 2
        self.v_layout.addWidget(self.pwd_label)         # 3

        self.setLayout(self.v_layout)                   # 4


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    demo.show()
    sys.exit(app.exec_())

1. 实例化一个垂直布局管理器QVBoxLayout；

2-3. 通过调用addWidget()方法来将控件一个个添加到垂直布局中，最先添加的出现在最上方；

4. 将self.v_layout设为整个窗口的最终布局方式。

运行截图如下，可以看出两个标签文本是垂直对齐排列的：

3.2 水平布局QHBoxLayout

将控件从左到右依次水平摆放：

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


class Demo(QWidget):

    def __init__(self):
        super(Demo, self).__init__()
        self.user_label = QLabel('Username:', self)
        self.user_line = QLineEdit(self)                # 1

        self.h_layout = QHBoxLayout()                   # 2
        self.h_layout.addWidget(self.user_label)        # 3
        self.h_layout.addWidget(self.user_line)         # 4

        self.setLayout(self.h_layout)                   # 5


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    demo.show()
    sys.exit(app.exec_())

1. QLineEdit控件就是一个用来进行单行文本输入的框；

2. 实例化一个水平布局管理器；

3-4. 将QLabel和QLineEdit控件添加到水平布局管理器中，先添加的出现在左边；

5. 将self.h_layout设为整个窗口的最终布局方式。

运行截图如下：

3.3 混合使用QVBoxLayout和QHBoxLayout

我们将实现一个用于输入账号密码，并有登陆和注册按钮的小窗口：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QPushButton, \
    QHBoxLayout, QVBoxLayout


class Demo(QWidget):

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

        self.user_label = QLabel('Username:', self)
        self.pwd_label = QLabel('Password:', self)
        self.user_line = QLineEdit(self)
        self.pwd_line = QLineEdit(self)
        self.login_button = QPushButton('Log in', self)
        self.signin_button = QPushButton('Sign in', self)

        self.label_v_layout = QVBoxLayout()                      # 1
        self.line_v_layout = QVBoxLayout()                       # 2
        self.button_h_layout = QHBoxLayout()                     # 3
        self.label_line_h_layout = QHBoxLayout()                 # 4
        self.all_v_layout = QVBoxLayout()                        # 5

        self.label_v_layout.addWidget(self.user_label)           # 6
        self.label_v_layout.addWidget(self.pwd_label)
        self.line_v_layout.addWidget(self.user_line)
        self.line_v_layout.addWidget(self.pwd_line)
        self.button_h_layout.addWidget(self.login_button)
        self.button_h_layout.addWidget(self.signin_button)
        self.label_line_h_layout.addLayout(self.label_v_layout)  # 7
        self.label_line_h_layout.addLayout(self.line_v_layout)
        self.all_v_layout.addLayout(self.label_line_h_layout)
        self.all_v_layout.addLayout(self.button_h_layout)

        self.setLayout(self.all_v_layout)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    demo.show()
    sys.exit(app.exec_())

1-3. 实例化三个布局管理器分别用来管理QLabel，QLineEdit和QPushButton；

4-5. 这两个布局管理器用来管理1-3中的布局，它们添加的不是QLabel、QLineEdit或者QPushButton控件，而是通过addLayout()方法添加布局管理器。第4行的水平布局管理器将self.label_v_layout垂直布局和self.line_vlayout垂直布局这两个布局管理器从左到右依次水平摆放。第5行的垂直布局管理器将self.label_line_h_layout和self.button_h_layout垂直从上到下摆放；

6-7. 添加控件用addWidght()，添加布局用addLayout()。

运行截图如下：

上面的代码是将两个QLabel用垂直布局方式摆放，将两个QLineEdit也用垂直布局方式摆放，最后用一个水平布局管理来摆放着两个垂直布局管理器。那换种思路，可以把QLabel和QLineEdit用水平布局方式摆放：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QPushButton, \
    QHBoxLayout, QVBoxLayout


class Demo(QWidget):

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

        self.user_label = QLabel('Username:', self)
        self.pwd_label = QLabel('Password:', self)
        self.user_line = QLineEdit(self)
        self.pwd_line = QLineEdit(self)
        self.login_button = QPushButton('Log in', self)
        self.signin_button = QPushButton('Sign in', self)

        self.user_h_layout = QHBoxLayout()                      
        self.pwd_h_layout = QHBoxLayout()                       
        self.button_h_layout = QHBoxLayout()                     
        self.all_v_layout = QVBoxLayout()                        

        self.user_h_layout.addWidget(self.user_label)
        self.user_h_layout.addWidget(self.user_line)
        self.pwd_h_layout.addWidget(self.pwd_label)
        self.pwd_h_layout.addWidget(self.pwd_line)
        self.button_h_layout.addWidget(self.login_button)
        self.button_h_layout.addWidget(self.signin_button)
        self.all_v_layout.addLayout(self.user_h_layout)
        self.all_v_layout.addLayout(self.pwd_h_layout)
        self.all_v_layout.addLayout(self.button_h_layout)

        self.setLayout(self.all_v_layout)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    demo.show()
    sys.exit(app.exec_())

相比而言，这种布局方式更加清晰明了。

3.4 表单布局QFormLayout

表单布局可以将控件以两列的形式进行排布，左列控件为文本标签，右列为输入型的控件，如QLineEdit。用这个布局管理器我们可以更加快速方便地构写有表单的界面。我们用QFormLayout来改写下上面的代码：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QPushButton, \
    QHBoxLayout, QVBoxLayout, QFormLayout


class Demo(QWidget):

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

        self.user_label = QLabel('Username:', self)
        self.pwd_label = QLabel('Password:', self)
        self.user_line = QLineEdit(self)
        self.pwd_line = QLineEdit(self)
        self.login_button = QPushButton('Log in', self)
        self.signin_button = QPushButton('Sign in', self)

        self.f_layout = QFormLayout()                           # 1
        self.button_h_layout = QHBoxLayout()                     
        self.all_v_layout = QVBoxLayout()                        

        self.f_layout.addRow(self.user_label, self.user_line)   # 2
        self.f_layout.addRow(self.pwd_label, self.pwd_line)
        self.button_h_layout.addWidget(self.login_button)
        self.button_h_layout.addWidget(self.signin_button)
        self.all_v_layout.addLayout(self.f_layout)              # 3
        self.all_v_layout.addLayout(self.button_h_layout)

        self.setLayout(self.all_v_layout)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    demo.show()
    sys.exit(app.exec_())

1. 实例化一个QFormLayout控件；

2. 调用addRow()方法传入QLabel和QLineEdit控件；

3. 将表单布局添加到总布局中。

可以发现代码比之前的更加简洁了。

3.5 网格布局QGridLayout

当使用该布局管理器的时候，你可以把整个窗体想象成带有坐标的，然后只用把各个控件放在相应的坐标就好了，请看示例(还是上方的登录框)：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QPushButton, \
    QGridLayout, QVBoxLayout, QHBoxLayout


class Demo(QWidget):

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

        self.user_label = QLabel('Username:', self)
        self.pwd_label = QLabel('Password:', self)
        self.user_line = QLineEdit(self)
        self.pwd_line = QLineEdit(self)
        self.login_button = QPushButton('Log in', self)
        self.signin_button = QPushButton('Sign in', self)

        self.grid_layout = QGridLayout()                                # 1
        self.h_layout = QHBoxLayout()
        self.v_layout = QVBoxLayout()

        self.grid_layout.addWidget(self.user_label, 0, 0, 1, 1)         # 2
        self.grid_layout.addWidget(self.user_line, 0, 1, 1, 1)
        self.grid_layout.addWidget(self.pwd_label, 1, 0, 1, 1)
        self.grid_layout.addWidget(self.pwd_line, 1, 1, 1, 1)
        self.h_layout.addWidget(self.login_button)                     
        self.h_layout.addWidget(self.signin_button)
        self.v_layout.addLayout(self.grid_layout)                       # 3
        self.v_layout.addLayout(self.h_layout)                          # 4

        self.setLayout(self.v_layout)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    demo.show()
    sys.exit(app.exec_())

这里混合使用QVBoxLayout、QHBoxLayout和QGridLayout来完成布局。

1. 实例化一个QGridLayout布局管理器

2. QGridLayout的addWidget()方法遵循如下语法形式：

addWidget(widget, row, column, rowSpan, columnSpan)

widget就是要添加的控件；row为第几行，0代表第一行；column为第几列，0代表第一列；rowSpan表示要让这个控件去占用几行(默认一行)；columnSpan表示要让这个控件去占用几列(默认一列)。

在上方程序中，我们将self.user_label放在(0, 0)这个坐标，也就是第一行第一列，占用一行一列；将self.user_line放在(0, 1)，即第一行第二列，也就是self.user_label的右边，占用一行一列；将self.pwd_label放在(1, 0)，即第二行第一列，在self.user_label的正下方，占用一行一列；最后我们将self.pwd_line放在(1, 1)，即第二行第二列，占用一行一列。

因为默认都是一行一列，所以也可以写成：

self.grid_layout.addWidget(self.user_label, 0, 0)        
self.grid_layout.addWidget(self.user_line, 0, 1)
self.grid_layout.addWidget(self.pwd_label, 1, 0)
self.grid_layout.addWidget(self.pwd_line, 1, 1)

3-4. 最后，程序用垂直布局管理器将一个网格布局和一个水平布局添加进去。

当然你也可以尝试单单用QGridLayout来完成这次界面的布局，但是你会发现效果并不会让人很满意，可以自行去试一下。

合理的运用这三种布局方式可以在程序设计上事半功倍。

3.6 小结

1. QLineEdit控件为单行文本输入框；

2.. 了解四种布局方式：垂直布局QVBoxLayout、水平布局QHBoxLayout、表单布局QFormLayout和网格布局QGridLayout；

3. addWidget()方法用来添加控件，addLayout()方法用来添加布局；

4. 请记住QGridLayout的addWidget()语法形式：

addWidget(widget, row, column, rowSpan, columnSpan)

欢迎关注我的微信公众号，发现更多有趣内容：

《快速掌握PyQt5》第三章 布局管理

第三章 布局管理

3.1 垂直布局QVBoxLayout

3.2 水平布局QHBoxLayout

3.3 混合使用QVBoxLayout和QHBoxLayout

3.4 表单布局QFormLayout

3.5 网格布局QGridLayout

3.6 小结

《快速掌握PyQt5》第三章布局管理

第三章布局管理