Instrução MsgBox

Mostra uma caixa de diálogo com uma mensagem.

Sintaxe:

MsgBox Texto As String [,Tipo As Integer [,TítuloDiálogo As String]] (As Statement) ou MsgBox (Texto As String [,Tipo As Integer [,TítuloDiálogo As String]]) (As Function)

Parâmetro:

Texto: expressão em caracteres mostrada como mensagem na caixa de diálogo. As quebras de linha podem ser inseridas com Chr$(13).

TítuloDiálogo: expressão em caracteres mostrada na barra do título da caixa de diálogo. Se omissa, a barra do título mostra o nome da respetiva aplicação.

Tipo: qualquer expressão em número inteiro que especifique o tipo da caixa de diálogo, bem como o número e tipo de botões a mostrar e o tipo de ícone. Tipo representa uma combinação de padrões de bits, ou seja, uma combinação de elementos pode ser definida adicionando os seus respetivos valores:

Constante com nome

Valor inteiro

Definição

MB_OK

0

Mostrar apenas o botão Aceitar.

MB_OKCANCEL

1

Mostrar os botões Aceitar e Cancelar.

MB_ABORTRETRYCANCEL

2

Mostrar os botões Cancelar, Tentar novamente e Ignorar.

MB_YESNOCANCEL

3

Mostrar os botões Sim, Não e Cancelar.

MB_YESNO

4

Mostrar os botões Sim e Não.

MB_RETRYCANCEL

5

Mostrar os botões Tentar novamente e Cancelar.

MB_ICONSTOP

16

Adicionar o ícone Parar à caixa de diálogo.

MB_ICONQUESTION

32

Adicionar o ícone Ponto de interrogação à caixa de diálogo.

MB_ICONEXCLAMATION

48

Adicionar o ícone Ponto de exclamação à caixa de diálogo.

MB_ICONINFORMATION

64

Adicionar o ícone de Informação à caixa de diálogo.

128

Primeiro botão na caixa de diálogo como botão padrão.

MB_DEFBUTTON2

256

Segundo botão da caixa de diálogo como botão padrão.

MB_DEFBUTTON3

512

Terceiro botão da caixa de diálogo como botão padrão.


Códigos de erro

5 Chamada de procedimento inválido

Exemplo:

Sub ExampleMsgBox

 Const sText1 = "Ocorreu um erro inesperado."

 Const sText2 = "Contudo, a execução do programa irá continuar."

 Const sText3 = "Erro"

 MsgBox(sText1 + Chr(13) + sText2,16,sText3)

 MsgBox(sText1 + Chr(13) + sText2, MB_ICONSTOP, sText3)

End Sub