Dialog QML Type

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

Import Statement: import QtQuick.Dialogs
Since: Qt 6.2
Inherits:

QtObject

Inherited By:

ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog

Propriétés

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.

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 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é contient la modalité 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 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 en itérant les 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é peut être utilisée pour modifier le type de fenêtre contextuelle de la boîte de dialogue rapide non native.

Les valeurs disponibles sont les suivantes

ConstanteDescription
Popup.ItemLa boîte de dialogue apparaît comme un élément dans la fenêtre de l'élément parent le plus proche.
Popup.WindowLa boîte de dialogue apparaît dans sa propre fenêtre.
Popup.NativeCette 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 :

ConstanteValeur
Dialog.Accepted
Dialog.Rejected

Remarque : 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é 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 : le gestionnaire correspondant est onAccepted.

Voir également 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 aussi visible et open().


void done(int result)

Ferme la boîte de dialogue et active le signal result.

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