Dialog QML Type

Classe de base des dialogues natifs. Plus d'informations...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Inherited By:

ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog

Propriétés

Signaux

Méthodes

Description détaillée

Le type Dialog fournit une API QML commune pour les dialogues des plateformes natives.

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.

Note : La compatibilité des types dans les modules Qt.labs n'est pas garantie dans les versions futures.

Propriété Documentation

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 drapeaux de fenêtre de la boîte de dialogue. La valeur par défaut est Qt.Dialog.


modality : Qt::WindowModality

Cette propriété contient la modalité du 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 la saisie dans les autres fenêtres.
Qt.WindowModalLa 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.ApplicationModalLa boîte de dialogue est modale pour l'application et bloque la saisie dans toutes les fenêtres.

parentWindow : Window

Cette propriété définit la fenêtre parent de la boîte de dialogue.

Sauf si elle est explicitement définie, la fenêtre est automatiquement résolue par itération des objets parents QML jusqu'à ce qu'une fenêtre Window ou Item soit trouvée.


result : int

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

Codes de résultat standard :

ConstanteValeur
Dialog.Accepted
Dialog.Rejected

Note : MessageDialog fixe le résultat à la valeur du bouton standard cliqué au lieu d'utiliser les codes de résultat standard.


title : string

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


visible : bool

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

Voir également open() et close().


Signal Documentation

void accepted()

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

Remarque : Ce signal n'est pas émis lors de la fermeture de la boîte de dialogue à l'aide de close().

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

Note : Ce signal n'est pas é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.

Voir aussi visible et open().


void done(int result)

Ferme la boîte de dialogue et active le signal 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().


© 2025 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.