当前位置：首页 > news >正文

QML学习笔记（四十二）QML的MessageDialog

news 2025/10/18 10:21:49

前言

MessageDialog是QML中的一个消息弹窗组件，它可以提供简单的消息提示，也可以实现简单的yes or no的选择。它在Qt6中会有几种模式，需要根据不同的场景灵活选择。它也和QWidget中的QMessageBox是同一个层级的产物。

一、代码例子

import QtQuick 2.14
import QtQuick.Window 2.14
import QtQuick.Controls 2.14
import QtQuick.Dialogs 1.3Window {visible: truewidth: 640height: 480title: qsTr("QmlMessageDialog")Row {anchors.centerIn: parentspacing: 10Button {text: "询问"onClicked: askDlg.open()}Button {text: "警告"onClicked: warnDlg.open()}}MessageDialog {id: askDlgtitle: "提示"text: "确定要执行操作吗？"informativeText: "此操作不可撤销"icon: MessageDialog.QuestionstandardButtons: MessageDialog.Yes | MessageDialog.NoonYes: console.log("用户点了 Yes")onNo:  console.log("用户点了 No")}MessageDialog {id: warnDlgtitle: "提示"text: "确定要执行操作吗？"informativeText: "此操作不可撤销"icon: MessageDialog.QuestionstandardButtons: MessageDialog.YesonYes: console.log("用户点了 Yes")}
}

在这里插入图片描述

如果是Qt6高版本，可以用qusetion或warning这种接口直接打开，但是我当前版本只能默认用open弹窗。
我希望实现类似QMessageBox的功能，查找帮助文档会有这种默认图标的选择：

还可以自由组合自己想要的按钮，实现对应的信号槽：
在这里插入图片描述
可以看到不同的按钮会对应到不同的role，比如Ok和Save对应的都是AcceptRole，对应的处理器是onAccepted。如果你足够敏锐，就应该避免两种按钮的混用，因为它们对应的都是同一个处理器。它们可没有单独的onSave、onOk这种处理器。
它的信号也就只有这么多：
在这里插入图片描述
值得一提的是，这些按钮的文本无法自定义，可以加载官方qm翻译文件来实现。实在不行只能放弃这种弹窗，然后自行实现。

二、对比QMessageBox

QMessageBox是QWidget中的消息弹窗，也常被称为消息盒子。
它的使用也很简单，常常在c++代码中这样写：

/* 一行弹窗，一行判断 */
int ret = QMessageBox::question(nullptr,           // 父窗口"提示",            // 标题"确定要退出吗？",   // 正文QMessageBox::Yes | QMessageBox::No,QMessageBox::No);  // 默认按钮
if (ret == QMessageBox::Yes)qDebug() << "用户点了 Yes";
elseqDebug() << "用户点了 No";

我们可以已制定标题、正文，也同样可以指定需要的按钮。
这种方法是快速弹窗，你可以自行new一个对象出来，然后exec模态弹出。
这里给一个kimi提供的对比总结：

维度	QML MessageDialog	QWidget QMessageBox
模块	QtQuick.Dialogs 1.x / labs-platform	QtWidgets
外观	系统原生（Win/macOS/Linux Shell）	Qt 自绘（随 QStyle）
按钮文字	随系统语言（改不了）	走 qt_xx.qm 可翻译
图标	系统图标	Qt 内置图标
富文本	基本 HTML 子集	完整 HTML
自定义按钮	只能用标准枚举	可任意 `addButton(text, role)`
信号/槽	`accepted()` / `rejected()` / `clicked(button)`	`buttonClicked(QAbstractButton*)`
使用方式	一行 `open()`	`exec()` 或 `static` 函数
最小依赖	QML 场景	QWidget 场景
典型代码	见下	见下