Add 03-12-03-04

QFileDialog-过滤器；
QDir-Filters-枚举值；

Author: muziing

03-QtWidgets-常用控件/12-Dialog-对话框/03-QFileDialog-文件对话框/04-QFileDialog-过滤器.py

@@ -0,0 +1,74 @@
+import sys
+
+from PySide6 import QtWidgets
+from PySide6.QtCore import QDir
+
+"""
+QFileDialog 过滤器
+
+================================ 目录过滤器 ===================================
+文件对话框支持QDir.Filters式过滤器，可以只显示满足过滤器要求的文件/目录
+
+QDir.Filters枚举值详情参见本节附录
+
+.setFilter(filters: QDir.Filters)
+.filter() -> QDir.Filters
+
+================================ 名称过滤器 ===================================
+
+.setNameFilters(filters: Sequence[str])
+.setNameFilter(filter: str)
+.nameFilters() -> Sequence[str]
+
+============================== 媒体类型过滤器 =================================
+还支持按媒体类型（MIME类型）分类过滤
+这是setNameFilters()的便捷方法
+调用setMimeTypeFilters会覆盖任何先前设置的名称过滤器，并更改nameFilters()的返回值
+
+关于什么是MIME，可以参考：https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types
+
+.setMimeTypeFilters(filters: Sequence[str])
+.mimeTypeFilters() -> Sequence[str]
+"""
+
+
+class MyWidget(QtWidgets.QWidget):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.dialog = QtWidgets.QFileDialog(self)
+        self.setup_dialog()  # 在展示对话框前先完成设置
+        self.setup_ui()
+
+    def setup_dialog(self) -> None:
+        """设置文件对话框"""
+
+        # QDir过滤器
+        self.dialog.setFilter(QDir.NoDotAndDotDot)  # 不显示.和..，主要在类Unix系统下有意义
+
+        # 名称过滤器（会被设置MIME覆盖掉，测试时需注释掉MIME过滤器部分）
+        self.dialog.setNameFilters(
+            ("Python files (*.py *.pyi *.pyc *.pyw)", "Markdown files (*.md)", "Any files (*)")
+        )
+
+        # MIME过滤器
+        # self.dialog.setMimeTypeFilters(("text/markdown", "image/jpeg", "application/octet-stream"))
+
+    def setup_ui(self) -> None:
+        """设置界面"""
+
+        self.setWindowTitle("QFileDialog-过滤器")
+        self.resize(800, 600)
+        browse_btn = QtWidgets.QPushButton("选择单个文件", self)
+        browse_btn.move(150, 200)
+        browse_btn.clicked.connect(self.dialog.open)  # type: ignore
+        info_le = QtWidgets.QLineEdit(self)
+        info_le.move(150, 250)
+        info_le.setMinimumWidth(600)
+        self.dialog.fileSelected.connect(lambda path: info_le.setText(path))  # type: ignore
+
+
+if __name__ == "__main__":
+    app = QtWidgets.QApplication(sys.argv)
+    window = MyWidget()
+    window.show()
+    sys.exit(app.exec())

03-QtWidgets-常用控件/12-Dialog-对话框/03-QFileDialog-文件对话框/a2-QDir-Filters枚举值.md

@@ -0,0 +1,22 @@
+# QDir.Filters
+
+<https://doc.qt.io/qt-6/qdir.html#Filter-enum>
+
+| 常量           | 值                      | 描述                                                         |
+| -------------- | ----------------------- | ------------------------------------------------------------ |
+| Dirs           | 0x001                   | 列出与过滤器匹配的目录                                       |
+| AllDirs        | 0x400                   | 列出所有目录，即不对目录名使用过滤器                         |
+| Files          | 0x002                   | 列出文件                                                     |
+| Drives         | 0x004                   | 列出磁盘驱动器（在Unix下忽略）                               |
+| NoSymLinks     | 0x008                   | 不要列出符号链接（在不支持符号链接的操作系统上忽略）         |
+| NoDotAndDotDot | NoDot \| NoDotDot       | 不要列出特殊条目"."和".."                                    |
+| NoDot          | 0x2000                  | 不要列出特殊条目"."                                          |
+| NoDotDot       | 0x4000                  | 不要列出特殊条目".."                                         |
+| AllEntries     | Dirs \| Files \| Drives | 列出目录、文件、驱动器和符号链接（除非指定System,否则不会列出损坏的符号链接） |
+| Readable       | 0x010                   | 列出应用程序对其具有读取权限的文件。需要与Dirs或Files结合使用 |
+| Writable       | 0x020                   | 列出应用程序对其具有写入权限的文件。需要与Dirs或Files结合使用 |
+| Executable     | 0x040                   | 列出应用程序对其具有执行权限的文件。需要与Dirs或Files结合使用 |
+| Modified       | 0x080                   | 仅列出已修改的文件（在Unix上忽略）                           |
+| Hidden         | 0x100                   | 列出隐藏文件（在Unix平台上那些以"."开头的文件）              |
+| System         | 0x200                   | 列出系统文件（在Unix上包括FIFO、套接字和设备文件；在Windows上包括.lnk文件） |
+| CaseSensitive  | 0x800                   | 过滤器区分大小写                                             |