Dialog QML Type
La clase base de los cuadros de diálogo nativos. Más información...
| Import Statement: | import Qt.labs.platform |
| Inherits: | |
| Inherited By: | ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog |
| Status: | Deprecated since 6.11 |
Este tipo está obsoleto desde Qt Labs Platform 6.11. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- data : list<QtObject>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- result : int
- title : string
- visible : bool
Señales
Métodos
Descripción detallada
Utiliza en su lugar ` QtQuick.Dialogs Dialog `.
El tipo `Dialog` proporciona una API QML común para los cuadros de diálogo nativos de la plataforma.
Para mostrar un cuadro de diálogo nativo, crea una instancia de una de las implementaciones concretas de `Dialog`, configura las propiedades deseadas y llama a ` open()`. `Dialog` emite ` accepted()` o ` rejected()` cuando el usuario ha terminado con el cuadro de diálogo.
Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.
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 con 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 encuentra un ` Window ` o un ` Item ` que tenga una ventana.
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: Esta señal no se emite al cerrar el cuadro de diálogo con close().
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()`.
Nota: Esta señal no 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.
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.