PyQt5 QHBoxLayout 布局控件详解：方法、参数与对齐实例

Evan

发布时间：2026-10-13| 4人浏览过

原创

本文详细介绍 PyQt5 中 QHBoxLayout 水平布局控件的使用方法。涵盖从控件添加到间距设置，再到利用 Qt.Alignment 参数实现精确对齐的完整流程。通过具体代码实例演示如何控制按钮在水平方向的排列、伸缩量及垂直对齐位置，帮助开发者掌握 PyQt5 界面布局的核心技巧。

PyQt5 布局控件 QHBoxLayout 简介

在 PyQt5 中，可以使用 QBoxLayout 类的子类在水平和垂直方向上排列界面控件。其中，QHBoxLayout 和 QVBoxLayout 均继承自 QBoxLayout，分别用于处理水平布局和垂直布局。

使用 QHBoxLayout 类时，控件会按照从左到右的顺序依次添加到布局中。

QHBoxLayout 类中常用的方法如下

方法	描述
addLayout(self,stretch=0)	在窗口的右边添加布局，使用stretch（伸缩量）进行伸缩，伸缩量默认为0
addWidget(self,QWidget.stretch,Qt.Alignmeny alihnment)	在布局中添加控件
	stretch（伸缩量），只适用于QBoxLayout，控件和窗口会随着伸缩量的变大而增大
	alignment：指定的对齐方式
addSpacing(self,int)	设置各控件的上下间距，通过该方法可以增加额外的控件

QHBoxLayout 对齐方式参数

参数	描述
Qt.AlignLeft	水平方向居左对齐
Qt.AlignRight水平方向具有对齐
Qt.AlignCenter	水平方向居中对齐
Qt.AlignJustify	水平方向两端对齐
Qt.AlignTop	垂直方向靠上对齐
Qt.AlignBottom	垂直方向靠下对齐
Qt.AlignVCenter	垂直方向居中对齐

QHBoxLayout 水平布局管理实例


import sys
from PyQt5.QtWidgets import QApplication ,QWidget ,QHBoxLayout , QPushButton
class Winform(QWidget):
  def __init__(self,parent=None):
    super(Winform,self).__init__(parent)
    self.setWindowTitle("水平布局管理例子") 
    # 水平布局按照从左到右的顺序进行添加按钮部件。
    hlayout = QHBoxLayout()    
    hlayout.addWidget( QPushButton(str(1)))
    hlayout.addWidget( QPushButton(str(2)))
    hlayout.addWidget( QPushButton(str(3)))
    hlayout.addWidget( QPushButton(str(4)))    
    hlayout.addWidget( QPushButton(str(5)))    
    # todo 优化1 设置控件间距
    #hlayout.setSpacing(20)
    self.setLayout(hlayout)  
if __name__ == "__main__": 
    app = QApplication(sys.argv) 
    form = Winform()
    form.show()
    sys.exit(app.exec_())

运行效果图

优化一：设置各控件之间的间距

hlayout.setSpacing(20)

QHBoxLayout 水平布局对齐方式实例

在某些场景下，需要将布局中的部分控件进行居中或靠下显示，此时可以通过对齐方式参数 Qt.Alignment 来设置。具体示范代码如下


import sys
from PyQt5.QtWidgets import QApplication ,QWidget ,QHBoxLayout , QPushButton
from PyQt5.QtCore import Qt 
class Winform(QWidget):
  def __init__(self,parent=None):
    super(Winform,self).__init__(parent)
    self.setWindowTitle("水平布局管理例子") 
    self.resize(800, 200)
    # 水平布局按照从左到右的顺序进行添加按钮部件。
    hlayout = QHBoxLayout() 
    #水平居左 垂直居上   
    hlayout.addWidget( QPushButton(str(1)) , 0 , Qt.AlignLeft | Qt.AlignTop)
    hlayout.addWidget( QPushButton(str(2)) , 0 , Qt.AlignLeft | Qt.AlignTop)
    hlayout.addWidget( QPushButton(str(3)))
    #水平居左 垂直居下
    hlayout.addWidget( QPushButton(str(4)) , 0 , Qt.AlignLeft | Qt.AlignBottom )    
    hlayout.addWidget( QPushButton(str(5)), 0 , Qt.AlignLeft | Qt.AlignBottom)  
    self.setLayout(hlayout)  
if __name__ == "__main__": 
  app = QApplication(sys.argv) 
  form = Winform()
  form.show()
  sys.exit(app.exec_())

运行效果图如下