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 が無効な場合は、ボタンボックスには追加されず、0が返されます。

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 が無効な場合、ボタンは作成されず、0が返されます。

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 を削除せずにボタンボックスから取り除き、その親を null に設定します。

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も参照してください 。