Sur cette page

Dialog QML Type

La classe de base des boîtes de dialogue natives. En savoir plus…

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Inherited By:

ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog

Status: Deprecated since 6.11

Ce type est obsolète depuis Qt Labs Platform 6.11. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Signaux

Méthodes

Description détaillée

Utilisez plutôt QtQuick.Dialogs Dialog.

Le type Dialog fournit une API QML commune pour les boîtes de dialogue natives de la plateforme.

Pour afficher une boîte de dialogue native, créez une instance de l'une des implémentations concrètes de `Dialog`, définissez les propriétés souhaitées, puis appelez ` open()`. La boîte de dialogue émet ` accepted()` ou ` rejected()` lorsque l'utilisateur a terminé d'utiliser la boîte de dialogue.

Remarque : la compatibilité des types dans les modules Qt.labs n’est pas garantie dans les versions futures.

Documentation sur les propriétés

data : list<QtObject> [default]

Cette propriété par défaut contient la liste de tous les objets déclarés comme enfants de la boîte de dialogue.

flags : Qt::WindowFlags

Cette propriété contient les indicateurs de fenêtre de la boîte de dialogue. La valeur par défaut est « Qt.Dialog ».

modality : Qt::WindowModality

Cette propriété indique le mode d'affichage de la boîte de dialogue. La valeur par défaut est « Qt.WindowModal ».

Valeurs disponibles :

ConstanteDescription
Qt.NonModalLa boîte de dialogue n'est pas modale et ne bloque pas les entrées vers les autres fenêtres.
Qt.WindowModalLa boîte de dialogue est modale par rapport à une seule hiérarchie de fenêtres et bloque la saisie dans sa fenêtre parente, toutes ses fenêtres aïeules et toutes les fenêtres sœurs de ses fenêtres parente et aïeules.
Qt.ApplicationModalLa boîte de dialogue est modale par rapport à l'application et bloque les entrées vers toutes les fenêtres.

parentWindow : Window

Cette propriété contient la fenêtre parente de la boîte de dialogue.

À moins d’être explicitement définie, la fenêtre est automatiquement déterminée en parcourant les objets parents QML jusqu’à ce qu’un objet de type « Window » ou « Item » contenant une fenêtre soit trouvé.

result : int

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

Codes de résultat standard :

ConstanteDescription
Dialog.Accepted 
Dialog.Rejected

Remarque : MessageDialog attribue au résultat la valeur du bouton standard sur lequel l'utilisateur a cliqué, au lieu d'utiliser les codes de résultat standard.

title : string

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

visible : bool

Cette propriété détermine la visibilité de la boîte de dialogue. La valeur par défaut est « false ».

Voir également open() et close().

Documentation sur les signaux

void 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()`.

Remarque : ce signal n' est pas émis lors de la fermeture de la boîte de dialogue avec close().

Remarque : le gestionnaire correspondant est onAccepted.

Voir également rejected().

void 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()`.

Remarque : ce signal n' est pas émis lors de la fermeture de la boîte de dialogue avec close().

Remarque : le gestionnaire correspondant est onRejected.

Voir aussi accepted().

Documentation des méthodes

void accept()

Ferme la boîte de dialogue et émet le signal accepted().

Voir aussi reject().

void close()

Ferme la boîte de dialogue.

Voir également visible et open().

void done(int result)

Ferme la boîte de dialogue et définit l'result.

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

void open()

Ouvre la boîte de dialogue.

Voir également visible et close().

void reject()

Ferme la boîte de dialogue et émet le signal rejected().

Voir aussi accept().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.