En esta página

Dialog QML Type

La clase base de los diálogos nativos. Más...

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. Desaconsejamos su uso en código nuevo.

Propiedades

Señales

Métodos

Descripción detallada

Utilice QtQuick.Dialogs Dialog en su lugar.

El tipo Dialog proporciona una API QML común para diálogos nativos de plataforma.

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: No se garantiza que los tipos de los módulos Qt.labs sigan siendo compatibles en futuras versiones.

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:

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

result : int

Esta propiedad contiene el código de resultado.

Códigos de resultado estándar:

ConstanteValor
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: Esta señal no se emite al cerrar el diálogo con close().

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, ya sea interactivamente o llamando a reject().

Nota: Esta señal no 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.

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.