博客

PyQt5 – QSplitter小工具

  • Post category:Python

PyQt5是一种Python的GUI编程框架，它提供了各种小工具（widget）来帮助我们快速构建各种可视化应用。其中QSplitter小工具可以让我们轻松地将一个界面分割成多个部分，使得用户可以自由地调整这些区块的大小和位置。下面是一个关于如何使用QSplitter小工具的完整攻略。

安装PyQt5

首先，我们需要安装PyQt5库，你可以使用pip命令来进行安装：

pip install PyQt5

创建QSplitter小工具

我们需要先创建一个QSplitter小工具，并将其加入我们的主界面。在下面的示例中，我们先创建一个水平方向的QSplitter，再将其添加到一个QWidget对象中： 

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

class MyApp(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        splitter = QSplitter()
        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('QSplitter Example')
        self.show()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = MyApp()
    sys.exit(app.exec_())

在上面的代码中，我们首先导入了PyQt5的QApplication、QWidget和QSplitter等相关模块。然后，在MyApp类的构造函数中，我们创建了一个QSplitter对象，并调用initUI()方法来初始化主界面。在initUI()方法中，我们设置了窗口的初始位置和大小，并将窗口标题设置为”QSplitter Example”。最后，通过调用show()方法来显示窗口。

向QSplitter对象中添加控件

然后，我们需要向QSplitter对象中添加控件，以显示多个小区块。在下面的示例中，我们向水平方向的QSplitter对象中添加了两个QLineEdit控件：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QSplitter, QLineEdit

class MyApp(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        splitter = QSplitter()
        leftWidget = QLineEdit()
        rightWidget = QLineEdit()
        splitter.addWidget(leftWidget)
        splitter.addWidget(rightWidget)
        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('QSplitter Example')
        self.show()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = MyApp()
    sys.exit(app.exec_())

在上面的代码中，我们首先创建了两个QLineEdit控件，然后通过调用splitter对象的addWidget()方法将它们添加到水平方向的splitter对象中。

设置QSplitter对象的尺寸

QSplitter对象可以设置每个小部件之间的初始大小，以及随着用户调整大小时小部件的最小/最大大小。在下面的示例中，我们设置了左边的QLineEdit控件的初始大小为200px，右边的QLineEdit控件的最小值为100px：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QSplitter, QLineEdit

class MyApp(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        splitter = QSplitter()
        leftWidget = QLineEdit()
        leftWidget.setFixedWidth(200)
        rightWidget = QLineEdit()
        rightWidget.setMinimumWidth(100)
        splitter.addWidget(leftWidget)
        splitter.addWidget(rightWidget)
        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('QSplitter Example')
        self.show()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = MyApp()
    sys.exit(app.exec_())

在上面的代码中，我们分别设置了左边的QLineEdit控件的固定宽度为200px，和右边的QLineEdit控件的最小宽度为100px。

示例1

在下面这个示例中，我们创建了一个纵向的QSplitter小工具，并在其中添加了两个按钮。当用户放大或缩小窗口，QSplitter小工具会自动地调整按钮的大小。

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QSplitter, QPushButton

class MyApp(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        splitter = QSplitter()
        splitter.setOrientation(Qt.Vertical)
        topWidget = QPushButton('Top Button')
        bottomWidget = QPushButton('Bottom Button')
        splitter.addWidget(topWidget)
        splitter.addWidget(bottomWidget)
        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('QSplitter Example')
        self.show()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = MyApp()
    sys.exit(app.exec_())

在上面的代码中，我们创建了一个纵向的QSplitter小工具，并添加了两个QPushButton控件。当用户放大或缩小窗口时，QSplitter小工具将会自动地调整按钮的大小。

示例2

在下个示例中，我们创建了一个水平方向的QSplitter小工具，并在其中添加了两个QTextEdit控件。我们还设置了QSplitter的最小分割值为20。这意味着用户无法将任何一个部分缩小到小于20个像素。

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QSplitter, QTextEdit

class MyApp(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        splitter = QSplitter()
        splitter.setHandleWidth(10)
        splitter.setSizes([100, 300])
        leftWidget = QTextEdit()
        rightWidget = QTextEdit()
        splitter.addWidget(leftWidget)
        splitter.addWidget(rightWidget)
        splitter.setStretchFactor(0, 1)
        splitter.setStretchFactor(1, 2)
        splitter.setMinimumWidth(20)
        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('QSplitter Example')
        self.show()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = MyApp()
    sys.exit(app.exec_())

在上面的代码中，我们设置了QSplitter的handle宽度为10px，并且通过setSizes()方法将左边的部分设置为100px，右边的部分设置为300px。我们还调用了setStretchFactor()方法来指定左/右两个部分的相对拉伸比例。最后，我们还将QSplitter的最小宽度设置为20px。

以上两个示例仅仅是使用QSplitter小工具的简单实现。你可以尝试通过配置不同的参数来生成不同的效果。

Tags: