Função MsgBox do VBScript

Manual de Referência de Funções VBScript

Definição e uso

A função MsgBox pode exibir uma caixa de mensagem, aguardando que o usuário clique em algum botão e, em seguida, retornar o valor indicativo do botão clicado.

A função MsgBox pode retornar os seguintes valores:

  • 1 = vbOK - O botão de confirmar foi clicado.
  • 2 = vbCancel - O botão de cancelamento foi clicado.
  • 3 = vbAbort - O botão de encerramento foi clicado.
  • 4 = vbRetry - O botão tentar novamente foi clicado.
  • 5 = vbIgnore - O botão ignorar foi clicado.
  • 6 = vbYes - O botão sim foi clicado.
  • 7 = vbNo - O botão não foi clicado.

Comentário:Quando os parâmetros helpfile e context forem especificados, o usuário pode pressionar F1 para visualizar a ajuda.

Dica:Ver a função InputBox.

Sintaxe

MsgBox(prompt[,buttons][,title][,helpfile,context])
Parâmetros Descrição
prompt (solicitação) Obrigatório. Expressão de string que é exibida na caixa de diálogo. O comprimento máximo de prompt é aproximadamente 1024 caracteres, dependendo da largura dos caracteres usados. Se o prompt contiver várias linhas, as linhas podem ser separadas por caractere de nova linha (Chr(13)), caractere de nova linha (Chr(10)) ou combinação de ambos (Chr(13) & Chr(10)).
buttons (botões)

Expressão numérica, que representa a soma do valor dos botões a serem exibidos, do tipo de ícone, do identificador do botão padrão e do estilo da caixa de mensagem. Se omitido, o valor padrão de buttons é 0.

button (botão) valores:

  • 0 = vbOKOnly - Apenas exibe o botão de ok.
  • 1 = vbOKCancel - Exibe os botões de ok e cancelar.
  • 2 = vbAbortRetryIgnore - Exibe os botões de abandonar, tentar novamente e ignorar.
  • 3 = vbYesNoCancel - Exibe os botões de sim, não e cancelar.
  • 4 = vbYesNo - Exibe os botões de sim e não.
  • 5 = vbRetryCancel - Exibe os botões de tentar novamente e cancelar.
  • 16 = vbCritical - Exibe o ícone de mensagem crítica.
  • 32 = vbQuestion - Exibe o ícone de consulta de aviso.
  • 48 = vbExclamation - Exibe o ícone de mensagem de aviso.
  • 64 = vbInformation - Exibe o ícone de mensagem de informação.
  • 0 = vbDefaultButton1 - O primeiro botão é o botão padrão.
  • 256 = vbDefaultButton2 - O segundo botão é o botão padrão.
  • 512 = vbDefaultButton3 - O terceiro botão é o botão padrão.
  • 768 = vbDefaultButton4 - O quarto botão é o botão padrão.
  • 0 = vbApplicationModal - O modo de aplicativo: o usuário deve responder à caixa de mensagem para continuar a trabalhar no aplicativo atual.
  • 4096 = vbSystemModal - Modo de sistema: Enquanto o usuário não responder ao diálogo de mensagem, todos os aplicativos serão suspensos.

O primeiro grupo de valores (0 - 5) é usado para descrever o tipo e o número de botões exibidos no diálogo; o segundo grupo de valores (16, 32, 48, 64) é usado para descrever o estilo do ícone; o terceiro grupo de valores (0, 256, 512) determina o botão padrão; e o quarto grupo de valores (0, 4096) determina o estilo da mensagem. Ao somar esses números para gerar o valor do parâmetro buttons, apenas um número pode ser extraído de cada grupo.
title Expressão de string exibida na barra de título do diálogo. Se o title estiver omitido, o nome do aplicativo será exibido na barra de título.
helpfile Expressão de string, usada para identificar o arquivo de ajuda que fornece ajuda contextualizada para o diálogo. Se o helpfile estiver fornecido, o context deve ser fornecido. Não disponível em plataformas de 16 bits.
context Expressão numérica, usada para identificar o número de contexto especificado pelo autor do arquivo de ajuda para um tópico de ajuda específico. Se context estiver fornecido, o helpfile deve ser fornecido. Não disponível em plataformas de 16 bits.

Exemplo

dim answer
answer=MsgBox("Olá a todos!",65,"Exemplo")
document.write(answer)

Manual de Referência de Funções VBScript