QDialogButtonBox Class

QDialogButtonBox *buttonBox = new QDialogButtonBox(Qt::Vertical);
buttonBox->addButton(findButton, QDialogButtonBox::ActionRole);
buttonBox->addButton(moreButton, QDialogButtonBox::ActionRole);

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

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

成员函数文档

QDialogButtonBox::QDialogButtonBox(QWidget *parent = nullptr)

根据给定的parent ，构建一个空的、水平排列的按钮框。

另请参阅 orientation 和addButton()。

[explicit] QDialogButtonBox::QDialogButtonBox(QDialogButtonBox::StandardButtons buttons, QWidget *parent = nullptr)

根据给定的parent 构建一个水平按钮框，其中包含由buttons 指定的标准按钮。

另请参阅 orientation 和addButton()。

QDialogButtonBox::QDialogButtonBox(Qt::Orientation orientation, QWidget *parent = nullptr)

根据给定的orientation 和parent 构建一个空的按钮框。

另请参阅 orientation 和addButton()。

QDialogButtonBox::QDialogButtonBox(QDialogButtonBox::StandardButtons buttons, Qt::Orientation orientation, QWidget *parent = nullptr)

根据给定的orientation 和parent 构建一个按钮框，其中包含由buttons 指定的标准按钮。

另请参阅 orientation 和addButton()。

[virtual noexcept] QDialogButtonBox::~QDialogButtonBox()

摧毁按钮盒。

[signal] void QDialogButtonBox::accepted()

当按钮框内的某个按钮被点击时，如果该按钮是通过 `AcceptRole ` 或 `YesRole` 定义的，则会触发此信号。

另请参阅 rejected()、clicked() 和helpRequested()。

QPushButton *QDialogButtonBox::addButton(QDialogButtonBox::StandardButton button)

如果操作有效，则将标准button 添加到按钮框中，并返回一个按钮。如果button 无效，则不会将其添加到按钮框中，并返回零。

另请参阅 removeButton() 和clear()。

void QDialogButtonBox::addButton(QAbstractButton *button, QDialogButtonBox::ButtonRole role)

将给定的button 添加到具有指定role 的按钮框中。如果角色无效，则不会添加该按钮。

如果该按钮已被添加，则将其移除，并使用新角色重新添加。

另请参阅 removeButton() 和clear()。

QPushButton *QDialogButtonBox::addButton(const QString &text, QDialogButtonBox::ButtonRole role)

创建一个带有给定text 的按钮，将其添加到指定role 的按钮框中，并返回相应的按钮。如果role 无效，则不创建按钮，并返回零。

另请参阅 removeButton() 和clear()。

QPushButton *QDialogButtonBox::button(QDialogButtonBox::StandardButton which) const

返回与标准按钮which 对应的QPushButton ，如果该标准按钮在此按钮框中不存在，则返回nullptr 。

另请参阅 standardButton()、standardButtons() 和buttons()。

QDialogButtonBox::ButtonRole QDialogButtonBox::buttonRole(QAbstractButton *button) const

返回指定button 的按钮角色。如果button 的nullptr 为真，或者该对象尚未被添加到按钮框中，则该函数返回InvalidRole 。

另请参阅 buttons() 和addButton()。

QList<QAbstractButton *> QDialogButtonBox::buttons() const

返回已添加到按钮框中的所有按钮的列表。

另请参阅 buttonRole()、addButton() 和removeButton()。

[override virtual protected] void QDialogButtonBox::changeEvent(QEvent *event)

重写了：QWidget::changeEvent(QEvent *event)。

void QDialogButtonBox::clear()

清空按钮框，删除其中的所有按钮。

另请参阅 removeButton() 和addButton()。

[signal] void QDialogButtonBox::clicked(QAbstractButton *button)

当按钮框内的某个按钮被点击时，会触发此信号。被点击的具体按钮由 `button` 指定。

另请参阅 accepted()、rejected() 和helpRequested()。

[override virtual protected] bool QDialogButtonBox::event(QEvent *event)

重写了：QWidget::event(QEvent *event)。

[signal] void QDialogButtonBox::helpRequested()

当按钮框内的某个按钮被点击时，只要该按钮是在HelpRole 中定义的，就会触发此信号。

另请参阅 accepted()、rejected() 和clicked()。

[signal] void QDialogButtonBox::rejected()

当按钮框内的某个按钮被点击时，如果该按钮是通过 `RejectRole ` 或 `NoRole` 定义的，就会触发此信号。

另请参阅 accepted()、helpRequested() 和clicked()。

void QDialogButtonBox::removeButton(QAbstractButton *button)

将button 从按钮框中移出（但不删除该元素），并将它的父元素设置为零。

另请参阅 clear()、buttons() 和addButton()。

QDialogButtonBox::StandardButton QDialogButtonBox::standardButton(QAbstractButton *button) const

返回与给定的button 相对应的标准按钮枚举值；如果给定的button 不是标准按钮，则返回NoButton 。

另请参阅 button()、buttons()，以及standardButtons()。

[static, since 6.12] QKeySequence QDialogButtonBox::standardButtonShortcut(QDialogButtonBox::StandardButton button)

返回标准button 的键盘快捷键。该快捷键因平台而异。如果button 没有关联的快捷键，或者不是被识别的标准按钮，则返回空的QKeySequence 。

该函数在 Qt 6.12 中引入。

另请参阅 ` standardButtonText()` 和 `StandardButton`。

[static, since 6.12] QString QDialogButtonBox::standardButtonText(QDialogButtonBox::StandardButton button)

返回标准button 的显示文本，即按钮标签上显示的内容。该文本取决于平台和区域设置。

如果button 不是被识别的标准按钮，则返回空字符串。

该函数于 Qt 6.12 中引入。

另请参阅 standardButtonShortcut() 和StandardButton 。