Sur cette page

Dialog QML Type

Classe de base des dialogues natifs. 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. Il est fortement déconseillé de l'utiliser dans un 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 dialogues des plates-formes 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.

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 du 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 :

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é 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é.

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

Note : Ce signal n'est pas émis lors de la fermeture du dialogue avec 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 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.