### QHBoxLayout 的基本用法 在 PyQt5 中，`QHBoxLayout` 是一种用于水平排列控件的布局管理器，能够将控件从左到右依次排列。它属于 `QtWidgets` 模块中的布局类，常用于构建界面时对控件进行整齐排列和自动调整大小。 要使用 `QHBoxLayout`，首先需要导入相应的模块： ```python from PyQt5.QtWidgets import QHBoxLayout, QPushButton, QWidget, QApplication ``` 接着可以创建一个主窗口，并将 `QHBoxLayout` 应用于其中： ```python app = QApplication([]) window = QWidget() layout = QHBoxLayout() button1 = QPushButton("Button 1") button2 = QPushButton("Button 2") button3 = QPushButton("Button 3") layout.addWidget(button1) layout.addWidget(button2) layout.addWidget(button3) window.setLayout(layout) window.show() app.exec_() ``` 通过这种方式，三个按钮会按照水平方向依次排列，并自动调整间距和大小，以适应窗口的变化[^1]。 ### QHBoxLayout 的常用方法 `QHBoxLayout` 提供了多种方法用于添加控件、嵌套布局和设置控件的对齐方式。例如，`addWidget()` 方法可以将控件添加到布局中，并允许指定伸缩量（stretch）和对齐方式（alignment）： ```python layout.addWidget(button1, stretch=1, alignment=Qt.AlignLeft) ``` 其中 `stretch` 参数用于设置控件的伸缩比例，数值越大，控件在可用空间中占据的比例越高；`alignment` 参数则用于指定控件在布局中的对齐方式，如左对齐（`Qt.AlignLeft`）、右对齐（`Qt.AlignRight`）等[^3]。 此外，`addLayout()` 方法可以将另一个布局嵌套到当前布局中，适用于构建更复杂的界面结构： ```python sub_layout = QHBoxLayout() sub_layout.addWidget(QPushButton("Sub Button 1")) sub_layout.addWidget(QPushButton("Sub Button 2")) layout.addLayout(sub_layout) ``` 还可以使用 `addSpacing()` 方法在控件之间添加额外的空白间距： ```python layout.addSpacing(20) # 添加 20 像素的空白间距 ``` 这些方法使得 `QHBoxLayout` 在实际开发中具有高度的灵活性和可定制性。 ### QHBoxLayout 的实际应用 在实际开发中，`QHBoxLayout` 常用于创建工具栏、按钮组等需要水平排列的控件组合。例如，在一个简单的计算器界面中，可以通过 `QHBoxLayout` 来排列数字按钮： ```python from PyQt5.QtWidgets import QPushButton, QHBoxLayout, QWidget, QApplication from PyQt5.QtCore import Qt app = QApplication([]) window = QWidget() layout = QHBoxLayout() buttons = ["1", "2", "3", "4"] for btn_text in buttons: btn = QPushButton(btn_text) layout.addWidget(btn, stretch=1) window.setLayout(layout) window.setWindowTitle("QHBoxLayout Example") window.show() app.exec_() ``` 在这个示例中，四个按钮会均匀分布在水平方向上，且随着窗口大小的变化自动调整布局[^2]。 ---