Dialog QML Type

Boîte de dialogue contextuelle dotée de boutons standard et d'un titre, utilisée pour une interaction de courte durée avec l'utilisateur. Plus d'informations...

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

Propriétés

• footer : Item
• header : Item
• implicitFooterHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitFooterWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitHeaderHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitHeaderWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• result : int (since QtQuick.Controls 2.3 (Qt 5.10))
• standardButtons : enumeration
• title : string

Signaux

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

Méthodes

• void accept()
• void done(int result) (since QtQuick.Controls 2.3 (Qt 5.10))
• void reject()
• AbstractButton standardButton(StandardButton button) (since QtQuick.Controls 2.3 (Qt 5.10))

Description détaillée

Un dialogue est une fenêtre contextuelle principalement utilisée pour des tâches de courte durée et de brèves communications avec l'utilisateur. Comme pour ApplicationWindow et Page, Dialog est organisé en trois sections : header, contentItem, et footer.

Les propriétés padding n'affectent que l'élément de contenu. Utilisez la propriété spacing pour modifier l'espace entre l'en-tête, l'élément de contenu et le pied de page.

Par défaut, les dialogues ont focus.

Titre et boutons de la boîte de dialogue

La boîte de dialogue title est affichée par une barre de titre spécifique au style, attribuée par défaut à la boîte de dialogue header.

Les boutons standard de la boîte de dialogue sont gérés par une page DialogButtonBox qui est assignée par défaut à la boîte de dialogue footer. La propriété standardButtons de la boîte de dialogue est transmise à la propriété correspondante de la boîte à boutons. En outre, les signaux accepted() et rejected() de la boîte à boutons sont connectés aux signaux correspondants dans Dialog.

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

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

Dialogues modaux

Une boîte de dialogue modal bloque l'accès à d'autres contenus situés sous la boîte de dialogue. Lorsqu'une boîte de dialogue modale est ouverte, l'utilisateur doit finir d'interagir avec la boîte de dialogue et la fermer avant de pouvoir accéder à tout autre contenu dans la même fenêtre.

Dialog {
    id: dialog
    modal: true
    standardButtons: Dialog.Ok
}

Dialogues sans modèle

Une boîte de dialogue sans modèle est une boîte de dialogue qui fonctionne indépendamment des autres contenus qui l'entourent. Lorsqu'une boîte de dialogue sans modèle est ouverte, l'utilisateur est autorisé à interagir à la fois avec la boîte de dialogue et avec le reste du contenu de la même fenêtre.

Dialog {
    id: dialog
    modal: false
    standardButtons: Dialog.Ok
}

Voir également DialogButtonBox et Popup Controls.

Documentation sur les propriétés

footer : Item

Cette propriété contient l'élément de pied de page de la boîte de dialogue. L'élément de pied de page est positionné en bas et redimensionné en fonction de la largeur de la boîte de dialogue. La valeur par défaut est null.

Voir aussi header.

header : Item

Cette propriété contient l'élément d'en-tête de la boîte de dialogue. L'élément d'en-tête est positionné en haut et redimensionné en fonction de la largeur de la boîte de dialogue. La valeur par défaut est null.

Voir aussi footer.

implicitFooterHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété indique la hauteur implicite du pied de page.

La valeur est égale à footer && footer.visible ? footer.implicitHeight : 0.

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

Voir également implicitFooterWidth et implicitHeaderHeight.

implicitFooterWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété indique la largeur implicite du pied de page.

La valeur est égale à footer && footer.visible ? footer.implicitWidth : 0.

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

Voir également implicitFooterHeight et implicitHeaderWidth.

implicitHeaderHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété indique la hauteur implicite de l'en-tête.

La valeur est égale à header && header.visible ? header.implicitHeight : 0.

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

Voir aussi implicitHeaderWidth et implicitFooterHeight.

implicitHeaderWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Cette propriété indique la largeur de l'en-tête implicite.

La valeur est égale à header && header.visible ? header.implicitWidth : 0.

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

Voir aussi implicitHeaderHeight et implicitFooterWidth.

result : int [since QtQuick.Controls 2.3 (Qt 5.10)]

Cette propriété contient le code de résultat.

Codes de résultat standard :

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir aussi accept(), reject() et done().

standardButtons : enumeration

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

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.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 aussi DialogButtonBox.

title : string

Cette propriété contient le titre de la boîte de dialogue.

Le titre est affiché dans l'en-tête de la boîte de dialogue.

Dialog {
    title: qsTr("About")

    Label {
        text: "Lorem ipsum..."
    }
}

Documentation sur les signaux

accepted()

Ce signal est émis lorsque le dialogue a été accepté, soit de manière interactive, soit en appelant accept().

Voir aussi rejected().

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

Ce signal est émis lorsque le bouton standard Dialog.Apply est cliqué.

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

Voir aussi discarded() et reset().

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

Ce signal est émis lorsque le bouton standard Dialog.Discard est cliqué.

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

Voir aussi reset() et applied().

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

Ce signal est émis lorsque le bouton standard Dialog.Help est cliqué.

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

Voir aussi accepted() et rejected().

rejected()

Ce signal est émis lorsque le dialogue a été rejeté, soit de manière interactive, soit en appelant reject().

Voir aussi accepted().

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

Ce signal est émis lorsque le bouton standard Dialog.Reset 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

void accept()

Emet le signal accepted() et ferme la boîte de dialogue.

Voir aussi reject() et done().

[since QtQuick.Controls 2.3 (Qt 5.10)] void done(int result)

1. Fixe la valeur de result.
2. Emet accepted() ou rejected() selon que le résultat est Dialog.Accepted ou Dialog.Rejected, respectivement.
3. Emet closed().

Cette méthode a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir également accept(), reject() et result.

void reject()

Emet le signal rejected() et ferme la boîte de dialogue.

Voir aussi accept() et done().

[since QtQuick.Controls 2.3 (Qt 5.10)] AbstractButton standardButton(StandardButton button)

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

Cette méthode a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir aussi standardButtons.