En esta página

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:

Popup

Propiedades

Señales

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.

Esquema de página con cabecera, área de contenido y pie de página

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")
}

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

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:

ConstanteDescripción
Dialog.AcceptedSe ha aceptado el cuadro de diálogo.
Dialog.RejectedEl 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:

ConstanteDescripción
Dialog.OkUn botón «Aceptar» definido con la propiedad « AcceptRole ».
Dialog.OpenUn botón «Abrir» definido con la función ` AcceptRole`.
Dialog.SaveUn botón «Guardar» definido con la función ` AcceptRole`.
Dialog.CancelUn botón «Cancelar» definido con el RejectRole.
Dialog.CloseUn botón «Cerrar» definido con la función ` RejectRole`.
Dialog.DiscardUn botón «Descartar» o «No guardar», según la plataforma, definido con el DestructiveRole.
Dialog.ApplyUn botón «Aplicar» definido con la función ` ApplyRole`.
Dialog.ResetUn botón «Restablecer» definido con la propiedad ` ResetRole`.
Dialog.RestoreDefaultsUn botón «Restablecer valores predeterminados» definido con ResetRole.
Dialog.HelpUn botón «Ayuda» definido con el HelpRole.
Dialog.SaveAllUn botón «Guardar todo» definido con el AcceptRole.
Dialog.YesUn botón «Sí» definido con el YesRole.
Dialog.YesToAllUn botón «Sí a todo» definido con YesRole.
Dialog.NoUn botón «No» definido con la función NoRole.
Dialog.NoToAllUn botón «No a todo» definido con el NoRole.
Dialog.AbortUn botón «Abortar» definido con RejectRole.
Dialog.RetryUn botón «Reintentar» definido con el AcceptRole.
Dialog.IgnoreUn botón «Ignorar» definido con la función AcceptRole.
Dialog.NoButtonUn 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.

Dialog {
    title: qsTr("About")

    Label {
        text: "Lorem ipsum..."
    }
}

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)

  1. Establece el valor de ` result`.
  2. Emite accepted() o rejected() dependiendo de si el resultado es Dialog.Accepted o Dialog.Rejected, respectivamente.
  3. 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.