MessageDialog QML Type

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

Este tipo está obsoleto desde Qt.labs.platform 6.9. Desaconsejamos su uso en código nuevo.

• Lista de todos los miembros, incluyendo los heredados

Propiedades

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

Señales

• abortClicked()
• applyClicked()
• cancelClicked()
• clicked(button)
• closeClicked()
• discardClicked()
• helpClicked()
• ignoreClicked()
• noClicked()
• noToAllClicked()
• okClicked()
• openClicked()
• resetClicked()
• restoreDefaultsClicked()
• retryClicked()
• saveAllClicked()
• saveClicked()
• yesClicked()
• yesToAllClicked()

Descripción detallada

Utilice QtQuick.Dialogs MessageDialog en su lugar.

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

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 para hacer 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 mensaje de diálogo modal bloquea el resto de la GUI hasta que el mensaje es descartado.

Un enfoque más elaborado que simplemente alertar al usuario de un evento es también preguntarle 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. El orden de visualización de los botones depende de la plataforma.

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

    onAccepted: document.save()
}

La señal clicked() pasa la información de qué botón se ha pulsado.

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

• Android
• iOS
• macOS

El módulo Qt Labs Platform utiliza Qt Widgets como alternativa en plataformas que no disponen de una implementación nativa. Por lo tanto, las aplicaciones que utilizan tipos del módulo Qt Labs Platform deben enlazar con QtWidgets y utilizar QApplication en lugar de QGuiApplication.

Para enlazar con la biblioteca QtWidgets, añada lo siguiente al archivo de proyecto qmake:

QT += widgets

Crear una instancia de QApplication en main():

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Véase también QtQuick.Dialogs::MessageDialog.

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 clicked().

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

abortClicked()

Esta señal se emite cuando se hace clic en Abort.

applyClicked()

Esta señal se emite cuando se hace clic en Apply.

cancelClicked()

Esta señal se emite cuando se hace clic en Cancel.

clicked(button)

Esta señal se emite cuando se hace clic en un diálogo button.

Véase también buttons.

closeClicked()

Esta señal se emite cuando se hace clic en Close.

discardClicked()

Esta señal se emite cuando se hace clic en Discard.

helpClicked()

Esta señal se emite cuando se hace clic en Help.

ignoreClicked()

Esta señal se emite cuando se hace clic en Ignore.

noClicked()

Esta señal se emite cuando se hace clic en No.

noToAllClicked()

Esta señal se emite cuando se hace clic en No To All.

okClicked()

Esta señal se emite cuando se hace clic en Ok.

openClicked()

Esta señal se emite cuando se hace clic en Open.

resetClicked()

Esta señal se emite cuando se hace clic en Reset.

restoreDefaultsClicked()

Esta señal se emite cuando se hace clic en Restore Defaults.

retryClicked()

Esta señal se emite cuando se hace clic en Retry.

saveAllClicked()

Esta señal se emite cuando se hace clic en Save All.

saveClicked()

Esta señal se emite cuando se hace clic en Save.

yesClicked()

Esta señal se emite cuando se hace clic en Yes.

yesToAllClicked()

Esta señal se emite cuando se hace clic en Yes To All.