PyQt-Fluent-Widgets 项目实战：自定义消息对话框开发指南

引言

在现代桌面应用开发中，对话框是与用户交互的重要组件。PyQt-Fluent-Widgets 项目提供了一套基于 PyQt5 的 Fluent Design 风格组件，其中 MessageBoxBase 类为开发者提供了创建自定义消息对话框的基础。本文将深入解析如何利用该项目创建功能完善的自定义消息对话框。

核心组件解析

MessageBoxBase 基类

MessageBoxBase 是 PyQt-Fluent-Widgets 中对话框组件的基类，它已经实现了对话框的基本框架，包括：

1. 标题栏区域
2. 内容视图区域
3. 按钮操作区域
4. 默认的动画效果

开发者只需继承 MessageBoxBase 并添加自定义内容即可快速创建专业风格的对话框。

自定义对话框实现

在示例代码中，CustomMessageBox 类继承自 MessageBoxBase，实现了一个 URL 输入对话框：

class CustomMessageBox(MessageBoxBase):
    """ Custom message box """
    def __init__(self, parent=None):
        super().__init__(parent)
        # 初始化UI组件
        self.titleLabel = SubtitleLabel('打开 URL', self)
        self.urlLineEdit = LineEdit(self)
        self.warningLabel = CaptionLabel("The url is invalid")
        
        # 设置组件属性
        self.urlLineEdit.setPlaceholderText('输入文件、流或者播放列表的 URL')
        self.urlLineEdit.setClearButtonEnabled(True)
        self.warningLabel.setTextColor("#cf1010", QColor(255, 28, 32))
        
        # 添加组件到布局
        self.viewLayout.addWidget(self.titleLabel)
        self.viewLayout.addWidget(self.urlLineEdit)
        self.viewLayout.addWidget(self.warningLabel)
        
        # 设置按钮文本
        self.yesButton.setText('打开')
        self.cancelButton.setText('取消')
        
        # 设置对话框最小宽度
        self.widget.setMinimumWidth(350)

关键功能实现

输入验证机制

对话框实现了 URL 格式验证功能，确保用户输入的是有效的 HTTP URL：

def validate(self):
    """ Rewrite the virtual method """
    isValid = self.urlLineEdit.text().lower().startswith("http://")
    self.warningLabel.setHidden(isValid)
    self.urlLineEdit.setError(not isValid)
    return isValid

验证逻辑说明：

1. 检查输入是否以 "http://" 开头
2. 根据验证结果显示/隐藏错误提示
3. 设置输入框的错误状态
4. 返回验证结果

对话框调用方式

在主窗口中，通过按钮点击触发对话框显示：

def showDialog(self):
    w = CustomMessageBox(self)
    if w.exec():
        print(w.urlLineEdit.text())

exec() 方法会以模态方式显示对话框，并返回用户的操作结果（确认或取消）。

高级技巧

主题切换支持

PyQt-Fluent-Widgets 支持亮色和暗色主题切换，只需取消注释相关代码即可：

# setTheme(Theme.DARK)
# self.setStyleSheet('Demo{background:rgb(32,32,32)}')

高DPI屏幕适配

示例中包含了高DPI屏幕的适配代码，确保在不同分辨率的屏幕上都能正常显示：

QApplication.setHighDpiScaleFactorRoundingPolicy(Qt.HighDpiScaleFactorRoundingPolicy.PassThrough)
QApplication.setAttribute(Qt.AA_EnableHighDpiScaling)
QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps)

实际应用建议

1. 扩展验证逻辑：可以根据实际需求增强验证逻辑，如检查URL格式、域名有效性等
2. 自定义样式：通过QSS为对话框添加更多个性化样式
3. 动画效果：利用 MessageBoxBase 提供的动画接口添加入场/出场动画
4. 国际化：将硬编码的文本替换为可翻译的字符串，支持多语言

总结

通过 PyQt-Fluent-Widgets 的 MessageBoxBase 类，开发者可以快速创建符合 Fluent Design 风格的自定义对话框。本文展示的URL输入对话框示例演示了如何：

1. 继承 MessageBoxBase 创建自定义对话框
2. 添加输入控件和验证逻辑
3. 自定义按钮和行为
4. 处理对话框返回值

这种模式可以扩展到各种类型的对话框开发中，如文件选择、设置配置、确认提示等场景。