DialogButtonBox QML Type

Boîte à boutons utilisée dans les boîtes de dialogue. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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

Propriétés rattachées

• buttonBox : DialogButtonBox
• buttonRole : enumeration

Signaux

• 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))

Méthodes

• AbstractButton standardButton(StandardButton button)

Description détaillée

Les boîtes de dialogue et de message présentent généralement les boutons dans un ordre conforme aux directives d'interface de la plate-forme concernée. Invariablement, les boutons des boîtes de dialogue ne sont pas présentés dans le même ordre d'une plate-forme à l'autre. DialogButtonBox permet à un développeur d'ajouter des boutons et utilise automatiquement l'ordre approprié pour la plate-forme de l'utilisateur.

La plupart des boutons d'une boîte de dialogue suivent certains rôles. Ces rôles sont les suivants

• Accepter ou rejeter la boîte de dialogue.
• Demander de l'aide.
• Effectuer des actions sur la boîte de dialogue elle-même (comme réinitialiser des champs ou appliquer des modifications).

Il peut également y avoir d'autres façons de rejeter la boîte de dialogue, ce qui peut entraîner des résultats destructeurs.

La plupart des boîtes de dialogue comportent des boutons que l'on peut presque considérer comme standard (par exemple, les boutons OK et Cancel ). Il est parfois pratique de créer ces boutons de manière standard.

Il existe plusieurs façons d'utiliser DialogButtonBox. La première consiste à spécifier les boutons standard (par exemple OK, Cancel, Save) et à laisser la boîte à boutons les configurer.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

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

Il est également possible de spécifier manuellement les boutons et leur rôle :

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

Vous pouvez également mélanger les boutons normaux et les boutons standard.

Lorsqu'un bouton est cliqué dans la boîte à boutons, le signal clicked() est émis pour le bouton pressé. En outre, les signaux suivants sont automatiquement émis lorsqu'un bouton ayant le(s) rôle(s) correspondant(s) est pressé :

Voir aussi Dialog.

Documentation sur les biens

alignment : flags

Cette propriété définit l'alignement des boutons.

Valeurs possibles :

Par défaut, aucun alignement spécifique n'est défini ; la lecture de la propriété alignment produit une valeur de drapeau par défaut qui est égale à 0. La propriété peut être réinitialisée à cette valeur en lui attribuant undefined. Dans ce cas, les boutons sont redimensionnés pour remplir l'espace disponible.

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

Cette propriété définit la politique d'agencement des boutons à utiliser lors de la disposition des boutons contenus dans la boîte à boutons. La valeur par défaut est spécifique à la plate-forme.

Valeurs disponibles :

Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

defaultButton : AbstractButton [since 6.11]

Cette propriété contient le bouton par défaut.

Le bouton par défaut sera highlighted et recevra le focus.

Un seul bouton de la boîte à boutons peut être défini comme bouton par défaut. Cette propriété ne peut pas être utilisée en même temps que la propriété defaultStandardButton.

Cette propriété a été introduite dans Qt 6.11.

Voir également standardButtons et defaultStandardButton.

defaultStandardButton : enumeration [since 6.11]

Cette propriété contient le bouton standard par défaut.

Le bouton standard par défaut sera highlighted et recevra le focus.

Un seul bouton de la boîte à boutons peut être défini comme bouton par défaut. Cette propriété ne peut pas être utilisée en même temps que la propriété defaultButton.

Cette propriété a été introduite dans Qt 6.11.

Voir également standardButtons et defaultButton.

delegate : Component

Cette propriété contient un délégué pour la création de boutons standard.

DialogButtonBox n'est pas propriétaire du délégué.

Voir aussi standardButtons.

position : enumeration

Cette propriété définit la position de la boîte à boutons.

Valeurs possibles :

La valeur par défaut est Footer.

Voir également Dialog::header et Dialog::footer.

standardButtons : enumeration

Cette propriété contient une combinaison de boutons standard utilisés par la boîte à boutons.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

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

Les boutons seront positionnés dans l'ordre approprié à la plate-forme de l'utilisateur.

Drapeaux possibles :

Voir également standardButton().

Documentation sur les propriétés attachées

DialogButtonBox.buttonBox : DialogButtonBox [read-only]

Cette propriété jointe contient la boîte à boutons qui gère ce bouton, ou null si le bouton ne se trouve pas dans une boîte à boutons.

DialogButtonBox.buttonRole : enumeration

Cette propriété jointe définit le rôle de chaque bouton dans une boîte à boutons.

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

Valeurs disponibles :

Documentation sur les signaux

accepted()

Ce signal est émis lorsqu'un bouton défini avec AcceptRole ou YesRole est cliqué.

Voir aussi rejected(), clicked() et helpRequested().

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

Ce signal est émis lorsqu'un bouton défini avec ApplyRole est cliqué.

Ce signal a été introduit dans QtQuick.Controls 2.3 (Qt 5.10).

Voir aussi discarded() et reset().

clicked(AbstractButton button)

Ce signal est émis lorsqu'un button situé dans la boîte à boutons est cliqué.

Voir aussi accepted(), rejected() et helpRequested().

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

Ce signal est émis lorsqu'un bouton défini avec DiscardRole est cliqué.

Ce signal a été introduit dans QtQuick.Controls 2.3 (Qt 5.10).

Voir aussi reset() et applied().

helpRequested()

Ce signal est émis lorsqu'un bouton défini avec HelpRole est cliqué.

Voir aussi accepted(), rejected() et clicked().

rejected()

Ce signal est émis lorsqu'un bouton défini avec RejectRole ou NoRole est cliqué.

Voir aussi accepted(), helpRequested() et clicked().

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

Ce signal est émis lorsqu'un bouton défini avec ResetRole est cliqué.

Ce signal a été introduit dans QtQuick.Controls 2.3 (Qt 5.10).

Voir aussi discarded() et applied().

Documentation de la méthode

AbstractButton standardButton(StandardButton button)

Renvoie le standard spécifié button, ou null s'il n'existe pas.

Voir aussi standardButtons.