1. QWidget - 最基础的窗口类#

1
from PySide6.QtWidgets import QWidget
2

3
class MyWindow(QWidget):
4
    def __init__(self):
5
        super().__init__()
6
        self.setWindowTitle("基础窗口")
7
        self.resize(400, 300)

核心特点：

• 所有用户界面组件的基类，最纯粹的窗口

• 没有预设的布局和任何内置组件

• 完全空白的画布，需要你自己添加所有元素

• 内存占用最小，性能最好

典型使用场景：

• 简单的自定义窗口

• 作为其他复杂窗口的子部件

• 不需要菜单栏、工具栏等标准窗口元素的场景

• 自定义控件的基类

优点：最灵活、最轻量、完全可控 缺点：没有任何内置功能，所有东西都需要自己实现

2. QMainWindow - 主应用窗口类#

1
from PySide6.QtWidgets import QMainWindow
2

3
class MyWindow(QMainWindow):
4
    def __init__(self):
5
        super().__init__()
6
        self.setWindowTitle("主应用窗口")
7
        self.resize(800, 600)
8

9
        # 必须设置中心部件
10
        central_widget = QWidget()
11
        self.setCentralWidget(central_widget)
12
        self.main_layout = QVBoxLayout()
13
         # 布局必须挂载到central_widget 中，不能是self，也就是说不能是QMainWindow
14
        central_widget.setLayout(self.main_layout)
15

16
        # 可以添加菜单栏、工具栏、状态栏等
17
        self.statusBar().showMessage("状态栏信息")

核心特点：

• 专门设计用于应用程序的主窗口

• 内置标准窗口框架：菜单栏、工具栏、状态栏、停靠窗口

• 有一个强制的中心部件（central widget），所有主要内容都放在这里

• 支持多文档界面（MDI）

典型使用场景：

• 应用程序的主窗口

• 需要菜单栏、工具栏、状态栏的复杂应用

• 支持停靠窗口（如 IDE 的侧边栏）的应用

优点：提供完整的主窗口框架，符合用户使用习惯 缺点：相对较重，必须设置中心部件，不能直接使用布局

重要注意事项：

• 不能直接对 QMainWindow 本身设置布局，必须先设置中心部件，然后对中心部件设置布局

• 菜单栏、工具栏等是 QMainWindow 的专属功能，QWidget 没有

3. QDialog - 对话框类#

1
from PySide6.QtWidgets import QDialog, QVBoxLayout, QPushButton
2

3
class MyWindow(QDialog):
4
    def __init__(self):
5
        super().__init__()
6
        self.setWindowTitle("对话框")
7
        self.resize(300, 200)
8

9
        layout = QVBoxLayout(self)
10
        layout.addWidget(QPushButton("确定"))
11
        layout.addWidget(QPushButton("取消"))

核心特点：

• 用于短期任务和与用户进行简短交互的窗口

• 有模态（modal）和非模态两种模式

• 模态对话框会阻塞父窗口的输入

• 通常有 "确定" 和 "取消" 按钮

• 支持返回结果（通过 exec\(\) 方法）

典型使用场景：

• 登录窗口

• 设置 / 首选项窗口

• 确认对话框

• 文件选择 / 保存对话框

• 进度对话框

优点：

• 专门为交互设计，使用简单

• 支持模态操作，确保用户完成当前任务

• 有标准的按钮和返回值机制

缺点：

• 不适合作为应用程序的主窗口

• 模态对话框会阻塞程序流程

重要方法：

• exec\(\)：以模态方式显示对话框，阻塞直到用户关闭

• show\(\)：以非模态方式显示对话框

• accept\(\)：接受对话框，返回 QDialog.Accepted

• reject\(\)：拒绝对话框，返回 QDialog.Rejected

4. QFrame - 带边框的窗口类#

1
from PySide6.QtWidgets import QFrame
2
from PySide6.QtCore import Qt
3

4
class MyWindow(QFrame):
5
    def __init__(self):
6
        super().__init__()
7
        self.setWindowTitle("带边框的窗口")
8
        self.resize(400, 300)
9

10
        # 设置边框样式
11
        self.setFrameShape(QFrame.Box)
12
        self.setFrameShadow(QFrame.Sunken)
13
        self.setLineWidth(2)

核心特点：

• QWidget 的子类，增加了边框功能

• 可以设置多种边框样式和阴影效果

• 可以作为其他控件的容器，提供视觉分隔

典型使用场景：

• 需要边框的子部件

• 分组框（替代 QGroupBox）

• 分隔线

• 自定义控件的背景

优点：提供丰富的边框和阴影效果 缺点：作为顶级窗口使用较少，主要作为子部件

5. 其他常用窗口基类#

1
from PySide6.QtWidgets import QMessageBox
2

3
# 通常直接使用，不需要继承
4
QMessageBox.information(self, "提示", "操作成功")
5
QMessageBox.warning(self, "警告", "确定要删除吗？")
6
QMessageBox.critical(self, "错误", "发生了一个错误")
7
QMessageBox.question(self, "询问", "你确定要退出吗？")

1
from PySide6.QtWidgets import QSplashScreen
2
from PySide6.QtGui import QPixmap
3

4
splash = QSplashScreen(QPixmap("splash.png"))
5
splash.show()
6
# 加载程序资源...
7
splash.finish(main_window)

1
from PySide6.QtWidgets import QDockWidget, QTextEdit
2

3
dock = QDockWidget("工具箱", self)
4
dock.setWidget(QTextEdit())
5
self.addDockWidget(Qt.LeftDockWidgetArea, dock)

1
from PySide6.QtWidgets import QMdiArea, QMdiSubWindow, QTextEdit
2

3
mdi_area = QMdiArea()
4
self.setCentralWidget(mdi_area)
5

6
sub_window = QMdiSubWindow()
7
sub_window.setWidget(QTextEdit())
8
mdi_area.addSubWindow(sub_window)
9
sub_window.show()