Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

APMsgAlert

APMsgAlert( <cMsg>, [cTitulo] ) --> Nil

Exibe um diálogo de alerta.

APMsgAlertAdvPL
01 · VISÃO GERAL

Visão geral

O manual histórico descreve APMsgAlert como diálogo de alerta, com mensagem e título opcional. A chamada informa o usuário; não executa rollback nem interrompe automaticamente a função chamadora. Para encerrar um fluxo após o aviso, a aplicação deve usar seu próprio Return ou tratamento de erro. Não utilizar uma mensagem de conclusão antes de confirmar o resultado real da operação. (Manual AdvPL, s.d., p. 333, ref. 1) O exemplo comunitário lista esta chamada, mas não demonstra regras de negócio. (SANTOS, 2020, ref. 2)

02 · SINTAXE

Sintaxe

APMsgAlert( <cMsg>, [cTitulo] ) --> Nil

Parâmetros

cMsg
CaractereObrigatório

Mensagem exibida.

cTitulo
CaractereOpcional

Título do diálogo.

Retorno

Nil, conforme a referência histórica.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function EdApmsgal()
    // Mensagem didatica sem dados de clientes.
    APMsgAlert("Confira o resultado antes de continuar.", "Conferencia")
Return Nil
Resultado esperado

Propõe uma mensagem; a função editorial termina por seu próprio Return Nil. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Usar em sessão interativa. Conferir visual e comportamento na versão instalada; a referência é histórica e o fonte comunitário não foi compilado.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. APMsgAlert. TDN. Consulta em 2026-10-25.
  2. SANTOS, Milton J. dos. Alertas.prw, 2020. Repositório rogeriosacra/ADVPL, ETHIOS/Aula 01 - Alertas001/Aula 01 - Alertas/Alertas.prw. Commit a10ba66270cd96ec062c3ad54547a0145b8b29b8. Exemplo comunitário analisado, sem reprodução integral. Consulta em 2026-10-25.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha