Dialog QML Type
La clase base de los diálogos 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 diálogos de plataforma nativa. Para el diálogo no nativo, véase Dialog.
Para mostrar un diálogo nativo, construye una instancia de una de las implementaciones concretas de Dialog, establece las propiedades deseadas y llama a open(). Dialog emite accepted() o rejected() cuando el usuario ha terminado con el diálogo.
Nota: Este es un tipo interno que no puede ser creado en QML.
Documentación de propiedades
data : list<QtObject> [default]
Esta propiedad por defecto contiene la lista de todos los objetos declarados como hijos del diálogo.
flags : Qt::WindowFlags
Esta propiedad contiene las banderas de ventana del diálogo. El valor por defecto es Qt.Dialog.
modality : Qt::WindowModality
Esta propiedad contiene la modalidad del diálogo. El valor por defecto es Qt.WindowModal.
Valores disponibles:
| Constante | Descripción |
|---|---|
Qt.NonModal | El diálogo no es modal y no bloquea la entrada a otras ventanas. |
Qt.WindowModal | El diálogo es modal para una única jerarquía de ventanas y bloquea la entrada a su ventana padre, a todas las ventanas abuelas y a todos los hermanos de sus ventanas padre y abuelas. |
Qt.ApplicationModal | El diálogo es modal para la aplicación y bloquea la entrada a todas las ventanas. |
parentWindow : Window
Esta propiedad contiene la ventana padre del diálogo.
A menos que se establezca explícitamente, la ventana se resuelve automáticamente iterando los objetos QML padre hasta encontrar un Window o un Item que tenga una ventana.
popupType : enumeration [since 6.10]
Esta propiedad permite cambiar la dirección popupType del diálogo rápido no nativo.
Los valores disponibles son:
| Constante | Descripción |
|---|---|
Popup.Item | El diálogo aparecerá como un elemento en la ventana del elemento padre más cercano. |
Popup.Window | El diálogo aparecerá dentro de su propia ventana. |
Popup.Native | Este valor no está soportado. En su lugar se utilizará Popup.Window. |
Nota: Esta propiedad no tiene efecto cuando se utiliza un 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 | Valor |
|---|---|
Dialog.Accepted | |
Dialog.Rejected |
Nota: MessageDialog establece el resultado al valor del botón estándar pulsado en lugar de utilizar los códigos de resultado estándar.
title : string
Esta propiedad contiene el título del diálogo.
visible : bool
Esta propiedad contiene la visibilidad del diálogo. El valor por defecto es false.
Véase también open() y close().
Documentación de señales
void accepted()
Esta señal se emite cuando el diálogo ha sido aceptado, ya sea interactivamente o llamando a accept().
Nota: El manejador correspondiente es onAccepted.
Véase también rejected().
void rejected()
Esta señal se emite cuando el diálogo ha sido rechazado interactivamente o llamando a reject().
Esta señal también se emite al cerrar el diálogo con close().
Nota: El manejador correspondiente es onRejected.
Véase también accepted().
Documentación del método
void accept()
Cierra el diálogo y emite la señal accepted().
Véase también reject().
void close()
Cierra el 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 result.
Véase también accept(), reject() y result.
void open()
Abre el diálogo.
Véase también visible y close().
void reject()
Cierra el 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.
