Função: MessageBox

Parâmetros

mensagem: Texto que será apresentado ao usuário na caixa-de-diálogo MODAL.

O parâmetro mensagem pode ser opcionalmente prefixado por um modificador que especifica qual o tipo de caixa-de-diálogo e formatação de texto.

Notificação de Informação
ERW	Error Window : Apresenta janela com um botão de OK e um ícone com uma mão.
WAW	Warning Window : Apresenta janela com um botão de OK e um ícone com uma Exclamação.
INW	Info Window : Apresenta janela com um botão de OK e um ícone com circulo e um i no centro.

Notificação de Seleção
OCx	Janela de Seleção com os botões OK e CANCELA
YNx	Janela de Seleção com os botões SIM e NAO
YCx	Janela de Seleção com os botões SIM e NAO e CANCELA
RCx	Janela de Seleção com os botões REPETIR e CANCELA

O caracter “x” pode ser 1, 2 ou 3 e especifica o botão que recebe o foco por default.

Os seguintes caracteres de controle são tratados no interior da mensagem :

Caracteres Especiais
\f	Formfeed
\n	Newline (linefeed)
\r	Carriage return
\t	Tab (horizontal)

Os seguintes caracteres especiais são tratados no interior da mensagem :

Caracteres Especiais
\’	apresenta o character ‘ (aspa simples)
\”	apresenta o character “ (aspa duplo)
\ \	apresenta o character (barra invertida)

Valor de Retorno: Código de retorno associado a opção de saída selecionada na tela de mensagem. Para identificar a opção de botão selecionada pelo usuário, tem-se os seguintes códigos associados as opções de resposta apresentadas na mensagem :

Valores de Retorno
0	Usuário selecionou opção OK, SIM (confirmou ação)
-1	Usuário selecionou opção NÂO (não confirmou a ação)
-2	Usuário selecionou opção CANCELA (cancelou a ação)
-3	Usuário selecionou opção REPETIR (autorizou nova tentativa)

Exemplo de utilização:

local var1 = MessageBox("YC1:Confirma Envio da Receita")
if (var1 == 0) then
  ...
  MessageBox("INW: Receita Enviada para o Controlador")
else
  MessageBox("INW: Comando Cancelado")