En esta página

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:

QtObject

Inherited By:

ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog

Propiedades

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:

ConstanteDescripción
Qt.NonModalEl cuadro de diálogo no es modal y no bloquea la entrada a otras ventanas.
Qt.WindowModalEl 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.ApplicationModalEl 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:

ConstanteDescripción
Popup.ItemEl cuadro de diálogo aparecerá como un elemento dentro de la ventana del elemento padre más cercano.
Popup.WindowEl cuadro de diálogo aparecerá dentro de su propia ventana.
Popup.NativeEste 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:

ConstanteDescripció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.