Класс QDialogButtonBox

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

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

Открытые типы

Свойства

• 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 предоставляет несколько стандартных кнопок (например, «ОК», «Отмена», «Сохранить»), которые вы можете использовать. Они существуют как флаги, поэтому вы можете объединять их при помощи оператора 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)

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

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

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

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

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

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

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

Создаёт пустую группу кнопок с заданной ориентацией и родительским объектом.

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

QDialogButtonBox::QDialogButtonBox(QWidget *parent = nullptr)

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

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

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

Если кнопка уже добавлена, она удаляется и добавляется снова с новой ролью.

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

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

Создаёт кнопку с заданным текстом, добавляет её в группу кнопок для указанной роли и возвращает соответствующую кнопку. Если role недействительна, кнопка не создаётся, и возвращается ноль.

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

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

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

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

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

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

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

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

Возвращает роль кнопки для указанной кнопки. Эта функция возвращает 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().