En esta página

Dialog QML Type

La clase base de los cuadros de diálogo nativos. Más información...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

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

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:

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 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:

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: 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.