ZetCode

PySide 中的布局管理

最后修改于 2023 年 10 月 18 日

GUI 编程中重要的事情是布局管理。布局管理是我们在窗口上放置小部件的方式。管理可以通过两种方式完成。我们可以使用绝对定位布局类

绝对定位

程序员以像素为单位指定每个小部件的位置和大小。当您使用绝对定位时,您必须理解一些事情。

#!/usr/bin/python

"""
ZetCode PySide tutorial 

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

author: Jan Bodnar
website: zetcode.com
"""

import sys
from PySide import QtGui

class Example(QtGui.QWidget):
    
    def __init__(self):
        super(Example, self).__init__()
        
        self.initUI()
        
    def initUI(self):
        
        label1 = QtGui.QLabel('Zetcode', self)
        label1.move(15, 10)

        label2 = QtGui.QLabel('tutorials', self)
        label2.move(35, 40)
        
        label3 = QtGui.QLabel('for programmers', self)
        label3.move(55, 70)        
        
        self.setGeometry(300, 300, 250, 150)
        self.setWindowTitle('Absolute')    
        self.show()
        
def main():
    
    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

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

Absolute positioning
图:绝对定位

Box 布局

使用布局类的布局管理更加灵活和实用。这是在窗口上放置小部件的首选方式。基本的布局类是 QtGui.QHBoxLayoutQtGui.QVBoxLayout。它们水平和垂直地排列小部件。

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

#!/usr/bin/python

"""
ZetCode PySide 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 PySide import QtGui

class Example(QtGui.QWidget):
    
    def __init__(self):
        super(Example, self).__init__()
        
        self.initUI()
        
    def initUI(self):
        
        okButton = QtGui.QPushButton("OK")
        cancelButton = QtGui.QPushButton("Cancel")

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

        vbox = QtGui.QVBoxLayout()
        vbox.addStretch(1)
        vbox.addLayout(hbox)
        
        self.setLayout(vbox)    
        
        self.setGeometry(300, 300, 300, 150)
        self.setWindowTitle('Buttons')    
        self.show()
        
def main():
    
    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

该示例将两个按钮放置在窗口的右下角。当我们调整应用程序窗口大小时,它们会留在那里。我们同时使用 QtGui.HBoxLayoutQtGui.QVBoxLayout

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

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

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

我们创建一个水平盒布局。添加一个拉伸因子和两个按钮。拉伸在两个按钮之前添加一个可拉伸的空间。这将把它们推到窗口的右侧。

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

要创建必要的布局,我们将一个水平布局放入一个垂直布局。垂直框中的拉伸因子会将带有按钮的水平框推到窗口的底部。

self.setLayout(vbox)

最后,我们设置窗口的基本布局。它是垂直框。

Buttons example
图:按钮示例

网格布局

PySide 中最通用的布局类是网格布局。此布局将空间划分为行和列。要创建网格布局,我们使用 QtGui.QGridLayout 类。

#!/usr/bin/python

"""
ZetCode PySide tutorial 

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

author: Jan Bodnar
website: zetcode.com
"""

import sys
from PySide import QtGui

class Example(QtGui.QWidget):
    
    def __init__(self):
        super(Example, self).__init__()
        
        self.initUI()
        
    def initUI(self):
        
        names = ['Cls', 'Bck', '', 'Close', '7', '8', '9', '/',
                '4', '5', '6', '*', '1', '2', '3', '-',
                '0', '.', '=', '+']

        grid = QtGui.QGridLayout()

        j = 0
        pos = [(0, 0), (0, 1), (0, 2), (0, 3),
                (1, 0), (1, 1), (1, 2), (1, 3),
                (2, 0), (2, 1), (2, 2), (2, 3),
                (3, 0), (3, 1), (3, 2), (3, 3 ),
                (4, 0), (4, 1), (4, 2), (4, 3)]

        for i in names:
            button = QtGui.QPushButton(i)
            if j == 2:
                grid.addWidget(QtGui.QLabel(''), 0, 2)
            else: grid.addWidget(button, pos[j][0], pos[j][1])
            j = j + 1

        self.setLayout(grid)   
        
        self.move(300, 150)
        self.setWindowTitle('Calculator')    
        self.show()
        
def main():
    
    app = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

在我们的示例中,我们创建了一个按钮网格。为了填补一个空隙,我们还添加了一个 QtGui.QLabel 小部件。

grid = QtGui.QGridLayout()

在这里,我们创建一个网格布局。

if j == 2:
    grid.addWidget(QtGui.QLabel(''), 0, 2)
else: grid.addWidget(button, pos[j][0], pos[j][1])

要将一个小部件添加到网格,我们调用 addWidget 方法。参数是小部件、行号和列号。

Calculator skeleton
图:计算器骨架

复习示例

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

#!/usr/bin/python

"""
ZetCode PySide 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 PySide import QtGui

class Example(QtGui.QWidget):
    
    def __init__(self):
        super(Example, self).__init__()
        
        self.initUI()
        
    def initUI(self):
        
        title = QtGui.QLabel('Title')
        author = QtGui.QLabel('Author')
        review = QtGui.QLabel('Review')

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

        grid = QtGui.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 = QtGui.QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

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

grid = QtGui.QGridLayout()
grid.setSpacing(10)

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

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

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

Review example
图:复习示例

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