En esta página

MessageDialog QML Type

Un cuadro de diálogo de mensaje. Más...

Import Statement: import QtQuick.Dialogs
Since: Qt 6.3
Inherits:

Dialog

Propiedades

Señales

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

Descripción detallada

El tipo MessageDialog proporciona una API de QML para los cuadros de diálogo de mensajes.

El cuadro de diálogo de mensaje proporciona cierta información al usuario y se cerrará cuando este confirme el cuadro de diálogo.

Un cuadro de diálogo de mensaje se utiliza para informar al usuario o para plantearle una pregunta. Un cuadro de diálogo de mensaje muestra un cuadro de mensaje principal ( text ) para alertar al usuario de una situación, un cuadro de mensaje secundario ( informative text ) para explicar con más detalle la alerta o para hacer una pregunta al usuario, y un cuadro de información ( 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 campos de entrada ( buttons ) para aceptar la respuesta del usuario.

Para mostrar un cuadro de diálogo de mensaje, se debe crear una instancia de MessageDialog, establecer las propiedades deseadas y llamar a la función open().

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

El usuario debe hacer clic en el botón « OK » para cerrar el cuadro de diálogo de mensaje.

Un enfoque más elaborado que el de limitarse a alertar al usuario de un evento consiste en preguntarle también qué desea hacer al respecto. Almacene la pregunta en la propiedad « informative text » y especifique en la propiedad « buttons » el conjunto de botones que desee como conjunto de respuestas del usuario. Los botones se especifican combinando valores mediante el operador OR bit a bit.

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

    onAccepted: document.save()
}

El cuadro de diálogo de mensajes permite al usuario tomar una decisión en función del mensaje y ejecutará la acción asociada según la propiedad de los botones.

Disponibilidad

Actualmente, el cuadro de diálogo de mensajes nativo de la plataforma está disponible en las siguientes plataformas:

  • Android
  • iOS
  • macOS

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

Documentación de propiedades

buttons : flags

Esta propiedad contiene una combinación de botones que utiliza el cuadro de diálogo de mensajes. El valor por defecto es « MessageDialog.NoButton ».

Posibles indicadores:

ConstanteDescripción
MessageDialog.OkUn botón «Aceptar» definido con la opción AcceptRole.
MessageDialog.OpenUn botón «Abrir» definido con la propiedad « AcceptRole ».
MessageDialog.SaveUn botón «Guardar» definido con el AcceptRole.
MessageDialog.CancelUn botón «Cancelar» definido con la función RejectRole.
MessageDialog.CloseUn botón «Cerrar» definido con la función ` RejectRole`.
MessageDialog.DiscardUn botón «Descartar» o «No guardar», según la plataforma, definido con DestructiveRole.
MessageDialog.ApplyUn botón «Aplicar» definido con la propiedad ApplyRole.
MessageDialog.ResetUn botón «Restablecer» definido con ResetRole.
MessageDialog.RestoreDefaultsUn botón «Restablecer valores predeterminados» definido con la propiedad ` ResetRole`.
MessageDialog.HelpUn botón «Ayuda» definido mediante el HelpRole.
MessageDialog.SaveAllUn botón «Guardar todo» definido con la función AcceptRole.
MessageDialog.YesUn botón «Sí» definido con el YesRole.
MessageDialog.YesToAllUn botón «Sí a todo» definido con el YesRole.
MessageDialog.NoUn botón «No» definido con el NoRole.
MessageDialog.NoToAllUn botón «No a todo» definido con el NoRole.
MessageDialog.AbortUn botón «Abortar» definido con el RejectRole.
MessageDialog.RetryUn botón «Reintentar» definido con el AcceptRole.
MessageDialog.IgnoreUn botón «Ignorar» definido con la función AcceptRole.
MessageDialog.NoButtonEl cuadro de diálogo no tiene botones.

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 ofrece una descripción más detallada del mensaje.

El texto informativo se puede utilizar para ampliar el « 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 cuadro de diálogo de mensaje.

Véase también informativeText y detailedText.

Documentación de Signal

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

Esta señal se emite cuando se hace clic en un « button » con el « role » especificado.

Al asignar un controlador a esta señal, puedes 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 la función de dicho 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;
        }
    }
}

Nota: El controlador correspondiente es onButtonClicked.

Véase también buttons.

© 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.