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

Dokumentation der Member-Funktionen

QDialogButtonBox::QDialogButtonBox(QWidget *parent = nullptr)

Erstellt eine leere, horizontale Schaltflächenbox mit dem angegebenen „ parent “.

Siehe auch ` orientation ` und ` addButton()`.

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

Erstellt eine horizontale Schaltflächenbox mit dem angegebenen „ parent “, die die durch „ buttons “ festgelegten Standardschaltflächen enthält.

Siehe auch orientation und addButton().

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

Erstellt eine leere Schaltflächenbox mit den angegebenen Werten für „ orientation “ und „ parent “.

Siehe auch orientation und addButton().

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

Erstellt eine Schaltflächenbox mit den angegebenen Werten für „ orientation “ und „ parent “, die die durch „ buttons “ festgelegten Standardschaltflächen enthält.

Siehe auch orientation und addButton().

[virtual noexcept] QDialogButtonBox::~QDialogButtonBox()

Zerstört die Schaltflächenleiste.

[signal] void QDialogButtonBox::accepted()

Dieses Signal wird ausgelöst, wenn eine Schaltfläche innerhalb der Schaltflächenbox angeklickt wird, sofern diese mit den Attributen „ AcceptRole “ oder „ YesRole “ definiert wurde.

Siehe auch rejected(), clicked() und helpRequested().

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

Fügt der Schaltflächenbox ein Standard- button hinzu, sofern dies zulässig ist, und gibt eine Schaltfläche zurück. Ist button ungültig, wird es nicht zur Schaltflächenbox hinzugefügt, und es wird Null zurückgegeben.

Siehe auch „ removeButton()“ und „ clear()“.

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

Fügt die angegebene Rolle „ button “ zur Schaltflächenbox mit der angegebenen Rolle „ role “ hinzu. Ist die Rolle ungültig, wird die Schaltfläche nicht hinzugefügt.

Wenn die Schaltfläche bereits hinzugefügt wurde, wird sie entfernt und mit der neuen Rolle erneut hinzugefügt.

Siehe auch „ removeButton()“ und „ clear()“.

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

Erstellt eine Schaltfläche mit dem angegebenen text, fügt sie der Schaltflächenbox für das angegebene role hinzu und gibt die entsprechende Schaltfläche zurück. Ist role ungültig, wird keine Schaltfläche erstellt und Null zurückgegeben.

Siehe auch removeButton() und clear().

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

Gibt den „ QPushButton “ zurück, der der Standardschaltfläche „ which “ entspricht, oder „ nullptr “, falls die Standardschaltfläche in dieser Schaltflächenleiste nicht vorhanden ist.

Siehe auch standardButton(), standardButtons() und buttons().

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

Gibt die Schaltflächenrolle für das angegebene „ button “ zurück. Diese Funktion gibt „ InvalidRole “ zurück, wenn „ button “ den Wert „ nullptr “ hat oder nicht zur Schaltflächenbox hinzugefügt wurde.

Siehe auch „ buttons()“ und „ addButton()“.

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

Gibt eine Liste aller Schaltflächen zurück, die der Schaltflächenbox hinzugefügt wurden.

Siehe auch buttonRole(), addButton() und removeButton().

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

Umsetzt: ` QWidget::changeEvent(QEvent *event)`.

void QDialogButtonBox::clear()

Löscht das Schaltflächenfeld und entfernt alle darin enthaltenen Schaltflächen.

Siehe auch removeButton() und addButton().

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

Dieses Signal wird ausgelöst, wenn eine Schaltfläche innerhalb der Schaltflächenbox angeklickt wird. Welche Schaltfläche genau gedrückt wurde, wird durch „ button “ angegeben.

Siehe auch accepted(), rejected() und helpRequested().

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

Umsetzt: QWidget::event(QEvent *event).

[signal] void QDialogButtonBox::helpRequested()

Dieses Signal wird ausgelöst, wenn eine Schaltfläche innerhalb der Schaltflächenbox angeklickt wird, sofern diese mit der Funktion „ HelpRole “ definiert wurde.

Siehe auch „ accepted()“, „ rejected()“ und „ clicked()“.

[signal] void QDialogButtonBox::rejected()

Dieses Signal wird ausgelöst, wenn eine Schaltfläche innerhalb der Schaltflächenbox angeklickt wird, sofern diese mit dem Attribut „ RejectRole “ oder „ NoRole “ definiert wurde.

Siehe auch accepted(), helpRequested() und clicked().

void QDialogButtonBox::removeButton(QAbstractButton *button)

Entfernt „ button “ aus der Schaltflächenbox, ohne es zu löschen, und setzt dessen übergeordnetes Element auf Null.

Siehe auch „ clear()“, „ buttons()“ und „ addButton()“.

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

Gibt den Standard-Enum-Wert für die Schaltfläche zurück, der dem angegebenen button entspricht, oder NoButton, falls die angegebene button keine Standardschaltfläche ist.

Siehe auch button(), buttons() und standardButtons().

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

Gibt die Tastenkombination für die Standard- button zurück. Die Tastenkombination ist plattformabhängig. Gibt ein leeres QKeySequence zurück, wenn button keine zugehörige Tastenkombination hat oder keine erkannte Standardschaltfläche ist.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch „ standardButtonText()“ und „ StandardButton “.

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

Gibt den Anzeigetext für die Standardschaltfläche „ button “ zurück, wie er auf der Schaltflächenbeschriftung angezeigt wird. Der Text ist plattform- und sprachumgebungsabhängig.

Gibt eine leere Zeichenkette zurück, wenn „ button “ kein erkannter Standard-Button ist.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch „ standardButtonShortcut()“ und „ StandardButton “.