messageBox

Exibe uma caixa de diálogo na tela. Apenas está disponível para aplicativos clientes.

Sintaxe

Reference_Syntax.messageBox( STRING param1 [, STRING param2 [, INTEGER param3 [, INTEGER param4 ] ] ] )

Parâmetros

param1

Uma string válida que representa a mensagem a ser exibida.

param2 (Opcional)

Uma string válida que representa o título a ser exibido na barra de títulos da janela da caixa de diálogo.

Para ajudar na proteção contra falsificação na Internet, o título da janela da caixa de diálogo começa com o texto “Aviso: Janela do JavaScript-”. O título da janela especificado neste parâmetro é exibido após o texto de aviso.

param3 (Opcional)

Um número inteiro que representa o ícone a ser exibido na caixa de diálogo.

  • 0 (Erro) - Este é o padrão.

  • 1 (Aviso)

  • 2 (Pergunta)

  • 3 (Status)

param4 (Opcional)

Um número inteiro que representa os botões a serem exibidos.

  • 0 (OK) - Este é o padrão.

  • 1 (OK, Cancelar)

  • 2 (Sim, Não)

  • 3 (Sim, Não, Cancelar)

Embora param2, param3 e param4 sejam opcionais, se você quiser incluir um parâmetro específico, deverá incluir todos os parâmetros anteriores. Por exemplo, o seguinte JavaScript está incorreto:

    xfa.host.messageBox("Hello World!",3,1);

Neste caso, é necessário especificar também um valor para param2 para que o JavaScript execute corretamente.

Retorna

Um número inteiro válido que representa o valor do botão pressionado pelo usuário:

  • 1 (OK)

  • 2 (Cancelar)

  • 3 (Não)

  • 4 (Sim)

Aplica-se a

Versão

XFA 2.1

Exemplos

JavaScript

xfa.host.messageBox("This is a message", "This is a title", 3, 1);

FormCalc

xfa.host.messageBox("This is a message", "This is a title", 3, 1)