Dialog QML Type
Cuadro de diálogo emergente con botones estándar y un título, que se utiliza para la interacción a corto plazo con el usuario. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- footer : Item
- header : Item
- implicitFooterHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitFooterWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitHeaderHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitHeaderWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - result : int
(since QtQuick.Controls 2.3 (Qt 5.10)) - standardButtons : enumeration
- title : string
Señales
- accepted()
- applied()
(since QtQuick.Controls 2.3 (Qt 5.10)) - discarded()
(since QtQuick.Controls 2.3 (Qt 5.10)) - helpRequested()
(since QtQuick.Controls 2.3 (Qt 5.10)) - rejected()
- reset()
(since QtQuick.Controls 2.3 (Qt 5.10))
Métodos
- void accept()
- void done(int result)
(since QtQuick.Controls 2.3 (Qt 5.10)) - void reject()
- AbstractButton standardButton(StandardButton button)
(since QtQuick.Controls 2.3 (Qt 5.10))
Descripción detallada
Un cuadro de diálogo es una ventana emergente que se utiliza principalmente para tareas de corta duración y comunicaciones breves con el usuario. Al igual que ApplicationWindow y Page, el cuadro de diálogo se organiza en tres secciones: header, contentItem y footer.

Las propiedades de padding solo afectan al contentItem. Utiliza la propiedad spacing para ajustar el espacio entre el encabezado, el contentItem y el pie de página.
De forma predeterminada, los cuadros de diálogo tienen focus.
Título y botones del cuadro de diálogo
El « title » del cuadro de diálogo se muestra mediante una barra de título con un estilo específico que, por defecto, se asigna como « header » del cuadro de diálogo.
Los botones estándar del cuadro de diálogo se gestionan mediante un « DialogButtonBox » que, por defecto, se asigna como « footer » del cuadro de diálogo. La propiedad « standardButtons » del cuadro de diálogo se reenvía a la propiedad correspondiente del cuadro de botones. Además, las señales « accepted()» y « rejected()» del cuadro de botones están conectadas a las señales correspondientes en el cuadro de diálogo.
Dialog {
id: dialog
title: "Title"
standardButtons: Dialog.Ok | Dialog.Cancel
onAccepted: console.log("Ok clicked")
onRejected: console.log("Cancel clicked")
}Cuadros de diálogo modales
Un cuadro de diálogo « modal » bloquea la entrada a otros contenidos situados debajo del cuadro de diálogo. Cuando se abre un cuadro de diálogo modal, el usuario debe finalizar su interacción con el cuadro de diálogo y cerrarlo antes de poder acceder a cualquier otro contenido de la misma ventana.
Dialog {
id: dialog
modal: true
standardButtons: Dialog.Ok
}Cuadros de diálogo no modales
Un cuadro de diálogo no modal es aquel que funciona de forma independiente del resto del contenido que lo rodea. Cuando se abre un cuadro de diálogo no modal, el usuario puede interactuar tanto con el cuadro de diálogo como con el resto del contenido de la misma ventana.
Dialog {
id: dialog
modal: false
standardButtons: Dialog.Ok
}Véase también « DialogButtonBox » y «Controles emergentes».
Documentación de propiedades
footer : Item
Esta propiedad contiene el elemento del pie de página del cuadro de diálogo. El elemento del pie de página se sitúa en la parte inferior y se ajusta al ancho del cuadro de diálogo. El valor por defecto es null.
Nota: Al asignar un « DialogButtonBox » como pie de página del cuadro de diálogo, sus señales « accepted()» y « rejected()» se conectan automáticamente a las señales correspondientes de «Dialog».
Nota: Al asignar un ` DialogButtonBox`, ` ToolBar` o ` TabBar ` como pie de página del cuadro de diálogo, se establece automáticamente la propiedad correspondiente ` DialogButtonBox::position`, ` ToolBar::position` o ` TabBar::position ` en ` Footer`.
Véase también header.
header : Item
Esta propiedad contiene el elemento de cabecera del cuadro de diálogo. El elemento de cabecera se coloca en la parte superior y se redimensiona al ancho del cuadro de diálogo. El valor por defecto es null.
Nota: Al asignar un « DialogButtonBox » como encabezado del cuadro de diálogo, sus señales « accepted()» y « rejected()» se conectan automáticamente a las señales respectivas de «Dialog».
Nota: Al asignar un ` DialogButtonBox`, ` ToolBar` o ` TabBar ` como encabezado del cuadro de diálogo, se establece automáticamente la propiedad correspondiente ` DialogButtonBox::position`, ` ToolBar::position` o ` TabBar::position ` en ` Header`.
Véase también footer.
implicitFooterHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene la altura implícita del pie de página.
El valor es igual a ` footer && footer.visible ? footer.implicitHeight : 0`.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitFooterWidth y implicitHeaderHeight.
implicitFooterWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene el ancho implícito del pie de página.
El valor es igual a ` footer && footer.visible ? footer.implicitWidth : 0`.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitFooterHeight y implicitHeaderWidth.
implicitHeaderHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene la altura implícita del encabezado.
El valor es igual a ` header && header.visible ? header.implicitHeight : 0`.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitHeaderWidth y implicitFooterHeight.
implicitHeaderWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene el ancho implícito del encabezado.
El valor es igual a header && header.visible ? header.implicitWidth : 0.
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitHeaderHeight y implicitFooterWidth.
result : int [since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad contiene el código de resultado.
Códigos de resultado estándar:
| Constante | Descripción |
|---|---|
Dialog.Accepted | Se ha aceptado el cuadro de diálogo. |
Dialog.Rejected | El cuadro de diálogo fue rechazado. |
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también accept(), reject() y done().
standardButtons : enumeration
Esta propiedad contiene una combinación de botones estándar que utiliza el cuadro de diálogo.
Dialog {
id: dialog
title: "Title"
standardButtons: Dialog.Ok | Dialog.Cancel
onAccepted: console.log("Ok clicked")
onRejected: console.log("Cancel clicked")
}Los botones se colocarán en el orden adecuado para la plataforma del usuario.
Posibles indicadores:
| Constante | Descripción |
|---|---|
Dialog.Ok | Un botón «Aceptar» definido con la propiedad « AcceptRole ». |
Dialog.Open | Un botón «Abrir» definido con la función ` AcceptRole`. |
Dialog.Save | Un botón «Guardar» definido con la función ` AcceptRole`. |
Dialog.Cancel | Un botón «Cancelar» definido con el RejectRole. |
Dialog.Close | Un botón «Cerrar» definido con la función ` RejectRole`. |
Dialog.Discard | Un botón «Descartar» o «No guardar», según la plataforma, definido con el DestructiveRole. |
Dialog.Apply | Un botón «Aplicar» definido con la función ` ApplyRole`. |
Dialog.Reset | Un botón «Restablecer» definido con la propiedad ` ResetRole`. |
Dialog.RestoreDefaults | Un botón «Restablecer valores predeterminados» definido con ResetRole. |
Dialog.Help | Un botón «Ayuda» definido con el HelpRole. |
Dialog.SaveAll | Un botón «Guardar todo» definido con el AcceptRole. |
Dialog.Yes | Un botón «Sí» definido con el YesRole. |
Dialog.YesToAll | Un botón «Sí a todo» definido con YesRole. |
Dialog.No | Un botón «No» definido con la función NoRole. |
Dialog.NoToAll | Un botón «No a todo» definido con el NoRole. |
Dialog.Abort | Un botón «Abortar» definido con RejectRole. |
Dialog.Retry | Un botón «Reintentar» definido con el AcceptRole. |
Dialog.Ignore | Un botón «Ignorar» definido con la función AcceptRole. |
Dialog.NoButton | Un botón no válido. |
Véase también DialogButtonBox.
title : string
Esta propiedad contiene el título del cuadro de diálogo.
El título se muestra en el encabezado del cuadro de diálogo.
Documentación de Signal
accepted()
Esta señal se emite cuando se ha aceptado el cuadro de diálogo, ya sea de forma interactiva o llamando a ` accept()`.
Nota: Esta señal no se emite al cerrar el cuadro de diálogo con ` close()` ni al establecer ` visible ` en ` false`.
Nota: El controlador correspondiente es onAccepted.
Véase también rejected().
[since QtQuick.Controls 2.3 (Qt 5.10)] applied()
Esta señal se emite al hacer clic en el botón estándar « Dialog.Apply ».
Nota: El controlador correspondiente es onApplied.
Esta señal se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también « discarded()» y « reset()».
[since QtQuick.Controls 2.3 (Qt 5.10)] discarded()
Esta señal se emite al hacer clic en el botón estándar « Dialog.Discard ».
Nota: El controlador correspondiente es ` onDiscarded`.
Esta señal se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también « reset()» y « applied()».
[since QtQuick.Controls 2.3 (Qt 5.10)] helpRequested()
Esta señal se emite al hacer clic en el botón estándar « Dialog.Help ».
Nota: El controlador correspondiente es onHelpRequested.
Esta señal se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también « accepted()» y « rejected()».
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()` ni al establecer ` visible ` en ` false`.
Nota: El controlador correspondiente es onRejected.
Véase también accepted().
[since QtQuick.Controls 2.3 (Qt 5.10)] reset()
Esta señal se emite al hacer clic en el botón estándar « Dialog.Reset ».
Nota: El controlador correspondiente es onReset.
Esta señal se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también discarded() y applied().
Documentación del método
void accept()
Emite la señal accepted() y cierra el cuadro de diálogo.
Véase también reject() y done().
[since QtQuick.Controls 2.3 (Qt 5.10)] void done(int result)
- Establece el valor de ` result`.
- Emite accepted() o rejected() dependiendo de si el resultado es
Dialog.AcceptedoDialog.Rejected, respectivamente. - Emite closed().
Este método se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también accept(), reject() y result.
void reject()
Emite la señal « rejected()» y cierra el cuadro de diálogo.
Véanse también accept() y done().
[since QtQuick.Controls 2.3 (Qt 5.10)] AbstractButton standardButton(StandardButton button)
Devuelve el archivo estándar especificado « button » o « null » si no existe.
Este método se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también standardButtons.
© 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.