Тип QML DialogButtonBox

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

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

Свойства

• alignment : flags
• delegate : Component
• position : перечисление
• standardButtons : перечисление

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

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

Сигналы

• void accepted()
• void clicked(AbstractButton button)
• void helpRequested()
• void rejected()

Методы

• AbstractButton standardButton(StandardButton button)

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

Диалоговые окна и информационные сообщения обычно представляют кнопки в порядке, соответствующем рекомендациям по интерфейсу для этой платформы. Постоянно разные платформы имеют свои диалоговые кнопки в разном порядке. 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() излучается для фактической нажатой кнопки. Для удобства, если кнопка имеет AcceptRole, RejectRole, или HelpRole, соответственно излучаются сигналы accepted(), rejected() или helpRequested().

См. также Dialog.

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

alignment : flags

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

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

delegate : Component

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

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

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

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

void accepted()

Этот сигнал излучается, когда нажимается кнопка, определенная как AcceptRole или YesRole.

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

void clicked(AbstractButton button)

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

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

void helpRequested()

Этот сигнал излучается, когда нажимается кнопка, определенная как HelpRole.

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

void rejected()

Этот сигнал излучается, когда нажимается кнопка, определенная как RejectRole или NoRole.

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

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

AbstractButton standardButton(StandardButton button)

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

См. также standardButtons.