DialogButtonBox QML Type

Botonera utilizada en los diálogos. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• alignment : flags
• buttonLayout : enumeration (since QtQuick.Controls 2.5 (Qt 5.12))
• defaultButton : AbstractButton (since 6.11)
• defaultStandardButton : enumeration (since 6.11)
• delegate : Component
• position : enumeration
• standardButtons : enumeration

Propiedades anexas

• buttonBox : DialogButtonBox
• buttonRole : enumeration

Señales

• accepted()
• applied() (since QtQuick.Controls 2.3 (Qt 5.10))
• clicked(AbstractButton button)
• discarded() (since QtQuick.Controls 2.3 (Qt 5.10))
• helpRequested()
• rejected()
• reset() (since QtQuick.Controls 2.3 (Qt 5.10))

Métodos

• AbstractButton standardButton(StandardButton button)

Descripción detallada

Los cuadros de diálogo y de mensajes suelen presentar los botones en un orden que se ajusta a las directrices de la interfaz para esa plataforma. Invariablemente, diferentes plataformas tienen sus botones de diálogo en diferentes órdenes. DialogButtonBox permite a un desarrollador añadirle botones y utilizará automáticamente el orden apropiado para la plataforma del usuario.

La mayoría de los botones de un diálogo siguen ciertos roles. Tales roles incluyen:

• Aceptar o rechazar el diálogo.
• Pedir ayuda.
• Realizar acciones en el propio diálogo (como restablecer campos o aplicar cambios).

También puede haber formas alternativas de rechazar el diálogo que pueden causar resultados destructivos.

La mayoría de los cuadros de diálogo tienen botones que casi pueden considerarse estándar (por ejemplo, los botones OK y Cancel ). A veces es conveniente crear estos botones de forma estándar.

Hay un par de maneras de usar DialogButtonBox. Una forma es especificar los botones estándar (por ejemplo, OK, Cancel, Save) y dejar que la caja de botones configure los botones.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

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

Alternativamente, los botones y sus roles pueden ser especificados a mano:

DialogButtonBox {
    Button {
        text: qsTr("Save")
        DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole
    }
    Button {
        text: qsTr("Close")
        DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole
    }
}

También se pueden mezclar y combinar botones normales y botones estándar.

Cuando se pulsa un botón en la caja de botones, se emite la señal clicked() para el botón real que se pulsa. Además, las siguientes señales se emiten automáticamente cuando se pulsa un botón con el rol o roles respectivos:

Véase también Dialog.

Documentación de propiedades

alignment : flags

Esta propiedad contiene la alineación de los botones.

Valores posibles:

Por defecto, no se establece ninguna alineación específica; la lectura de la propiedad alignment arroja un valor de bandera por defecto que se compara igual a 0. La propiedad puede restablecerse a este valor asignándole undefined. En este caso, los botones se redimensionan para ocupar el espacio disponible.

buttonLayout : enumeration [since QtQuick.Controls 2.5 (Qt 5.12)]

Esta propiedad contiene la política de disposición de botones que se utilizará al organizar los botones contenidos en la caja de botones. El valor por defecto es específico de la plataforma.

Valores disponibles:

Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).

defaultButton : AbstractButton [since 6.11]

Esta propiedad contiene el botón por defecto.

El botón por defecto será highlighted y recibirá el foco.

Sólo puede haber un botón por defecto en la caja de botones. Esta propiedad no puede utilizarse junto con la propiedad defaultStandardButton.

Esta propiedad se introdujo en Qt 6.11.

Ver también standardButtons y defaultStandardButton.

defaultStandardButton : enumeration [since 6.11]

Esta propiedad contiene el botón estándar por defecto.

El botón estándar por defecto será highlighted y recibirá el foco.

Sólo un botón de la caja de botones puede ser predeterminado. Esta propiedad no puede utilizarse junto con la propiedad defaultButton.

Esta propiedad se introdujo en Qt 6.11.

Ver también standardButtons y defaultButton.

delegate : Component

Esta propiedad contiene un delegado para crear botones estándar.

DialogButtonBox no se apropia del delegado.

Véase también standardButtons.

position : enumeration

Esta propiedad contiene la posición de la caja de botones.

Valores posibles:

El valor por defecto es Footer.

Véase también Dialog::header y Dialog::footer.

standardButtons : enumeration

Esta propiedad contiene una combinación de botones estándar que son utilizados por la caja de botones.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.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 standardButton().

Documentación de propiedades adjuntas

DialogButtonBox.buttonBox : DialogButtonBox [read-only]

Esta propiedad adjunta contiene la caja de botones que gestiona este botón, o null si el botón no está en una caja de botones.

DialogButtonBox.buttonRole : enumeration

Esta propiedad adjunta contiene el rol de cada botón en una caja de botones.

DialogButtonBox {
    Button {
        text: qsTr("Save")
        DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole
    }
    Button {
        text: qsTr("Close")
        DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole
    }
}

Valores disponibles:

Documentación de señales

accepted()

Esta señal se emite cuando se pulsa un botón definido con las etiquetas AcceptRole o YesRole.

Véase también rejected(), clicked(), y helpRequested().

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

Esta señal se emite cuando se pulsa un botón definido con ApplyRole.

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

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

clicked(AbstractButton button)

Esta señal se emite cuando se pulsa un button dentro de la caja de botones.

Véase también accepted(), rejected(), y helpRequested().

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

Esta señal se emite cuando se pulsa un botón definido con DiscardRole.

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

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

helpRequested()

Esta señal se emite cuando se pulsa un botón definido con HelpRole.

Véase también accepted(), rejected(), y clicked().

rejected()

Esta señal se emite cuando se pulsa un botón definido con las etiquetas RejectRole o NoRole.

Véase también accepted(), helpRequested(), y clicked().

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

Esta señal se emite cuando se pulsa un botón definido con ResetRole.

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

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

Documentación del Método

AbstractButton standardButton(StandardButton button)

Devuelve la norma especificada button, o null si no existe.

Véase también standardButtons.