Класс QDialogButtonBox

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

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

Типы

Свойства

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

• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

Открытые функции

• 214 открытых функций унаследовано от QWidget
• 32 открытых функции унаследовано от QObject
• 14 открытых функций унаследовано от QPaintDevice

Сигналы

• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject

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

• 35 защищенных функций унаследовано от QWidget
• 9 защищенных функций унаследовано от QObject
• 1 защищенная функция унаследовано от QPaintDevice

Дополнительные унаследованные члены

• 19 открытых слотов унаследовано от QWidget
• 1 открытый слот унаследовано от QObject
• 5 статических открытых членов унаследовано от QWidget
• 11 статических открытых членов унаследовано от QObject
• 35 защищенных функций унаследовано от QWidget
• 9 защищенных функций унаследовано от QObject
• 1 защищенная функция унаследовано от QPaintDevice
• 1 защищенный слот унаследовано от QWidget

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

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

Диалоговые окна и информационные окна обычно отображают кнопки в макете, соответствующем рекомендациям по интерфейсу для данной платформы. Разные платформы неизменно имеют разные макеты для своих диалоговых окон. 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, первая кнопка типа push с ролью accept становится кнопкой по умолчанию при отображении QDialogButtonBox.

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

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

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

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

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

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

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

См. также StandardButton.

перечисление QDialogButtonBox::StandardButtonфлаги QDialogButtonBox::StandardButtons

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

Тип StandardButtons является псевдонимом для QFlags<StandardButton>. Он хранит логическое ИЛИ сочетание значений StandardButton.

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

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

QDialogButtonBox::QDialogButtonBox(QWidget *parent = Q_NULLPTR)

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

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

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

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

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

QDialogButtonBox::QDialogButtonBox(StandardButtons buttons, QWidget *parent = Q_NULLPTR)

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

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

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

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

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

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

QDialogButtonBox::~QDialogButtonBox()

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

[signal] void QDialogButtonBox::accepted()

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

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

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

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

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

Примечание: Группа кнопок берёт на себя владение кнопкой.

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

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

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

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

QPushButton *QDialogButtonBox::addButton(StandardButton button)

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

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

QPushButton *QDialogButtonBox::button(StandardButton which) const

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

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

ButtonRole QDialogButtonBox::buttonRole(QAbstractButton *button) const

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

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

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

Возвращает список всех кнопок, которые были добавлены в набор кнопок.

См. также buttonRole(), addButton() и removeButton().

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

Переопределено из QWidget::changeEvent().

void QDialogButtonBox::clear()

Очищает набор кнопок, удаляя все кнопки в нём.

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

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

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

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

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

Переопределено из QObject::event().

[signal] void QDialogButtonBox::helpRequested()

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

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

[signal] void QDialogButtonBox::rejected()

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

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

void QDialogButtonBox::removeButton(QAbstractButton *button)

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

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

StandardButton QDialogButtonBox::standardButton(QAbstractButton *button) const

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

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