Dialog QML Type
Boîte de dialogue contextuelle dotée de boutons standard et d'un titre, utilisée pour une interaction de courte durée avec l'utilisateur. Plus d'informations...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propriétés
- footer : Item
- header : Item
- implicitFooterHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitFooterWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitHeaderHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitHeaderWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - result : int
(since QtQuick.Controls 2.3 (Qt 5.10)) - standardButtons : enumeration
- title : string
Signaux
- accepted()
- applied()
(since QtQuick.Controls 2.3 (Qt 5.10)) - discarded()
(since QtQuick.Controls 2.3 (Qt 5.10)) - helpRequested()
(since QtQuick.Controls 2.3 (Qt 5.10)) - rejected()
- reset()
(since QtQuick.Controls 2.3 (Qt 5.10))
Méthodes
- void accept()
- void done(int result)
(since QtQuick.Controls 2.3 (Qt 5.10)) - void reject()
- AbstractButton standardButton(StandardButton button)
(since QtQuick.Controls 2.3 (Qt 5.10))
Description détaillée
Un dialogue est une fenêtre contextuelle principalement utilisée pour des tâches de courte durée et de brèves communications avec l'utilisateur. Comme pour ApplicationWindow et Page, Dialog est organisé en trois sections : header, contentItem, et footer.

