Conteúdo

# Função MsgBox

Mostra uma caixa de diálogo com uma mensagem e devolve um valor.

### Sintaxe:

    MsgBox (Prompt As String [,Buttons = MB_OK [,Title As String]]) As Integer

### Parâmetros:

prompt: String expression displayed as a message in the dialog box. Line breaks can be inserted with Chr$(13).

title: String expression displayed in the title bar of the dialog. If omitted, the title bar displays the name of the respective application.

buttons: Any integer expression that specifies the dialog type, as well as the number and type of buttons to display, and the icon type. buttons represents a combination of bit patterns, that is, a combination of elements can be defined by adding their respective values:

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_ABORTRETRYIGNORE | 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.

### Valor de retorno:

Número inteiro

Constante com nome | Valor inteiro | Definição
--- | --- | ---
IDOK | 1 | Aceitar
IDCANCEL | 2 | Cancelar
IDABORT | 3 | Abortar
IDRETRY | 4 | Tentar novamente
IDIGNORE | 5 | Ignorar
IDYES | 6 | Sim
IDNO | 7 | Não

### Códigos de erro

5 Chamada de procedimento inválido

## Exemplo:

    Sub ExampleMsgBox
    Dim sVar As Integer
     sVar = MsgBox("Vila Real")
     sVar = MsgBox("Vila Real",1)
     sVar = MsgBox( "Vila Real",256 + 16 + 2,"Título da caixa de diálogo")
     sVar = MsgBox("Las Vegas", MB_DEFBUTTON2 + MB_ICONSTOP + MB_ABORTRETRYIGNORE, "Dialog title")
    End Sub