MessageDialog QML Type

Un diálogo de mensajes. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• buttons : flags
• detailedText : string
• informativeText : string
• text : string

Señales

• buttonClicked(QPlatformDialogHelper::StandardButton button, QPlatformDialogHelper::ButtonRole role)

Descripción detallada

El tipo MessageDialog proporciona una API QML para diálogos de mensajes.

Un diálogo de mensaje se utiliza para informar al usuario o hacerle una pregunta. Un cuadro de diálogo de mensaje muestra un text primario para alertar al usuario de una situación, un informative text para explicar con más detalle la alerta o formular una pregunta al usuario, y un detailed text opcional para proporcionar aún más datos si el usuario lo solicita. Un cuadro de mensaje también puede mostrar un conjunto configurable de buttons para aceptar una respuesta del usuario.

Para mostrar un cuadro de diálogo de mensaje, construya una instancia de MessageDialog, configure las propiedades deseadas y llame a open().

MessageDialog {
    buttons: MessageDialog.Ok
    text: "The document has been modified."
}

El usuario debe hacer clic en el botón OK para descartar el diálogo de mensaje.

Un enfoque más elaborado que simplemente alertar al usuario de un evento es también preguntar al usuario qué hacer al respecto. Guarde la pregunta en la propiedad informative text, y especifique en la propiedad buttons el conjunto de botones que desea como conjunto de respuestas del usuario. Los botones se especifican combinando valores mediante el operador bitwise OR.

MessageDialog {
    text: "The document has been modified."
    informativeText: "Do you want to save your changes?"
    buttons: MessageDialog.Ok | MessageDialog.Cancel

    onAccepted: document.save()
}

Disponibilidad

Un diálogo de mensajes nativo de la plataforma está actualmente disponible en las siguientes plataformas:

• Android
• iOS
• macOS

Qt Quick Dialogs utiliza una implementación de Qt Quick como alternativa en plataformas que no disponen de una implementación nativa.

Documentación de propiedades

buttons : flags

Esta propiedad contiene una combinación de botones que son utilizados por el diálogo de mensajes. El valor por defecto es MessageDialog.NoButton.

Posibles banderas:

Véase también buttonClicked().

detailedText : string

Esta propiedad contiene el texto que se mostrará en el área de detalles.

Véase también text y informativeText.

informativeText : string

Esta propiedad contiene el texto informativo que proporciona una descripción más completa del mensaje.

El texto informativo puede utilizarse para ampliar la información de text y ofrecer más información al usuario.

Véase también text y detailedText.

text : string

Esta propiedad contiene el texto que se mostrará en el diálogo de mensajes.

Véase también informativeText y detailedText.

Documentación sobre señales

buttonClicked(QPlatformDialogHelper::StandardButton button, QPlatformDialogHelper::ButtonRole role)

Esta señal se emite cuando se pulsa un button con el role especificado.

Si asigna a esta señal un controlador, puede responder a la pulsación de cualquier botón personalizado. El argumento button indica qué botón se ha pulsado, mientras que el argumento role indica el papel funcional de ese botón.

MessageDialog {
    id: dialog
    text: qsTr("The document has been modified.")
    informativeText: qsTr("Do you want to save your changes?")
    buttons: MessageDialog.Ok | MessageDialog.Cancel
    onButtonClicked: function (button, role) {
        switch (button) {
        case MessageDialog.Ok:
            document.save()
            break;
        }
    }
}

Véase también buttons.