Тип QML DialogButtonBox

Панель кнопок, используемая в диалоговых окнах. Подробнее...

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

Свойства

• alignment : флаги
• buttonLayout : перечисление
• delegate : Компонент
• position : перечисление
• standardButtons : перечисление

Прикреплённые свойства

• buttonBox : DialogButtonBox
• buttonRole : перечисление

Сигналы

• accepted()
• applied()
• clicked(AbstractButton button)
• discarded()
• helpRequested()
• rejected()
• reset()

Методы

• AbstractButton standardButton(StandardButton button)

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

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

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

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

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

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

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

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

В качестве альтернативы, кнопки и их роли можно задавать вручную:

DialogButtonBox {
    Button {
        text: qsTr("Save")
        DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole
    }
    Button {
        text: qsTr("Close")
        DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole
    }
}

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

Когда кнопка нажимается в панели кнопок, сигнал clicked() генерируется для фактической нажатой кнопки. Кроме того, следующие сигналы автоматически генерируются при нажатии кнопки с соответствующей ролью(ями):

См. также Диалоговое окно.

Документация по свойствам

alignment : флаги

Это свойство содержит выравнивание кнопок.

Возможные значения:

[since QtQuick.Controls 2.5 (Qt 5.12)] buttonLayout : перечисление

Это свойство содержит политику макета кнопок, которая должна использоваться при размещении кнопок, содержащихся в панели кнопок. Значение по умолчанию зависит от платформы.

Доступные значения:

Это свойство было введено в QtQuick.Controls 2.5 (Qt 5.12).

delegate : Компонент

Это свойство содержит делегат для создания стандартных кнопок.

См. также standardButtons.

position : перечисление

Это свойство содержит положение панели кнопок.

Примечание: Если панель кнопок назначена в качестве заголовка или подвала ApplicationWindow или страницы, соответствующее положение назначается автоматически.

Возможные значения:

Значение по умолчанию — Footer.

См. также Dialog::header и Dialog::footer.

standardButtons : перечисление

Это свойство содержит комбинацию стандартных кнопок, используемых панелью кнопок.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

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

Возможные флаги:

См. также standardButton().

Документация прикреплённого свойства

[только для чтения] DialogButtonBox.buttonBox : DialogButtonBox

Это прикреплённое свойство содержит панель кнопок, управляющую данной кнопкой, или null если кнопка не находится в панели кнопок.

DialogButtonBox.buttonRole : перечисление

Это прикреплённое свойство содержит роль каждой кнопки в панели кнопок.

DialogButtonBox {
    Button {
        text: qsTr("Save")
        DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole
    }
    Button {
        text: qsTr("Close")
        DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole
    }
}

Доступные значения:

Документация сигналов

accepted()

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

Примечание: Соответствующий обработчик - onAccepted.

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

[since QtQuick.Controls 2.3 (Qt 5.10)] applied()

Этот сигнал испускается при нажатии кнопки, определённой с помощью ApplyRole.

Примечание: Соответствующий обработчик - onApplied.

Этот сигнал был добавлен в QtQuick.Controls 2.3 (Qt 5.10).

См. также discarded() и reset().

clicked(AbstractButton button)

Этот сигнал испускается при нажатии кнопки button внутри панели кнопок.

Примечание: Соответствующий обработчик - onClicked.

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

[since QtQuick.Controls 2.3 (Qt 5.10)] discarded()

Этот сигнал испускается при нажатии кнопки, определённой с помощью DiscardRole.

Примечание: Соответствующий обработчик - onDiscarded.

Этот сигнал был добавлен в QtQuick.Controls 2.3 (Qt 5.10).

См. также reset() и applied().

helpRequested()

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

Примечание: Соответствующий обработчик - onHelpRequested.

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

rejected()

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

Примечание: Соответствующий обработчик - onRejected.

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

[since QtQuick.Controls 2.3 (Qt 5.10)] reset()

Этот сигнал испускается при нажатии кнопки, определённой с помощью ResetRole.

Примечание: Соответствующий обработчик - onReset.

Этот сигнал был добавлен в QtQuick.Controls 2.3 (Qt 5.10).

См. также discarded() и applied().

Документация методов

AbstractButton standardButton(StandardButton button)

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

См. также standardButtons.