PyQt5 代码笔记

用代码学 PyQt5 !

重要说明！！

新版 「PySide6 代码教程」 初稿已经接近完成！本项目的更新也渐趋结束，新内容的补充完善会集中在新版教程。

新教程有如下升级：

Python 3.10 + PySide 6.3，版本新、功能更强大
项目组织结构更清晰
代码中注释讲解比例更高、更详细
PySide 由 Qt 官方提供支持，比 PyQt 许可更宽松、文档更全面

欢迎新老读者前往阅读和提供贡献！

基本说明

每个模块（.py文件）都可运行，展示了各种控件的各种功能属性作用，代码中有注释讲解
在自己的机器上实际运行一下，仔细观察一下每个属性值的改变会怎样影响控件的外观行为，可能比静态的文档教程更有效。
目前还在更新完善中，也期待小伙伴加入，共同完善这个仓库（提交 PR 或者联系作者）
由于作者精力有限，Gitee仓库的更新维护可能不及时，最新修改以 GitHub仓库为准

使用方法

Star 收藏本仓库，便于查找
克隆本仓库到本地（ git clone https://github.com/muziing/PyQt_practice.git ），或下载 zip 归档并解压
创建虚拟环境并激活
- Windows: python -m venv venv venv\Scripts\activate
- Linux/macOS: python3 -m venv venv . venv/bin/activate
在命令行执行 pip install -r requirements.txt 安装依赖
进入你感兴趣的控件对应的文件夹，运行任何一个.py文件观察效果
对于大多数目录，首个文件都是一个 Markdown 文档，为 Qt 官方文档对应的中文翻译并简单整理版

以 47-QListView 目录下的 02-QListView-自动换行、布局间距、对齐、单词省略.py 为例：

# 02-QListView-自动换行、布局间距、对齐、单词省略.py
from PyQt5.Qt import *
import sys


class Window(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("QListView-自动换行、布局间距、对齐、单词省略")
        self.resize(500, 500)
        self.data_list = [f"Item{i}" for i in range(15)]  # 将数据列表保存在属性中
        self.data_list.append("Something very very long")  # 再添加一个特殊的很长的项
        self.setup_ui()

    def setup_ui(self):
        btn = QPushButton("增大Spacing", self)
        btn.move(350, 200)
        list_view = QListView(self)  # 创建list view对象
        list_view.move(100, 100)
        list_view.resize(200, 200)
        slm = QStringListModel()  # 创建model模型
        slm.setStringList(self.data_list)  # 为模型设置数据
        list_view.setModel(slm)  # 为视图设置模型

        # -------自动换行---------
        list_view.setWrapping(True)  # 打开自动换行
        # 对于 Flow 为 TopToBottom，应该叫做“自动换列”，垂直空间不能一次全部显示所有项时，再右侧再加一列显示，而不是加滚动条

        # -------布局间距--------
        list_view.setSpacing(10)  # 默认为0

        def test_slot():
            """测试按钮的槽函数"""
            list_view.setSpacing(list_view.spacing() + 5)  # 修改此值会导致重新布局

        btn.clicked.connect(test_slot)

        # --------对齐-----------
        # setItemAlignment 只有在 ListMode 为 TopToBottom 且 wrapping 打开时才有效
        # list_view.setItemAlignment(Qt.AlignTop)  # 垂直靠上对齐
        list_view.setItemAlignment(Qt.AlignVCenter | Qt.AlignLeft)  # 垂直居中，水平靠左对齐

        # ------单词省略------
        list_view.setWordWrap(True)  # 启用单词省略，太长的文本将收到省略号...中
        # list_view.setTextElideMode(Qt.ElideLeft)  # 省略号在最左侧
        list_view.setTextElideMode(Qt.ElideMiddle)  # 省略号在中间
        # list_view.setTextElideMode(Qt.ElideNone)  # 无省略号，但是最后的内容仍然会被省略


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