DialogButtonBox QML Type

用于对话框的按钮框。更多内容...

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

属性

• alignment : flags
• buttonLayout : enumeration (since QtQuick.Controls 2.5 (Qt 5.12))
• defaultButton : AbstractButton (since 6.11)
• defaultStandardButton : enumeration (since 6.11)
• 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 。

属性文档

alignment : flags

该属性用于设置按钮的对齐方式。

可能的取值：

默认情况下，未设置特定的对齐方式；读取对齐属性将返回一个默认标志值，该值等同于 0。通过将该属性赋值为 `undefined `，可将其重置为该值。此时，按钮将调整大小以填满可用空间。

buttonLayout : enumeration [since QtQuick.Controls 2.5 (Qt 5.12)]

该属性用于指定在排列按钮框中包含的按钮时所采用的按钮布局策略。默认值因平台而异。

可用值：

该属性在 QtQuick.Controls 2.5（Qt 5.12）中引入。

defaultButton : AbstractButton [since 6.11]

此属性用于指定默认按钮。

默认按钮将设置为highlighted ，并获得焦点。

按钮框中仅能将一个按钮设为默认按钮。该属性不能与defaultStandardButton 属性同时使用。

该属性于 Qt 6.11 中引入。

另请参阅 standardButtons 和defaultStandardButton 。

defaultStandardButton : enumeration [since 6.11]

该属性存储默认标准按钮。

默认标准按钮将设置为highlighted ，并获得焦点。

按钮框中仅能将一个按钮设为默认按钮。该属性不能与defaultButton 属性同时使用。

该属性自 Qt 6.11 起引入。

另请参阅 standardButtons 和defaultButton 。

delegate : Component

该属性保存了一个用于创建标准按钮的委托。

DialogButtonBox 不会获取该委托的所有权。

另请参阅 standardButtons 。

position : enumeration

此属性用于指定按钮框的位置。

可能的值：

默认值为Footer 。

另请参阅 Dialog::header 和Dialog::footer 。

standardButtons : enumeration

此属性包含按钮框所使用的标准按钮组合。

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

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

这些按钮将根据用户的平台以适当的顺序排列。

可能的标志：

另请参阅 standardButton()。

附加属性文档

DialogButtonBox.buttonBox : DialogButtonBox [read-only attached]

此附加属性包含管理该按钮的按钮框，如果该按钮未位于任何按钮框中，则为null 。

DialogButtonBox.buttonRole : enumeration [attached]

此附加属性用于指定按钮框中每个按钮的角色。

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

可用值：

Signal 文档

accepted()

当点击使用 `AcceptRole ` 或 `YesRole ` 定义的按钮时，会触发此信号。

另请参阅 rejected()、clicked() 和helpRequested()。

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

当点击使用ApplyRole 定义的按钮时，会触发此信号。

该信号在 QtQuick.Controls 2.3（Qt 5.10）中引入。

另请参阅 discarded() 和reset()。

clicked(AbstractButton button)

当按钮框内的button 被点击时，会触发此信号。

另请参阅 accepted()、rejected() 和helpRequested()。

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

当点击使用DiscardRole 定义的按钮时，会触发此信号。

该信号在 QtQuick.Controls 2.3（Qt 5.10）中引入。

另请参阅 reset() 和applied()。

helpRequested()

当点击使用HelpRole 定义的按钮时，会触发此信号。

另请参阅 accepted()、rejected() 和clicked()。

rejected()

当点击使用 `RejectRole ` 或 `NoRole ` 定义的按钮时，会触发此信号。

另请参阅 accepted()、helpRequested() 和clicked()。

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

当点击使用ResetRole 定义的按钮时，会触发此信号。

该信号在 QtQuick.Controls 2.3（Qt 5.10）中引入。

另请参阅 discarded() 和applied()。

方法文档

AbstractButton standardButton(StandardButton button)

返回指定的标准button ，如果不存在，则返回null 。

另请参阅 standardButtons 。