DialogButtonBox QML Type

Une boîte de boutons utilisée dans les boîtes de dialogue. En savoir plus...

• 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 associé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 les fenêtres de message présentent généralement les boutons dans un ordre conforme aux directives d'interface de la plateforme concernée. Les différentes plateformes ont invariablement un ordre différent pour les boutons de leurs boîtes de dialogue. DialogButtonBox permet à un développeur d'y ajouter des boutons et utilise automatiquement l'ordre approprié pour la plateforme de l'utilisateur.

La plupart des boutons d’une boîte de dialogue remplissent des rôles spécifiques. Ces rôles comprennent notamment :

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

Il peut également exister d’autres moyens de fermer la boîte de dialogue, qui peuvent entraîner des conséquences indésirables.

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. L’une d’elles consiste à spécifier les boutons standard (par exemple « OK », « Cancel » et « Save ») et à laisser la boîte de dialogue configurer les boutons.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

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

Sinon, les boutons et leurs rôles peuvent être définis manuellement :

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

Vous pouvez également combiner des boutons normaux et des boutons standard.

Lorsqu’on clique sur un bouton dans la boîte à boutons, le signal ` clicked()` est émis pour le bouton effectivement enfoncé. De plus, les signaux suivants sont automatiquement émis lorsqu’un bouton ayant le ou les rôles correspondants est enfoncé :

Voir aussi Dialog.

Documentation sur les propriétés

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é d’alignement renvoie une valeur par défaut équivalente à 0. La propriété peut être réinitialisée à cette valeur en lui attribuant la valeur « undefined ». Dans ce cas, les boutons sont redimensionnés pour occuper tout l’espace disponible.

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

Cette propriété définit la stratégie de disposition des boutons à utiliser lors de l'agencement des boutons contenus dans la zone de boutons. La valeur par défaut dépend de la plateforme.

Valeurs disponibles :

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

defaultButton : AbstractButton [since 6.11]

Cette propriété définit 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 conjointement avec 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é définit 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 conjointement avec 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é permettant de créer des boutons standard.

DialogButtonBox Elle ne prend pas possession du délégué.

Voir également standardButtons.

position : enumeration

Cette propriété définit la position de la zone de boutons.

Valeurs possibles :

La valeur par défaut est « Footer ».

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

standardButtons : enumeration

Cette propriété contient un ensemble 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é pour la plateforme de l'utilisateur.

Indicateurs possibles :

Voir également standardButton().

Documentation sur les propriétés associées

DialogButtonBox.buttonBox : DialogButtonBox [read-only attached]

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

DialogButtonBox.buttonRole : enumeration [attached]

Cette propriété associée 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'on clique sur un bouton défini à l'aide de la méthode ` AcceptRole ` ou ` YesRole `.

Voir également rejected(), clicked() et helpRequested().

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

Ce signal est émis lorsqu'on clique sur un bouton défini avec l'ApplyRole.

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

Voir également discarded() et reset().

clicked(AbstractButton button)

Ce signal est émis lorsqu'on clique sur un « button » situé à l'intérieur de la zone du bouton.

Voir également accepted(), rejected() et helpRequested().

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

Ce signal est émis lorsqu'on clique sur un bouton défini à l'aide de l'DiscardRole.

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

Voir également ` reset()` et ` applied()`.

helpRequested()

Ce signal est émis lorsqu'on clique sur un bouton défini à l'aide de l'HelpRole.

Voir également accepted(), rejected() et clicked().

rejected()

Ce signal est émis lorsqu'on clique sur un bouton défini à l'aide de la méthode ` RejectRole ` ou ` NoRole `.

Voir également accepted(), helpRequested() et clicked().

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

Ce signal est émis lorsqu'on clique sur un bouton défini à l'aide de l'ResetRole.

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

Voir également discarded() et applied().

Documentation de la méthode

AbstractButton standardButton(StandardButton button)

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

Voir également standardButtons.