Dialog QML Type

Cuadro de diálogo emergente con botones estándar y un título, utilizado para la interacción a corto plazo con el usuario. Más...

• Lista de todos los miembros, incluidos los heredados

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 diálogo es una ventana emergente utilizada principalmente para tareas de corta duración y comunicaciones breves con el usuario. De forma similar a ApplicationWindow y Page, Dialog está organizado en tres secciones: header, contentItem, y footer.

Las propiedades padding sólo afectan al contentItem. Utilice la propiedad spacing para afectar al espacio entre cabecera, contentItem y pie de página.

Por defecto, los Diálogos tienen focus.

Título y botones del diálogo

El diálogo title se muestra mediante una barra de título de estilo específico que se asigna como un diálogo header por defecto.

Los botones estándar del diálogo se gestionan mediante un DialogButtonBox que se asigna como diálogo footer por defecto. La propiedad standardButtons del diálogo se reenvía a la propiedad correspondiente de la caja de botones. Además, las señales accepted() y rejected() de la caja de botones se conectan a las señales respectivas de Dialog.

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

Diálogos modales

Un diálogo modal bloquea la entrada a otros contenidos situados debajo del diálogo. Cuando se abre un diálogo modal, el usuario debe terminar de interactuar con el diálogo y cerrarlo antes de poder acceder a cualquier otro contenido en la misma ventana.

Dialog {
    id: dialog
    modal: true
    standardButtons: Dialog.Ok
}

Diálogos sin modelo

Un cuadro de diálogo sin modelo es un cuadro de diálogo que funciona independientemente del resto del contenido que lo rodea. Cuando se abre un cuadro de diálogo sin modelo, 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 de pie de página del diálogo. El elemento de pie de página se posiciona en la parte inferior y se redimensiona a la anchura del diálogo. El valor por defecto es null.

Véase también header.

header : Item

Esta propiedad contiene el elemento de cabecera del diálogo. El elemento de cabecera se posiciona en la parte superior, y se redimensiona a la anchura del diálogo. El valor por defecto es null.

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 de la cabecera.

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 de la cabecera.

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:

Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Ver también accept(), reject(), y done().

standardButtons : enumeration

Esta propiedad contiene una combinación de botones estándar que son utilizados por el 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 apropiado para la plataforma del usuario.

Posibles banderas:

Véase también DialogButtonBox.

title : string

Esta propiedad contiene el título del diálogo.

El título se muestra en la cabecera del diálogo.

Dialog {
    title: qsTr("About")

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

Documentación de la señal

accepted()

Esta señal se emite cuando el diálogo ha sido aceptado, ya sea interactivamente o llamando a accept().

Véase también rejected().

[since QtQuick.Controls 2.3 (Qt 5.10)] applied()

Esta señal se emite cuando se pulsa el botón estándar Dialog.Apply.

Esta señal se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Ver también discarded() y reset().

[since QtQuick.Controls 2.3 (Qt 5.10)] discarded()

Esta señal se emite cuando se pulsa el botón estándar Dialog.Discard.

Esta señal se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Ver también reset() y applied().

[since QtQuick.Controls 2.3 (Qt 5.10)] helpRequested()

Esta señal se emite cuando se pulsa el botón estándar Dialog.Help.

Esta señal se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Ver también accepted() y rejected().

rejected()

Esta señal se emite cuando el diálogo ha sido rechazado, ya sea interactivamente o llamando a reject().

Véase también accepted().

[since QtQuick.Controls 2.3 (Qt 5.10)] reset()

Esta señal se emite cuando se pulsa el botón estándar Dialog.Reset.

Esta señal se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Ver también discarded() y applied().

Documentación del Método

void accept()

Emite la señal accepted() y cierra el diálogo.

Véase también reject() y done().

[since QtQuick.Controls 2.3 (Qt 5.10)] void done(int result)

1. Establece el 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).

Ver también accept(), reject(), y result.

void reject()

Emite la señal rejected() y cierra el diálogo.

Véase también accept() y done().

[since QtQuick.Controls 2.3 (Qt 5.10)] AbstractButton standardButton(StandardButton button)

Devuelve el 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.