PyQt5 入门教程：基础架构与常用控件详解

布局管理器

手动设置控件坐标非常繁琐且难以适配不同分辨率。PyQt5 提供了布局管理器自动排列控件：

• QVBoxLayout：垂直排列（从上到下）。
• QHBoxLayout：水平排列（从左到右）。
• QGridLayout：网格排列（行列定位）。

布局实战

下面演示如何组合垂直和水平布局：

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

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("布局示例")
        
        # 主窗口需要中央控件
        central_widget = QWidget(self)
        self.setCentralWidget(central_widget)
        
        # 垂直布局
        vbox = QVBoxLayout()
        label = QLabel("这是一个标签")
        vbox.addWidget(label)
        
        # 水平布局
        hbox = QHBoxLayout()
        btn1 = QPushButton("按钮 1")
        btn2 = QPushButton("按钮 2")
        hbox.addWidget(btn1)
        hbox.addWidget(btn2)
        
        # 嵌套布局
        vbox.addLayout(hbox)
        central_widget.setLayout(vbox)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

通过 addLayout 可以将水平布局嵌入垂直布局中，实现灵活的界面结构。

常用控件详解

QLabel（标签）

用于显示文本或图片。可以设置对齐方式、字体等属性。

from PyQt5.QtWidgets import QApplication, QLabel, QMainWindow
from PyQt5.QtCore import Qt
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("QLabel 示例")
        label = QLabel("居中对齐的文本", self)
        label.setAlignment(Qt.AlignCenter)
        self.setCentralWidget(label)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

QPushButton（按钮）

最常用的交互控件。通过连接信号（Signal）和槽（Slot）来处理点击事件。

from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("按钮示例")
        button = QPushButton("点击我", self)
        button.clicked.connect(self.on_click)
        self.setCentralWidget(button)

    def on_click(self):
        print("按钮被点击！")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

QLineEdit（单行文本框）

接收用户输入的文本框。监听回车键信号可获取输入内容。

from PyQt5.QtWidgets import QApplication, QMainWindow, QLineEdit
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("输入框示例")
        self.line_edit = QLineEdit(self)
        self.line_edit.setPlaceholderText("请输入文本")
        self.line_edit.returnPressed.connect(self.get_input)
        self.setCentralWidget(self.line_edit)

    def get_input(self):
        text = self.line_edit.text()
        print(f"用户输入：{text}")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

QCheckBox（复选框）与 QComboBox（下拉列表）

复选框用于多选状态，下拉列表用于选项选择。两者都通过 stateChanged 或 currentIndexChanged 信号触发回调。

from PyQt5.QtWidgets import QApplication, QMainWindow, QCheckBox, QComboBox
from PyQt5.QtCore import Qt
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("控件示例")
        
        # 复选框
        checkbox = QCheckBox("同意条款", self)
        checkbox.stateChanged.connect(self.check_changed)
        
        # 下拉列表
        self.combobox = QComboBox(self)
        self.combobox.addItems(["选项 1", "选项 2", "选项 3"])
        self.combobox.currentIndexChanged.connect(self.option_changed)
        
        # 简单布局展示
        layout = QVBoxLayout()
        layout.addWidget(checkbox)
        layout.addWidget(self.combobox)
        
        widget = QWidget()
        widget.setLayout(layout)
        self.setCentralWidget(widget)

    def check_changed(self, state):
        print("复选框状态：" + ("勾选" if state == Qt.Checked else "未勾选"))

    def option_changed(self, index):
        print(f"当前选中：{self.combobox.currentText()}")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

总结

本部分涵盖了 PyQt5 的核心基础：

1. 环境搭建：使用 pip 安装依赖。
2. 窗口结构：理解 QApplication 生命周期和 QMainWindow 布局。
3. 布局管理：利用 QVBoxLayout、QHBoxLayout 和 QGridLayout 替代绝对定位。
4. 常用控件：掌握了标签、按钮、输入框及复选框的基本用法和信号连接。

这些是构建复杂桌面应用的基石，后续可在此基础上扩展更多自定义组件和功能。