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

概述

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);

还可以混合使用普通按钮和标准按钮。
如果按钮框是水平布局，按钮的排列方式如下：

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

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

当按钮框中的按钮被点击时，将会发出被按下的实际按钮的clicked()信号。为了方便起见，如果按钮具有AcceptRole、RejectRole或HelpRole，将分别发出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 实例。

2. 常用函数：

   • 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：返回与指定按钮关联的标准按钮。

3. 枚举值：

   • QPushButton::ButtonRole：枚举类型，定义了按钮的角色：
     • QDialogButtonBox::AcceptRole`：表示接受按钮，通常用于用户接受当前对话框的操作。
     • QDialogButtonBox::RejectRole：表示拒绝按钮，通常用于用户取消或拒绝当前对话框的操作。
     • QDialogButtonBox::ApplyRole`：表示应用按钮，通常用于用户应用对话框中的修改。
     • QDialogButtonBox::ResetRole：表示重置按钮，通常用于将对话框的控件重置为默认值。
     • QDialogButtonBox::YesRole：表示是按钮，通常用于用户选择肯定或是的选项。
     • QDialogButtonBox::NoRole：表示否按钮，通常用于用户选择否定或不是的选项。
     • …

4. 信号和槽：

   • 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();
}

效果

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

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