快捷導(dǎo)航

PySide6 QMessageBox的具體使用

更新時間：2025年07月18日 09:20:42 作者：誠信愛國敬業(yè)友善

QMessageBox是PySide6中用于顯示模態(tài)對話框的組件,常用于提示信息、警告、錯誤或獲取用戶確認(rèn),具有一定的參考價值,感興趣的可以了解一下

1. 基礎(chǔ)用法

快速顯示靜態(tài)方法

PySide6 提供了靜態(tài)方法直接顯示預(yù)設(shè)對話框：

from PySide6.QtWidgets import QMessageBox

# 信息提示框
QMessageBox.information(None, "標(biāo)題", "這是一條信息提示。")

# 警告框
QMessageBox.warning(None, "警告", "操作可能導(dǎo)致數(shù)據(jù)丟失！")

# 錯誤框
QMessageBox.critical(None, "錯誤", "無法打開文件！")

# 提問框（返回用戶點擊的按鈕類型）
result = QMessageBox.question(None, "確認(rèn)", "確定要刪除嗎？")
if result == QMessageBox.StandardButton.Yes:
    print("用戶確認(rèn)刪除")

2. 構(gòu)造函數(shù)參數(shù)詳解

通過實例化 QMessageBox 可自定義更多細(xì)節(jié)：

msg_box = QMessageBox(
    QMessageBox.Icon.Warning,        # 圖標(biāo)類型
    "警告標(biāo)題",                       # 窗口標(biāo)題
    "這是詳細(xì)警告內(nèi)容",                # 主文本
    QMessageBox.StandardButton.Ok |  # 按鈕組合
    QMessageBox.StandardButton.Cancel
)

參數(shù)說明

參數(shù)	類型	說明
icon	QMessageBox.Icon	對話框圖標(biāo)，可選值： NoIcon, Information, Warning, Critical, Question
title	str	窗口標(biāo)題
text	str	主顯示文本
buttons	QMessageBox.StandardButton	按鈕組合（通過 `
parent	QWidget	父窗口（若為 None 則居中屏幕顯示）

3. 自定義屬性和方法

添加詳細(xì)文本

msg_box.setDetailedText("錯誤詳情：文件路徑不存在。")

設(shè)置默認(rèn)按鈕

msg_box.setDefaultButton(QMessageBox.StandardButton.Cancel)

修改圖標(biāo)

msg_box.setIcon(QMessageBox.Icon.Critical)

自定義按鈕文本

custom_button = msg_box.addButton("自定義按鈕", QMessageBox.ButtonRole.ActionRole)

4. 按鈕角色與響應(yīng)處理

標(biāo)準(zhǔn)按鈕類型

from PySide6.QtWidgets import QMessageBox

# 按鈕組合示例
buttons = (
    QMessageBox.StandardButton.Yes |
    QMessageBox.StandardButton.No |
    QMessageBox.StandardButton.Help
)

msg_box.setStandardButtons(buttons)

捕獲用戶點擊

result = msg_box.exec()  # 顯示對話框并等待用戶操作

if result == QMessageBox.StandardButton.Yes:
    print("用戶點擊了 Yes")
elif result == QMessageBox.StandardButton.Help:
    print("用戶請求幫助")

5. 完整示例代碼

from PySide6.QtWidgets import QApplication, QMessageBox, QPushButton, QWidget
from PySide6.QtCore import Qt

class DemoWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setup_ui()

    def setup_ui(self):
        self.setWindowTitle("QMessageBox 示例")
        self.resize(300, 200)

        button = QPushButton("顯示對話框", self)
        button.clicked.connect(self.show_custom_dialog)
        button.move(100, 80)

    def show_custom_dialog(self):
        msg_box = QMessageBox(self)
        msg_box.setIcon(QMessageBox.Icon.Question)
        msg_box.setWindowTitle("確認(rèn)操作")
        msg_box.setText("確定要提交數(shù)據(jù)嗎？")
        msg_box.setInformativeText("提交后無法撤銷！")
        msg_box.setDetailedText("數(shù)據(jù)詳情：\n- 用戶信息\n- 訂單記錄")

        # 添加自定義按鈕
        save_button = msg_box.addButton("保存草稿", QMessageBox.ButtonRole.ActionRole)
        save_button.clicked.connect(self.save_draft)

        # 標(biāo)準(zhǔn)按鈕
        msg_box.setStandardButtons(
            QMessageBox.StandardButton.Yes |
            QMessageBox.StandardButton.No |
            QMessageBox.StandardButton.Cancel
        )

        # 設(shè)置默認(rèn)按鈕
        msg_box.setDefaultButton(QMessageBox.StandardButton.No)

        # 顯示對話框并處理結(jié)果
        result = msg_box.exec()
        if result == QMessageBox.StandardButton.Yes:
            print("數(shù)據(jù)已提交")
        elif result == QMessageBox.StandardButton.Cancel:
            print("操作已取消")

    def save_draft(self):
        print("草稿已保存")

if __name__ == "__main__":
    app = QApplication([])
    window = DemoWindow()
    window.show()
    app.exec()

6. 樣式自定義（QSS）

通過樣式表修改對話框外觀：

msg_box.setStyleSheet("""
    QMessageBox {
        background-color: #f0f0f0;
        font-size: 14px;
    }
    QMessageBox QLabel#qt_msgbox_label {
        color: #333;
    }
    QMessageBox QPushButton {
        min-width: 80px;
        padding: 5px;
    }
""")

7. 核心枚舉值

QMessageBox.Icon

值	說明
NoIcon	無圖標(biāo)
Information	信息圖標(biāo)（?）
Warning	警告圖標(biāo)（?）
Critical	錯誤圖標(biāo)（?）
Question	問題圖標(biāo)（?）