Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOPublicado

ApMsgYesNo

ApMsgYesNo( <cMensagem>, [cTitulo] ) --> lResposta

Exibe uma pergunta Sim/Não ao usuário e retorna a escolha.

InterfaceMensagemConfirmaçãoFunções essenciais
01 · VISÃO GERAL

Visão geral

ApMsgYesNo() é uma função de diálogo para confirmação. Ela deve ser usada quando a rotina precisa de uma decisão explícita do usuário antes de continuar, como confirmar alteração, exclusão, processamento ou envio.

02 · SINTAXE

Sintaxe

ApMsgYesNo( <cMensagem>, [cTitulo] ) --> lResposta

Parâmetros

cMensagem
CaracterObrigatório

Pergunta ou mensagem exibida ao usuário.

cTitulo
CaracterOpcional

Título da janela de confirmação.

Retorno

Lógico. Retorna .T. para Sim/Confirmação e .F. para Não/Cancelamento.

03 · EXEMPLO PRÁTICO

Confirmar alteração antes de continuar

#Include "TOTVS.ch"

User Function ExApMsgYesNo()
    If ApMsgYesNo("Confirma a alteração do cadastro?", "Confirmação")
        MsgInfo("Alteração confirmada.")
    Else
        MsgAlert("Alteração cancelada pelo usuário.")
    EndIf
Return
Resultado esperado

A rotina segue caminhos diferentes conforme a resposta do usuário.

BOAS PRÁTICAS
  • Use quando a ação depender de consentimento explícito do usuário.
  • Escreva mensagens objetivas, indicando a ação que será executada.
  • Para simples informação use MsgInfo(); para erro use MsgStop(); para alerta sem decisão use MsgAlert().
ARMADILHAS COMUNS
  • Não use confirmação visual em jobs, automações sem interface ou processamento batch.
  • Evite perguntas ambíguas; o usuário precisa entender exatamente o que está confirmando.

Conteúdos relacionados

REFERÊNCIAS
  1. RXM Tecnologia. 20 funções AdvPL essenciais que todo dev Protheus usa. Maycon Motta da Silva, maio de 2026. Disponível em: https://rxmtecnologia.com.br/blog/20-funcoes-advpl-essenciais-que-todo-dev-protheus-usa.
Situação
Publicado
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