Les propriétés padding n'affectent que l'élément de contenu. Utilisez la propriété spacing pour modifier l'espace entre l'en-tête, l'élément de contenu et le pied de page.
Par défaut, les dialogues ont focus.
Titre et boutons de la boîte de dialogue
La boîte de dialogue title est affichée par une barre de titre spécifique au style, attribuée par défaut à la boîte de dialogue header.
Les boutons standard de la boîte de dialogue sont gérés par une page DialogButtonBox qui est assignée par défaut à la boîte de dialogue footer. La propriété standardButtons de la boîte de dialogue est transmise à la propriété correspondante de la boîte à boutons. En outre, les signaux accepted() et rejected() de la boîte à boutons sont connectés aux signaux correspondants dans Dialog.
Dialog { id: dialog title: "Title" standardButtons: Dialog.Ok | Dialog.Cancel onAccepted: console.log("Ok clicked") onRejected: console.log("Cancel clicked") }
Dialogues modaux
Une boîte de dialogue modal bloque l'accès à d'autres contenus situés sous la boîte de dialogue. Lorsqu'une boîte de dialogue modale est ouverte, l'utilisateur doit finir d'interagir avec la boîte de dialogue et la fermer avant de pouvoir accéder à tout autre contenu dans la même fenêtre.
Dialog { id: dialog modal: true standardButtons: Dialog.Ok }
Dialogues sans modèle
Une boîte de dialogue sans modèle est une boîte de dialogue qui fonctionne indépendamment des autres contenus qui l'entourent. Lorsqu'une boîte de dialogue sans modèle est ouverte, l'utilisateur est autorisé à interagir à la fois avec la boîte de dialogue et avec le reste du contenu de la même fenêtre.
Dialog { id: dialog modal: false standardButtons: Dialog.Ok }
Voir également DialogButtonBox et Popup Controls.
Propriété Documentation
footer : Item |
Cette propriété contient l'élément de pied de page de la boîte de dialogue. L'élément de pied de page est positionné en bas et redimensionné en fonction de la largeur de la boîte de dialogue. La valeur par défaut est null.
Remarque : l'attribution d'un DialogButtonBox comme pied de page de la boîte de dialogue connecte automatiquement ses signaux accepted() et rejected() aux signaux respectifs de la boîte de dialogue.
Remarque : L'attribution d'une valeur DialogButtonBox, ToolBar ou TabBar en tant que pied de page de la boîte de dialogue définit automatiquement la propriété DialogButtonBox::position, ToolBar::position ou TabBar::position correspondante à Footer.
Voir aussi header.
header : Item |
Cette propriété contient l'élément d'en-tête de la boîte de dialogue. L'élément d'en-tête est positionné en haut et redimensionné en fonction de la largeur de la boîte de dialogue. La valeur par défaut est null.
Remarque : l'attribution d'un DialogButtonBox en tant qu'en-tête de dialogue connecte automatiquement ses signaux accepted() et rejected() aux signaux respectifs de Dialog.
Remarque : l'attribution d'un en-tête DialogButtonBox, ToolBar ou TabBar comme en-tête de boîte de dialogue définit automatiquement la propriété DialogButtonBox::position, ToolBar::position ou TabBar::position correspondante à Header.
Voir aussi footer.
implicitFooterHeight : real |
Cette propriété indique la hauteur implicite du pied de page.
La valeur est égale à footer && footer.visible ? footer.implicitHeight : 0.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir également implicitFooterWidth et implicitHeaderHeight.
implicitFooterWidth : real |
Cette propriété indique la largeur implicite du pied de page.
La valeur est égale à footer && footer.visible ? footer.implicitWidth : 0.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir également implicitFooterHeight et implicitHeaderWidth.
implicitHeaderHeight : real |
Cette propriété indique la hauteur implicite de l'en-tête.
La valeur est égale à header && header.visible ? header.implicitHeight : 0.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir également implicitHeaderWidth et implicitFooterHeight.
implicitHeaderWidth : real |
Cette propriété indique la largeur implicite de l'en-tête.
La valeur est égale à header && header.visible ? header.implicitWidth : 0.
Cette propriété a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).
Voir également implicitHeaderHeight et implicitFooterWidth.
result : int |
standardButtons : enumeration |
Cette propriété contient une combinaison de boutons standard utilisés par la boîte de dialogue.
Dialog { id: dialog title: "Title" standardButtons: Dialog.Ok | Dialog.Cancel onAccepted: console.log("Ok clicked") onRejected: console.log("Cancel clicked") }
Les boutons seront positionnés dans l'ordre approprié à la plate-forme de l'utilisateur.
Drapeaux possibles :
| Constante | Description |
|---|---|
Dialog.Ok | Un bouton "OK" défini avec la propriété AcceptRole. |
Dialog.Open | Un bouton "Ouvrir" défini avec le site AcceptRole. |
Dialog.Save | Un bouton "Save" défini à l'aide de la page AcceptRole. |
Dialog.Cancel | Un bouton "Annuler" défini à l'aide de l'adresse RejectRole. |
Dialog.Close | Un bouton "Fermer" défini à l'aide de l'adresse RejectRole. |
Dialog.Discard | Un bouton "Discard" ou "Don't Save", en fonction de la plateforme, défini à l'aide de l'adresse DestructiveRole. |
Dialog.Apply | Un bouton "Appliquer" défini à l'aide de l'adresse ApplyRole. |
Dialog.Reset | Un bouton "Reset" défini à l'aide de l'adresse ResetRole. |
Dialog.RestoreDefaults | Un bouton "Restore Defaults" défini à l'aide de l'adresse ResetRole. |
Dialog.Help | Un bouton "Help" défini à l'aide de l'adresse HelpRole. |
Dialog.SaveAll | Un bouton "Save All" défini à l'aide de l'adresse AcceptRole. |
Dialog.Yes | Un bouton "Oui" défini à l'aide de l'adresse YesRole. |
Dialog.YesToAll | Un bouton "Oui à tout" défini à l'aide de l'adresse YesRole. |
Dialog.No | Un bouton "Non" défini à l'aide de l'adresse NoRole. |
Dialog.NoToAll | Un bouton "Non à tous" défini à l'aide de l'adresse NoRole. |
Dialog.Abort | Un bouton "Abort" défini à l'aide de l'adresse RejectRole. |
Dialog.Retry | Un bouton "Retry" défini à l'aide de l'adresse AcceptRole. |
Dialog.Ignore | Un bouton "Ignorer" défini à l'aide de l'adresse AcceptRole. |
Dialog.NoButton | Un bouton invalide. |
Voir également DialogButtonBox.
title : string |
Signal Documentation
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() ou de la définition de visible à false.
Remarque : Le gestionnaire correspondant est onAccepted.
Voir aussi rejected().
|
|
|
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() ou lors de l'attribution de la valeur false à visible.
Remarque : Le gestionnaire correspondant est onRejected.
Voir aussi accepted().
|
Documentation de la méthode
void accept() |
|
void reject() |
|
Renvoie le standard spécifié button, ou null s'il n'existe pas.
Cette méthode a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).
Voir aussi standardButtons.
© 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.