cTextoCaractereObrigatório
Texto principal exibido no corpo da mensagem.
FUNçãOPublicado
MsgAlert
MsgAlert( <cTexto>, <cTitulo> ) --> NilExibe uma mensagem de alerta com título, ícone visual e botão OK.
Visão geral
MsgAlert() apresenta uma janela de alerta para comunicar ao usuário uma situação que exige atenção, mas não exige escolha entre alternativas. O botão OK é criado automaticamente e a execução continua após o fechamento da mensagem.
Sintaxe
MsgAlert( <cTexto>, <cTitulo> ) --> NilParâmetros
cTituloCaractereOpcional
Título da janela de alerta. Use um texto curto que indique o contexto da mensagem.
Retorno
Nil. A função apenas exibe a mensagem e aguarda a confirmação do usuário.
Alerta simples
#Include "TOTVS.ch"
User Function ExMsgAlert()
MsgAlert("Mensagem de teste", "Teste de mensagem de alerta")
ReturnResultado esperado
Exibe uma janela de alerta com o texto informado e um botão OK.
Validação com mensagem orientativa
#Include "TOTVS.ch"
User Function ExValidaMsg()
Local nQuantidade := 0
If nQuantidade <= 0
MsgAlert("Informe uma quantidade maior que zero.", "Quantidade inválida")
EndIf
ReturnResultado esperado
A mensagem explica o problema e orienta o próximo passo do usuário.
- Use MsgAlert() para alertas simples, objetivos e não destrutivos.
- Prefira mensagens curtas, orientadas à ação e com contexto suficiente para o usuário entender o motivo do aviso.
- Para informações neutras, avalie MsgInfo(); para erros ou bloqueios, avalie MsgStop(); para confirmação, avalie MsgYesNo().
- Evite usar MsgAlert() dentro de loops longos ou processamentos automáticos, pois isso interrompe a experiência do usuário repetidamente.
- Não utilize mensagens visuais em rotinas sem interface, jobs ou pontos onde não exista interação com SmartClient.
- Não substitua validações estruturadas por textos genéricos; a mensagem deve explicar o que ocorreu e, quando possível, como corrigir.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.