Dialog QML Type
La clase base de los cuadros de diálogo nativos. Más...
| Import Statement: | import QtQuick.Dialogs |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog |
Propiedades
- data : list<QtObject>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- popupType : enumeration
(since 6.10) - result : int
- title : string
- visible : bool
Señales
Métodos
Descripción detallada
El tipo «Dialog» proporciona una API QML común para los cuadros de diálogo nativos de la plataforma. Para los cuadros de diálogo no nativos, consulta Dialog.
Para mostrar un cuadro de diálogo nativo, cree una instancia de una de las implementaciones concretas de «Dialog», establezca las propiedades deseadas y llame a open(). «Dialog» emite accepted() o rejected() cuando el usuario ha terminado con el cuadro de diálogo.
Nota: Se trata de un tipo interno que no se puede crear en QML.
Documentación de propiedades
data : list<QtObject> [default]
Esta propiedad predeterminada contiene la lista de todos los objetos declarados como elementos secundarios del cuadro de diálogo.
flags : Qt::WindowFlags
Esta propiedad contiene los indicadores de ventana del cuadro de diálogo. El valor por defecto es « Qt.Dialog ».
modality : Qt::WindowModality
Esta propiedad indica la modalidad del cuadro de diálogo. El valor por defecto es « Qt.WindowModal ».
Valores disponibles:
| Constante | Descripción |
|---|---|
Qt.NonModal | El cuadro de diálogo no es modal y no bloquea la entrada a otras ventanas. |
Qt.WindowModal | El cuadro de diálogo es modal respecto a una única jerarquía de ventanas y bloquea la entrada a su ventana principal, a todas las ventanas de nivel superior y a todas las ventanas del mismo nivel que su ventana principal y las de nivel superior. |
Qt.ApplicationModal | El cuadro de diálogo es modal respecto a la aplicación y bloquea la entrada a todas las ventanas. |
parentWindow : Window
Esta propiedad contiene la ventana principal del cuadro de diálogo.
A menos que se especifique explícitamente, la ventana se determina automáticamente iterando por los objetos padres de QML hasta que se encuentre un ` Window ` o un ` Item ` que tenga una ventana.
popupType : enumeration [since 6.10]
Esta propiedad se puede utilizar para cambiar el « popupType » del cuadro de diálogo rápido no nativo.
Los valores disponibles son:
| Constante | Descripción |
|---|---|
Popup.Item | El cuadro de diálogo aparecerá como un elemento dentro de la ventana del elemento padre más cercano. |
Popup.Window | El cuadro de diálogo aparecerá dentro de su propia ventana. |
Popup.Native | Este valor no es compatible. En su lugar, se utilizará « Popup.Window ».Nota: Esta propiedad no tiene ningún efecto cuando se utiliza un cuadro de diálogo nativo. |
Esta propiedad se introdujo en Qt 6.10.
result : int
Esta propiedad contiene el código de resultado.
Códigos de resultado estándar:
| Constante | Descripción |
|---|---|
Dialog.Accepted | |
Dialog.Rejected | Nota: « MessageDialog » establece el resultado en el valor del botón estándar en el que se ha hecho clic, en lugar de utilizar los códigos de resultado estándar. |
title : string
Esta propiedad contiene el título del cuadro de diálogo.
visible : bool
Esta propiedad determina la visibilidad del cuadro de diálogo. El valor por defecto es false.
Véase también open() y close().
Documentación de Signal
void accepted()
Esta señal se emite cuando se ha aceptado el cuadro de diálogo, ya sea de forma interactiva o llamando a la función ` accept()`.
Nota: El controlador correspondiente es onAccepted.
Véase también rejected().
void rejected()
Esta señal se emite cuando el cuadro de diálogo ha sido rechazado, ya sea de forma interactiva o al llamar a la función ` reject()`.
Esta señal también se emite al cerrar el cuadro de diálogo con close().
Nota: El controlador correspondiente es ` onRejected`.
Véase también accepted().
Documentación del método
void accept()
Cierra el cuadro de diálogo y emite la señal accepted().
Véase también reject().
void close()
Cierra el cuadro de diálogo y emite la señal « accepted()» o « rejected()».
Véase también visible y open().
void done(int result)
Cierra el cuadro de diálogo y establece el valor de « result ».
Véase también accept(), reject() y result.
void open()
Abre el cuadro de diálogo.
Véase también visible y close().
void reject()
Cierra el cuadro de diálogo y emite la señal rejected().
Véase también 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.