博客

PyQt5 QBoxLayout类

  • Post category:Python

PyQt5是Python语言下的一个GUI（图形用户界面）库，用于构建桌面应用程序。QBoxLayout是PyQt5中用于布局的一个重要的类，其在PyQt中主要用于水平或垂直方向上的布局整理。本文将详细介绍QBoxLayout类的完整使用攻略，包括应用场景、方法、示例等。

应用场景

QBoxLayout类主要被用于布局整理，常见的应用场景有：

  • 在垂直方向上布置若干个控件，并能够自动适应窗口的大小调整；
  • 在水平方向上动态添加或者删除子控件；
  • 多个QBoxLayout组合成一个复杂的布局，从而实现灵活的布局。

方法介绍

构造函数

QBoxLayout有3个主要的构造函数：

QBoxLayout(QBoxLayout.Direction direction, QWidget parent = None)
QBoxLayout(Direction direction, QLayout parentLayout)
QBoxLayout(QBoxLayout.Direction direction)

其中，Direction指示布局方向，是一个枚举变量，可以为Qt.Vertical或者Qt.Horizontal。parent用于指定所属窗口或者父布局。第二个构造函数用于指定在一个已存在布局之上进行布局。

添加控件

QBoxLayout可以使用addWidget()方法来添加控件，示例如下：

# 垂直布局
from PyQt5.QtWidgets import QApplication, QWidget, QBoxLayout, QVBoxLayout, QLabel
import sys

app = QApplication(sys.argv)
window = QWidget()
layout = QVBoxLayout()

layout.addWidget(QLabel("Hello"))
layout.addWidget(QLabel("World"))

window.setLayout(layout)
window.show()

sys.exit(app.exec_())

以上代码实现了一个垂直布局，包含两个QLabel控件。这两个控件都会依次加入到QVBoxLayout对象中。

禁止缩放

QBoxLayout在默认情况下，会随着窗口的缩放而动态调整布局，如果需要固定位置，可以使用addStretch()方法来禁止缩放。示例如下：

# 垂直布局（禁止缩放）
from PyQt5.QtWidgets import QApplication, QWidget, QBoxLayout, QVBoxLayout, QLabel
import sys

app = QApplication(sys.argv)
window = QWidget()
layout = QVBoxLayout()

layout.addWidget(QLabel("Hello"))
layout.addWidget(QLabel("World"))
layout.addStretch()

window.setLayout(layout)
window.show()

sys.exit(app.exec_())

添加子布局

QBoxLayout还支持添加子布局，示例如下：

# 垂直布局组合水平布局
from PyQt5.QtWidgets import QApplication, QWidget, QBoxLayout, QVBoxLayout, QHBoxLayout, QLabel
import sys

app = QApplication(sys.argv)
window = QWidget()
layout1 = QVBoxLayout()
layout2 = QHBoxLayout()

layout2.addWidget(QLabel("Hello"))
layout2.addWidget(QLabel("World"))

layout1.addLayout(layout2)

window.setLayout(layout1)
window.show()

sys.exit(app.exec_())

以上代码实现了一个垂直布局，其中包含了一个水平布局，水平布局中包含了两个QLabel控件，同时这两个QLabel控件位于垂直布局的最上方。

添加拉伸比例

当在布局中添加多个控件时，可以使用addStretch()方法来设置控件间的拉伸比例，示例如下：

# 水平布局，添加拉伸比例
from PyQt5.QtWidgets import QApplication, QWidget, QBoxLayout, QHBoxLayout, QLabel
import sys

app = QApplication(sys.argv)
window = QWidget()
layout = QHBoxLayout()

layout.addWidget(QLabel("Hello"))
# 设置空间的拉伸比例为1
layout.addStretch(1)
layout.addWidget(QLabel("World"))
layout.addStretch(1)

window.setLayout(layout)
window.show()

sys.exit(app.exec_())

以上代码实现了一个水平布局，其中包含了两个QLabel控件，同时在这两个控件之间分别添加了拉伸比例为1的Stretch()控件，使得左右两个Label平分布局空间。

示例

本节将演示两个实际的布局案例来说明QBoxLayout的使用方式。

示例一：实现一个简单的计算器界面

下面展示如何使用QBoxLayout来实现一个简单的计算器的界面。

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

app = QApplication(sys.argv)
window = QWidget()
layout1 = QVBoxLayout()

# 文本输入框
input_text = QLineEdit()
layout1.addWidget(input_text)

# 行布局，包含2个按钮
layout2 = QHBoxLayout()
button1 = QPushButton("OK")
button2 = QPushButton("Cancel")
layout2.addWidget(button1)
layout2.addWidget(button2)

# 将行布局添加到主垂直布局
layout1.addLayout(layout2)

# 窗口实例绑定主布局
window.setLayout(layout1)
window.show()

sys.exit(app.exec_())

示例二：组合多个水平布局组成一个大布局

下面展示如何将多个水平布局组合成一个大布局。

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

app = QApplication(sys.argv)
window = QWidget()

# 子水平布局1
layout1 = QHBoxLayout()
layout1.addWidget(QLabel("Name"))
name_input = QLineEdit()
layout1.addWidget(name_input)

# 子水平布局2
layout2 = QHBoxLayout()
layout2.addWidget(QLabel("Age"))
age_input = QLineEdit()
layout2.addWidget(age_input)

# 子水平布局3
layout3 = QHBoxLayout()
layout3.addWidget(QLabel("Phone"))
phone_input = QLineEdit()
layout3.addWidget(phone_input)

# 主垂直布局，包含多个水平布局
main_layout = QVBoxLayout()
main_layout.addLayout(layout1)
main_layout.addLayout(layout2)
main_layout.addLayout(layout3)

# 窗口实例绑定主布局
window.setLayout(main_layout)
window.show()

sys.exit(app.exec_())

以上代码实现了一个3行2列布局，其中每行布局均为水平布局，每个水平布局中包含一个QLabel控件和一个QLineEdit控件。所有的水平布局又组合成一个大的垂直布局，实现将多个子控件和子布局组合成为一个大布局的功能。

总结

本文通过对PyQt5 QBoxLayout类的介绍，详细讲解了其基础知识、方法介绍与使用示例等，希望能帮助读者更好的掌握布局结构的相关知识，实现更加丰富的桌面应用程序。

Tags: