Dialog QML Type
La classe de base des boîtes de dialogue natives. En savoir plus…
| Import Statement: | import QtQuick.Dialogs |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog |
Propriétés
- data : list<QtObject>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- popupType : enumeration
(since 6.10) - result : int
- title : string
- visible : bool
Signaux
Méthodes
Description détaillée
Le type Dialog fournit une API QML commune pour les boîtes de dialogue natives de la plateforme. Pour les boîtes de dialogue non natives, consultez Dialog.
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 la méthode open(). Dialog émet les événements accepted() ou rejected() lorsque l'utilisateur a terminé d'utiliser la boîte de dialogue.
Remarque : il s’agit d’un type interne qui ne peut pas être créé en QML.
Documentation des 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 :
| Constante | Description |
|---|---|
Qt.NonModal | La boîte de dialogue n'est pas modale et ne bloque pas les entrées vers les autres fenêtres. |
Qt.WindowModal | La boîte de dialogue est modale par rapport à une seule hiérarchie de fenêtres et bloque les entrées vers 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.ApplicationModal | La 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 ` Window ` ou un ` Item ` contenant une fenêtre soit trouvé.
popupType : enumeration [since 6.10]
Cette propriété permet de modifier l'popupType e de la boîte de dialogue rapide non native.
Les valeurs disponibles sont les suivantes :
| Constante | Description |
|---|---|
Popup.Item | La boîte de dialogue apparaîtra en tant qu'élément dans la fenêtre de l'élément parent le plus proche. |
Popup.Window | La boîte de dialogue s'affichera dans sa propre fenêtre. |
Popup.Native | Cette valeur n'est pas prise en charge. La propriété « Popup.Window » sera utilisée à la place.Remarque : cette propriété n’a aucun effet lors de l’utilisation d’une boîte de dialogue native. |
Cette propriété a été introduite dans Qt 6.10.
result : int
Cette propriété contient le code de résultat.
Codes de résultat standard :
| Constante | Description |
|---|---|
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 : 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()`.
Ce signal est également émis lors de la fermeture de la boîte de dialogue à l'aide de la fonction close().
Remarque : le gestionnaire correspondant est ` onRejected`.
Voir également 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 et émet le signal « accepted() » ou « rejected() ».
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.
