Класс QDialogButtonBox

Класс QDialogButtonBox — это виджет, который отображает кнопки в макете, соответствующем текущему стилю виджета. Подробнее...

• Список всех членов, включая наследуемые

Типы public

Свойства

• centerButtons : bool
• orientation : Qt::Orientation
• standardButtons : StandardButtons

Функции public

Сигналы

Переопределенные защищенные функции

Подробное описание

Диалоговые окна и информационные окна обычно представляют кнопки в макете, соответствующем руководству по интерфейсу для этой платформы. Неизменно, разные платформы имеют разные макеты для своих диалоговых окон. QDialogButtonBox позволяет разработчику добавлять кнопки в него и автоматически использовать соответствующий макет для среды рабочего стола пользователя.

Большинство кнопок для диалогового окна следуют определенным ролям. Такие роли включают:

• Принятие или отклонение диалогового окна.
• Запрос помощи.
• Выполнение действий в самом диалоговом окне (например, сброс полей или применение изменений).

Также могут быть альтернативные способы закрытия диалогового окна, которые могут привести к разрушительным результатам.

В большинстве диалоговых окон есть кнопки, которые можно считать стандартными (например, кнопки «ОК» и «Отмена»). Иногда удобно создавать эти кнопки стандартным способом.

Есть несколько способов использования QDialogButtonBox. Один способ — создать кнопки (или тексты кнопок) самостоятельно и добавить их в панель кнопок, указав их роль.

    findButton = new QPushButton(tr("&Find"));
    findButton->setDefault(true);

    moreButton = new QPushButton(tr("&More"));
    moreButton->setCheckable(true);
    moreButton->setAutoDefault(false);

В качестве альтернативы QDialogButtonBox предоставляет несколько стандартных кнопок (например, «ОК», «Отмена», «Сохранить»), которые вы можете использовать. Они существуют как флаги, поэтому вы можете объединять их с помощью операции OR в конструкторе.

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

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

Вы можете смешивать обычные кнопки и стандартные кнопки.

В настоящее время кнопки выложены следующим образом, если панель кнопок горизонтальная:

	Панель кнопок, выложенная в горизонтальном макете GnomeLayout
	Панель кнопок, выложенная в горизонтальном макете KdeLayout
	Панель кнопок, выложенная в горизонтальном макете MacLayout
	Панель кнопок, выложенная в горизонтальном макете WinLayout

Кнопки выложены следующим образом, если панель кнопок вертикальная:

GnomeLayout	KdeLayout	MacLayout	WinLayout

Кроме того, панели кнопок, содержащие только кнопки с ActionRole или HelpRole, могут считаться бессодержательными и иметь альтернативный вид на macOS:

бессодержательная горизонтальная MacLayout
бессодержательная вертикальная MacLayout

При нажатии кнопки в группе кнопок диалогового окна, генерируется сигнал clicked() для нажатой кнопки. Для удобства, если кнопка имеет роль AcceptRole, RejectRole или HelpRole, соответственно, генерируются сигналы accepted(), rejected() или helpRequested().

Если требуется, чтобы определённая кнопка была кнопкой по умолчанию, необходимо вызвать метод QPushButton::setDefault() для неё. Однако, если кнопка по умолчанию не задана и для сохранения кнопки по умолчанию на разных платформах при использовании свойства QPushButton::autoDefault, первая кнопка с ролью accept становится кнопкой по умолчанию при отображении QDialogButtonBox.

См. также QMessageBox, QPushButton и QDialog.

Документация типов членов

перечисление QDialogButtonBox::ButtonLayout

Это перечисление описывает политику выравнивания кнопок, используемую при размещении кнопок в группе кнопок.

Макет кнопок задаётся текущим стилем. Однако на платформе X11 он может быть под влиянием среды рабочего стола.

перечисление QDialogButtonBox::ButtonRole

Этот перечисление описывает роли, которые могут быть использованы для описания кнопок в кнопочной панели. Комбинации этих ролей используются как флаги для описания различных аспектов их поведения.

См. такжеStandardButton.

enum QDialogButtonBox::StandardButtonflags QDialogButtonBox::StandardButtons

Эти перечисления описывают флаги для стандартных кнопок. Каждая кнопка имеет определенную ButtonRole.

Тип StandardButtons является типом-синонимом для QFlags<StandardButton>. Он хранит комбинацию значений StandardButton, объединенных операцией ИЛИ.

См. такжеButtonRole и standardButtons.

Документация функций-членов

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

Создаёт группу кнопок с заданной orientation и parent, содержащую стандартные кнопки, заданные buttons.

См. также orientation и addButton().

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

Создаёт горизонтальную группу кнопок с заданным parent, содержащую стандартные кнопки, заданные buttons.

Эта функция была введена в Qt 5.2.

См. также orientation и addButton().

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

Создаёт пустую группу кнопок с заданной orientation и parent.

См. также orientation и addButton().

QDialogButtonBox::QDialogButtonBox(QWidget *parent = nullptr)

Создаёт пустую горизонтальную группу кнопок с заданным parent.

См. также orientation и addButton().

[signal] void QDialogButtonBox::accepted()

Этот сигнал испускается, когда нажимается кнопка внутри группы кнопок, если она была определена с помощью AcceptRole или YesRole.

См. также rejected(), clicked() и helpRequested().

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

Этот сигнал испускается, когда нажимается кнопка внутри группы кнопок. Конкретная нажатая кнопка указана параметром button.

См. также accepted(), rejected() и helpRequested().

[signal] void QDialogButtonBox::helpRequested()

Этот сигнал испускается, когда нажимается кнопка внутри группы кнопок, если она была определена с помощью HelpRole.

См. также accepted(), rejected() и clicked().

[signal] void QDialogButtonBox::rejected()

Этот сигнал испускается, когда нажимается кнопка внутри группы кнопок, если она была определена с помощью RejectRole или NoRole.

См. также accepted(), helpRequested() и clicked().

[virtual] QDialogButtonBox::~QDialogButtonBox()

Уничтожает группу кнопок.

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::addButton(QDialogButtonBox::StandardButton button)

Добавляет стандартную button в группу кнопок, если это возможно, и возвращает соответствующую кнопку. Если button недопустима, она не добавляется, и возвращается ноль.

См. также removeButton() и clear().

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

Возвращает кнопку QPushButton, соответствующую стандартной кнопке which, или nullptr если стандартная кнопка не существует в этой группе кнопок.

См. также standardButton(), standardButtons() и buttons().

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

Возвращает роль кнопки для указанной button. Эта функция возвращает InvalidRole, если button nullptr или не была добавлена в группу кнопок.

См. также 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().

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

Переопределяет: QWidget::event(QEvent *event).

void QDialogButtonBox::removeButton(QAbstractButton *button)

Удаляет button из группы кнопок без удаления его самого и устанавливает его родителя в нуль.

См. также clear(), buttons(), и addButton().

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

Возвращает значение перечисления стандартной кнопки, соответствующей данной кнопке button, или NoButton, если данная кнопка button не является стандартной.

См. также button(), buttons(), и standardButtons().