笔记 | QDialogButtonBox的使用

QDialogButtonBox的基本用法

QDialogButtonBox是Qt的QtWidgets模块中的一个小部件，您可以使用它轻松地添加标准按钮到对话框中。以下是一个基本的使用示例：

#include <QDialog>
#include <QDialogButtonBox>

// 创建一个对话框
QDialog* dialog = new QDialog(this);

// 创建一个QDialogButtonBox
QDialogButtonBox* buttonBox = new QDialogButtonBox(QDialogButtonBox::Ok | QDialogButtonBox::Cancel, Qt::Horizontal, dialog);

// 连接按钮的信号槽
connect(buttonBox, &QDialogButtonBox::accepted, dialog, &QDialog::accept);
connect(buttonBox, &QDialogButtonBox::rejected, dialog, &QDialog::reject);

// 将QDialogButtonBox添加到对话框中
QVBoxLayout* layout = new QVBoxLayout;
layout->addWidget(buttonBox);
dialog->setLayout(layout);

// 显示对话框
int result = dialog->exec();

// 处理对话框的结果
if (result == QDialog::Accepted) {
    // 用户点击了"确定"按钮
} else {
    // 用户点击了"取消"按钮或关闭了对话框
}

在上面的示例中，我们首先创建了一个对话框（QDialog）和一个QDialogButtonBox，并将标准的“确定”和“取消”按钮添加到QDialogButtonBox中。接着，我们将按钮的信号与对话框的accept和reject槽函数连接起来，以处理按钮点击事件。最后，我们将QDialogButtonBox添加到对话框的布局中，并显示对话框。用户点击按钮后，我们可以根据返回值来确定用户的选择。

自定义按钮

除了标准的“确定”和“取消”按钮，您还可以自定义QDialogButtonBox中的按钮。以下是一个示例，演示如何添加一个自定义按钮到对话框中：

QDialogButtonBox* buttonBox = new QDialogButtonBox(Qt::Horizontal, dialog);

QPushButton* customButton = new QPushButton("Custom Button");
buttonBox->addButton(customButton, QDialogButtonBox::ActionRole);

connect(customButton, &QPushButton::clicked, this, &MyClass::customButtonClicked);

在上面的示例中，我们首先创建了一个空的QDialogButtonBox，然后创建了一个自定义按钮（customButton），并将其添加到QDialogButtonBox中。我们还使用了QDialogButtonBox::ActionRole来指定这是一个自定义操作按钮。最后，我们连接了自定义按钮的clicked信号到一个槽函数（customButtonClicked），以便在用户点击按钮时执行自定义操作。

设置按钮布局

QDialogButtonBox允许您在水平或垂直方向上排列按钮。在上述示例中，我们使用了Qt::Horizontal来水平排列按钮。如果您想垂直排列按钮，只需将构造函数中的第二个参数更改为Qt::Vertical即可。

QDialogButtonBox中的clicked(QAbstractButton*)槽是一个特殊的槽函数，用于捕获与对话框按钮的交互。当用户单击对话框中的任何按钮时，不论是标准按钮还是自定义按钮，都会发射这个槽。该槽接受一个QAbstractButton*参数，该参数表示用户单击的按钮对象。

以下是一个示例，演示如何使用clicked(QAbstractButton*)槽：

connect(buttonBox, &QDialogButtonBox::clicked, this, &MyClass::handleButtonClick);

// ...

void MyClass::handleButtonClick(QAbstractButton* button) {
    if ((QPushButton *)button == buttonBox->button(QDialogButtonBox::Save)) {
        // 用户单击了"保存"按钮
        // 执行保存操作
    } else if ((QPushButton *)button == buttonBox->button(QDialogButtonBox::Cancel)) {
        // 用户单击了"取消"按钮
        // 执行取消操作
    } else {
        // 处理其他按钮的点击事件
    }
}

在上面的示例中，我们首先连接了QDialogButtonBox的clicked(QAbstractButton*)信号到handleButtonClick槽。然后，在handleButtonClick槽中检查button参数以确定用户单击的是哪个按钮。通过比较button与QDialogButtonBox中的按钮，我们可以根据不同的按钮执行不同的操作。