Dialog QML Type
Classe de base des dialogues natifs. Plus d'informations...
| 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 l'API QML commune pour les dialogues des plateformes natives. Pour les dialogues non natifs, voir Dialog.
Pour afficher un dialogue natif, construisez une instance de l'une des implémentations concrètes de Dialog, définissez les propriétés souhaitées et appelez open(). Dialog émet accepted() ou rejected() lorsque l'utilisateur en a terminé avec le dialogue.
Remarque : il s'agit d'un type interne qui ne peut pas être créé en QML.
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 du dialogue.
flags : Qt::WindowFlags
Cette propriété contient les drapeaux de fenêtre de la boîte de dialogue. La valeur par défaut est Qt.Dialog.
modality : Qt::WindowModality
Cette propriété indique la modalité du 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 la saisie dans les autres fenêtres. |
Qt.WindowModal | La boîte de dialogue est modale pour une seule hiérarchie de fenêtres et bloque la saisie dans sa fenêtre parentale, dans toutes les fenêtres grand-parentales et dans tous les frères et sœurs de sa fenêtre parentale et de ses fenêtres grand-parentales. |
Qt.ApplicationModal | La boîte de dialogue est modale pour l'application et bloque la saisie dans toutes les fenêtres. |
parentWindow : Window
Cette propriété contient la fenêtre parent de la boîte de dialogue.
Si elle n'est pas explicitement définie, la fenêtre est automatiquement résolue par itération des objets parents QML jusqu'à ce qu'un Window ou un Item doté d'une fenêtre soit trouvé.
popupType : enumeration [since 6.10]
Cette propriété permet de modifier l'adresse popupType 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ît comme un élément dans la fenêtre de l'élément parent le plus proche. |
Popup.Window | La boîte de dialogue apparaît dans sa propre fenêtre. |
Popup.Native | Cette valeur n'est pas prise en charge. Popup.Window sera utilisé à la place. |
Note : 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 | Valeur |
|---|---|
Dialog.Accepted | |
Dialog.Rejected |
Note : MessageDialog définit le résultat à la valeur du bouton standard cliqué au lieu d'utiliser les codes de résultat standard.
title : string
Cette propriété contient le titre du dialogue.
visible : bool
Cette propriété définit la visibilité du dialogue. La valeur par défaut est false.
Voir également open() et close().
Documentation sur les signaux
void accepted()
Ce signal est émis lorsque le dialogue a été accepté, soit de manière interactive, soit en appelant accept().
Remarque : le gestionnaire correspondant est onAccepted.
Voir aussi rejected().
void rejected()
Ce signal est émis lorsque le dialogue a été rejeté, soit de manière interactive, soit en appelant reject().
Ce signal est également émis lors de la fermeture du dialogue avec close().
Remarque : le gestionnaire correspondant est onRejected.
Voir aussi accepted().
Documentation de la méthode
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'adresse result.
Voir aussi accept(), reject() et result.
void open()
Ouvre la boîte de dialogue.
Voir aussi 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.
