概述

QDialogButtonBox类是一个小部件,它以适合当前小部件样式的布局呈现按钮。
对话框和消息框通常以符合该台界面指南的布局呈现按钮。不同的平台会有不同的对话框布局。QDialogButtonBox允许发人员向其添加按钮,并将自使用用户的桌面环境所适合的布局。
大多数对话框按钮都遵循特定角色。

  • 这些角色包括接受或拒绝对话框。
  • 寻求帮助。
  • 执行对话框本身的操作(例如重置字段或应用更改。)

还可以有其他解散对话框的方法,可能会导致破坏性的结果。
大多数对话框都有可以被认为是标准的按钮(例如确定和取消按钮)。有时候以标准的方式创建这些按钮是方便的。
使用QDialogButtonBox有几种方法。其中一种方法是自己创建按钮(或按钮文本),然后将它们添加到按钮框中,并指定它们的角色。

findButton = new QPushButton(tr("&Find"));
      findButton->setDefault(true);

      moreButton = new QPushButton(tr("&More"));
      moreButton->setCheckable(true);
      moreButton->setAutoDefault(false);

另一种方式是使用QDialogButtonBox提供的几个标准按钮(例如OK、Cancel、Save)。它们以标志(flags)的形式存在,因此您可以在构造函数中将它们进行逻辑或(OR)操作。

buttonBox = new QDialogButtonBox(QDialogButtonBox::Ok
                                       | QDialogButtonBox::Cancel);

      connect(buttonBox, &QDialogButtonBox::accepted, this, &QDialog::accept);
      connect(buttonBox, &QDialogButtonBox::rejected, this, &QDialog::reject);

还可以混合使用普通按钮和标准按钮。

如果按钮框是水平布局,按钮的排列方式如下:

【Qt控件之QDialogButtonBox】概述及使用_c++


如果按钮框是垂直布局,按钮的排列方式如下:

【Qt控件之QDialogButtonBox】概述及使用_#include_02


此外,仅包含具有ActionRoleHelpRole的按钮的按钮框可以被认为是非模态的,并且在macOS上具有备用的外观。

【Qt控件之QDialogButtonBox】概述及使用_#include_03


当按钮框中的按钮被点击时,将会发出被按下的实际按钮的clicked()信号。为了方便起见,如果按钮具有AcceptRoleRejectRoleHelpRole,将分别发出accepted()rejected()helpRequested()信号。

如果希望特定的按钮成为默认按钮,需要调用QPushButton::setDefault()方法进行设置。但是,如果没有设置默认按钮,并且希望在使用QPushButton::autoDefault属性时保持平台之间的默认按钮一致性,则在显示QDialogButtonBox时,会将具有AcceptRole的第一个按钮设置为默认按钮。

常用函数

QDialogButtonBox 是 Qt 框架提供的对话框按钮框控件,用于在对话框中显示按钮组,并提供常见的按钮操作。以下是关于 QDialogButtonBox 的构造函数、常用函数、枚举值、信号和槽的介绍:

  1. 构造函数:
  • QDialogButtonBox(QWidget *parent = nullptr):使用指定的父窗口创建一个默认的 QDialogButtonBox 实例。
  • QDialogButtonBox(Qt::Orientation orientation, QWidget *parent = nullptr):使用指定的方向和父窗口创建一个 QDialogButtonBox 实例。
  1. 常用函数:
  • void addButton(QAbstractButton *button, QDialogButtonBox::ButtonRole role):为按钮框添加一个按钮,并指定按钮的角色。
  • void removeButton(QAbstractButton *button):从按钮框中移除指定的按钮。
  • QList<QAbstractButton *> buttons() const:返回按钮框中的所有按钮。
  • QAbstractButton *button(QDialogButtonBox::ButtonRole role) const:返回指定角色的按钮。
  • QDialogButtonBox::StandardButton standardButton(QAbstractButton *button) const:返回与指定按钮关联的标准按钮。
  1. 枚举值:
  • QPushButton::ButtonRole:枚举类型,定义了按钮的角色:
  • QDialogButtonBox::AcceptRole`:表示接受按钮,通常用于用户接受当前对话框的操作。
  • QDialogButtonBox::RejectRole:表示拒绝按钮,通常用于用户取消或拒绝当前对话框的操作。
  • QDialogButtonBox::ApplyRole`:表示应用按钮,通常用于用户应用对话框中的修改。
  • QDialogButtonBox::ResetRole:表示重置按钮,通常用于将对话框的控件重置为默认值。
  • QDialogButtonBox::YesRole:表示是按钮,通常用于用户选择肯定或是的选项。
  • QDialogButtonBox::NoRole:表示否按钮,通常用于用户选择否定或不是的选项。
  1. 信号和槽:
  • void clicked(QAbstractButton *button):当按钮框中的按钮被点击时触发的信号,参数 button 表示被点击的按钮。
  • void accepted():当接受按钮被点击时触发的信号。
  • void rejected():当拒绝按钮被点击时触发的信号。

可以使用 clicked ()信号来连接 QDialogButtonBox 的按钮点击事件,并根据按钮的角色执行相应的操作。例如:

QObject::connect(buttonBox, &QDialogButtonBox::clicked, [&](QAbstractButton *button) {
    if (buttonBox->standardButton(button) == QDialogButtonBox::Ok) {
        // 点击了“确定”按钮
    } else if (buttonBox->standardButton(button) == QDialogButtonBox::Cancel) {
        // 点击了“取消”按钮
    }
});

通过连接 clicked() 信号,可以在按钮被点击时执行与按钮相关的操作。

QDialogButtonBox 提供了更多的功能和选项,以满足在对话框中管理按钮操作的需求。可以根据具体的应用场景使用适当的函数和属性进行定制和扩展。

示例

以下是使用 QDialogButtonBox 的示例代码:

#include <QApplication>
#include <QDialog>
#include <QDialogButtonBox>
#include <QLabel>
#include <QVBoxLayout>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QDialog dialog;
    dialog.setWindowTitle("QDialogButtonBox");
    QVBoxLayout *layout = new QVBoxLayout(&dialog);

    QLabel *label = new QLabel("Hello, QDialogButtonBox!");
    layout->addWidget(label);

    // 创建一个 QDialogButtonBox 并添加按钮
    QDialogButtonBox *buttonBox = new QDialogButtonBox(&dialog);
    buttonBox->setStandardButtons(QDialogButtonBox::Ok | QDialogButtonBox::Cancel);
    layout->addWidget(buttonBox);

    QObject::connect(buttonBox, &QDialogButtonBox::accepted, [&]() {
        // 接受按钮被点击
        label->setText("Clicked OK");
    });

    QObject::connect(buttonBox, &QDialogButtonBox::rejected, [&]() {
        // 拒绝按钮被点击
        label->setText("Clicked Cancel");
    });

    dialog.setLayout(layout);
    dialog.show();

    return app.exec();
}

效果

【Qt控件之QDialogButtonBox】概述及使用_c++_04


在示例中,创建了一个 QDialog 对话框,并在对话框中显示一个标签和一个 QDialogButtonBox。将 QDialogButtonBox 设置为拥有 “确定” 和 “取消” 两个标准按钮。然后,使用QObject::connect()函数连接了 QDialogButtonBoxaccepted() 信号和 rejected() 信号,分别在点击 “确定” 和 “取消” 按钮时更新标签的文本。

当运行这个示例程序时,会弹出一个对话框,其中包含一个标签和一个按钮框。当点击 “确定” 按钮时,标签会显示 "Clicked OK";当点击 “取消” 按钮时,标签会显示 "Clicked Cancel"