DialogButtonBox QML 类型

用于对话框中的按钮框。 更多信息...

• 所有成员的列表，包括继承的成员

属性

• alignment : flags
• buttonLayout : enumeration (since QtQuick.Controls 2.5 (Qt 5.12))
• delegate : Component
• position : enumeration
• standardButtons : enumeration

附加属性

• buttonBox : DialogButtonBox
• buttonRole : enumeration

信号

• accepted()
• applied() (since QtQuick.Controls 2.3 (Qt 5.10))
• clicked(AbstractButton button)
• discarded() (since QtQuick.Controls 2.3 (Qt 5.10))
• helpRequested()
• rejected()
• reset() (since QtQuick.Controls 2.3 (Qt 5.10))

方法

• AbstractButton standardButton(StandardButton button)

详细描述

对话框和信息框通常以符合该平台界面指南的顺序显示按钮。不同的平台可能有不同顺序的对话框按钮。DialogButtonBox 允许开发者为它添加按钮，并会自动使用用户平台的适当顺序。

大多数对话框按钮遵循某些角色。这些角色包括

• 接受或拒绝对话框。
• 请求帮助。
• 对对话框本身执行操作（例如重置字段或应用更改）。

还可以有其他取消对话框的方法，这可能造成破坏性后果。

大多数对话框都有几乎可以被认为是标准的按钮（例如 OK 和 Cancel 按钮）。有时以标准方式创建这些按钮很方便。

使用 DialogButtonBox 有几种方法。一种方法是指定标准按钮（例如 OK、Cancel、Save）并让按钮框设置按钮。

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() 信号，用于实际的按下按钮。此外，按下具有相应角色的按钮时，还会自动发出以下信号

另请参阅 Dialog.

属性文档

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
    }
}

信使文档

方法文档