Dialog QML Type

Boîte de dialogue contextuelle comportant des boutons standard et un titre, utilisée pour une interaction de courte durée avec l'utilisateur. En savoir plus...

• 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

Une boîte de dialogue est une fenêtre contextuelle principalement utilisée pour des tâches ponctuelles et des communications brèves avec l'utilisateur. À l'instar de ApplicationWindow et Page, Dialog est organisé en trois sections : header, contentItem et footer.

Les propriétés padding n’affectent que le contentItem. Utilisez la propriété spacing pour modifier l’espacement entre l’en-tête, le contentItem et le pied de page.

Par défaut, les boîtes de dialogue ont la valeur « focus ».

Titre et boutons de la boîte de dialogue

L'title d'une boîte de dialogue s'affiche sous la forme d'une barre de titre au style spécifique, qui est attribuée par défaut comme header de la boîte de dialogue.

Les boutons standard de la boîte de dialogue sont gérés par une DialogButtonBox qui est attribuée par défaut en tant qu’ footer. La propriété standardButtons de la boîte de dialogue est transmise à la propriété correspondante de la boîte de boutons. De plus, les signaux accepted() et rejected() de la boîte de boutons sont connectés aux signaux correspondants dans 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")
}

Boîtes de dialogue modales

Une boîte de dialogue « modal » bloque l'accès au contenu situé sous la boîte de dialogue. Lorsqu'une boîte de dialogue modale est ouverte, l'utilisateur doit terminer son interaction avec celle-ci et la fermer avant de pouvoir accéder à tout autre contenu de la même fenêtre.

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

Boîtes de dialogue non modales

Une boîte de dialogue non modale fonctionne indépendamment des autres éléments qui l'entourent. Lorsqu'une boîte de dialogue non modale est ouverte, l'utilisateur peut interagir à la fois avec la boîte de dialogue et avec les autres éléments 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é définit l'élément de pied de page de la boîte de dialogue. Cet élément est positionné en bas de la boîte de dialogue et redimensionné pour s'adapter à la largeur de celle-ci. La valeur par défaut est null.

Voir également 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é pour s'adapter à la largeur de la boîte de dialogue. La valeur par défaut est null.

Voir également footer.

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

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

Sa 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é contient la largeur implicite du pied de page.

Sa 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é contient la hauteur implicite de l'en-tête.

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

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

Voir également implicitHeaderWidth et implicitFooterHeight.

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

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

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

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

Voir également 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 également accept(), reject() et done().

standardButtons : enumeration

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

Indicateurs possibles :

Voir également DialogButtonBox.

title : string

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

Le titre s'affiche 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 la boîte de dialogue a été acceptée, soit de manière interactive, soit en appelant la fonction ` accept()`.

Voir également rejected().

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

Ce signal est émis lorsque l'on clique sur le bouton standard « Dialog.Apply ».

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

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

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

Ce signal est émis lorsque l'on clique sur le bouton standard « Dialog.Discard ».

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

Voir également reset() et applied().

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

Ce signal est émis lorsque l'on clique sur le bouton standard « Dialog.Help ».

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

Voir également ` accepted()` et ` rejected()`.

rejected()

Ce signal est émis lorsque la boîte de dialogue a été rejetée, soit de manière interactive, soit en appelant la fonction ` reject()`.

Voir également accepted().

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

Ce signal est émis lorsque l'on clique sur le bouton standard « Dialog.Reset ».

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

Voir également discarded() et applied().

Documentation de la méthode

void accept()

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

Voir également reject() et done().

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

1. Définit la méthode result.
2. Émet ` accepted()` ou ` rejected()`, selon que le résultat est respectivement ` Dialog.Accepted ` ou ` Dialog.Rejected`.
3. Émet closed().

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

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

void reject()

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

Voir également accept() et done().

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

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

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

Voir également standardButtons.