FUNCIóNPublicado

MsgAlert

MsgAlert( <cTexto>, <cTitulo> ) --> Nil

Muestra un mensaje de alerta con título, icono visual y botón OK.

InterfazMensajeAlertaExperiencia de usuario

01 · DESCRIPCIÓN GENERAL

Descripción general

MsgAlert() presenta una ventana de alerta para comunicar una situación que requiere atención, pero no exige que el usuario elija entre alternativas. El botón OK se crea automáticamente y la ejecución continúa después de cerrar el mensaje.

02 · SINTAXIS

Sintaxis

MsgAlert( <cTexto>, <cTitulo> ) --> Nil

Parámetros

cTexto

CarácterObligatorio

Texto principal mostrado en el cuerpo del mensaje.

cTitulo

CarácterOpcional

Título de la ventana de alerta. Usa un texto corto que identifique el contexto del mensaje.

Retorno

Nil. La función solo muestra el mensaje y espera la confirmación del usuario.

03 · EJEMPLO PRÁCTICO

Alerta simple

#Include "TOTVS.ch"

User Function ExMsgAlert()
    MsgAlert("Mensaje de prueba", "Prueba de mensaje de alerta")
Return

Resultado esperado

Muestra una ventana de alerta con el texto informado y un botón OK.

04 · EJEMPLO PRÁCTICO

Validación con mensaje orientativo

#Include "TOTVS.ch"

User Function ExValidaMsg()
    Local nCantidad := 0

    If nCantidad <= 0
        MsgAlert("Informe una cantidad mayor que cero.", "Cantidad inválida")
    EndIf
Return

Resultado esperado

El mensaje explica el problema y orienta el siguiente paso del usuario.

BUENAS PRÁCTICAS

Usa MsgAlert() para alertas simples, objetivas y no destructivas.
Prefiere mensajes cortos, orientados a la acción y con contexto suficiente para que el usuario entienda el aviso.
Para información neutra, evalúa MsgInfo(); para errores o bloqueos, evalúa MsgStop(); para confirmación, evalúa MsgYesNo().

ERRORES COMUNES

Evita usar MsgAlert() dentro de bucles largos o procesamientos automáticos, porque interrumpe repetidamente la experiencia del usuario.
No utilices mensajes visuales en rutinas sin interfaz, jobs o puntos donde no exista interacción con SmartClient.
No sustituyas validaciones estructuradas por textos genéricos; el mensaje debe explicar qué ocurrió y, cuando sea posible, cómo corregirlo.

Contenido relacionado

REFERENCIAS

Sem Preju. Principales funciones de mensajes. Rafael Gonçalves, publicado el 5 mayo 2020.
Guía de referencia de eADVPL. Sin autor identificado, creada el 28 jul. 2005, p. 30. Referencia histórica complementaria.
Guía de referencia de eADVPL. Sin autor identificado, creada el 28 de julio de 2005. Sección relacionada: p. 30. Referencia histórica; sintaxis verificada prioritariamente con una fuente actual.

Estado: Publicado
Página creada el: 01/08/2026 às 16:19
Última revisión el: 02/08/2026 às 15:52
Idioma original: Portugués
Revisión: Usina.BR