Класс QDialogButtonBox

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

Этот класс был представлен в Qt 4.2.

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

Общедоступные типы

Свойства

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

Общедоступные функции

Сигналы

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

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

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

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

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

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

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

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

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

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

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

    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().

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().