Função MsgBox (Visual Basic)

Exibe uma mensagem em um caixa de diálogo, aguarda que o usuário clicar em um botão e em seguida, retorna um número inteiro indicando qual botão o usuário clicou.

Public Function MsgBox( _
   ByVal Prompt As Object, _
   Optional ByVal Buttons As MsgBoxStyle = MsgBoxStyle.OKOnly, _
   Optional ByVal Title As Object = Nothing _
) As MsgBoxResult

Parâmetros

• Prompt
  Obrigatório.String expressão exibida sistema autônomo a mensagem na caixa de diálogo. O comprimento máximo de Prompt é aproximadamente 1024 caracteres, dependendo da largura dos caracteres usados.Se Prompt consiste de mais de uma linha, você pode separar as linhas usando um caractere retorno de carro (Chr( 13 )) , um caractere alimentação de linha (Chr( 10 )), ou uma combinação de caracteres retorno de carro/alimentação de linha (Chr( 13 ) & Chr( 10 )) entre cada linha.

• Buttons
  Opcional.Expressão numérica que é a soma de valores especificando o número e tipo de botões para exibir, o ícone estilo a ser usado, a identidade do botão padrão e a modalidade da caixa de mensagem.Se você omitir Buttons, o valor padrão é zero.

• Title
  Opcional.String expressão exibida na BAR de título da caixa de diálogo. Se você omitir Title, o nome do aplicativo é colocado na barra de título.

Configurações

Os valores da enumeração MsgBoxStyle estão listados na tabela a seguir.

Membro	Valor	Descrição
OKOnly	0	Exibe somente botão OK.
OKCancel	1	Exibe botões OK e Cancelar.
AbortRetryIgnore	2	Exibe botões anular, repetir e ignorar.
YesNoCancel	3	Exibe botões Sim, Não e Cancelar.
YesNo	4	Exibe botões Sim e Não.
RetryCancel	5	Exibe os botões ' Repetir ' e ' Cancelar '.
Critical	16	Exibe o ícone de Mensagem Crítica.
Question	32	Exibe o Ícone de aviso de consulta.
Exclamation	48	Exibe o ícone de mensagem de aviso.
Information	64	Exibe o ícone de mensagem de informação.
DefaultButton1	0	Primeiro botão é padrão.
DefaultButton2	256	Segundo botão é padrão.
DefaultButton3	512	Terceiro botão é padrão.
ApplicationModal	0	Aplicativo é restrito.O usuário deve responder para o caixa de mensagem antes de continuar o trabalho no aplicativo atual.
SystemModal	4096	O sistema é restrito.Todos os aplicativos estão suspensos até que o usuário responda à caixa de mensagem.
MsgBoxSetForeground	65536	Especifica a janela caixa de mensagem como a janela de primeiro plano.
MsgBoxRight	524288	Texto é alinhado à direita.
MsgBoxRtlReading	1048576	Especifica que o texto aparecerá com leitura da direita para a esquerda nos sistemas hebraico e árabe.

O primeiro grupo de valores (0–5) descreve a número e o tipo dos botões exibidos na caixa de diálogo.O segundo grupo (16, 32, 48, 64) descreve o estilo de item.O terceiro grupo (0, 256, 512) determina que botão é o padrão.O quarto grupo (0, 4096) determina a modalidade do caixa de mensagem, e o quinto grupo especifica se a janela caixa de mensagem é a janela de primeiro plano ou não, juntamente com o alinhamento e direção do texto.Ao adicionar números para criar um valor final para o argumento Buttons,use apenas um número de cada grupo.

Valor de retorno

Constante	Valor
OK	1
Cancel	2
Abort	3
Retry	4
Ignore	5
Yes	6
No	7

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Prompt não é uma expressão String, ou Title é inválido.
InvalidOperationException	5	Processo não está sendo executado no modo interativo com o usuário.
InvalidEnumArgumentException	5	Um ou mais parâmetros que não é membro da enumeração MsgBoxResult ou MsgBoxStyle.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

Se o caixa de diálogo exibe um botão Cancel,pressionando a tecla ESC tem o mesmo efeito que clicar em Cancelar .Se o caixa de diálogo contém um botão Help, ajuda contextual é fornecida para o caixa de diálogo.No entanto, nenhum valor é retornado até que um dos outros botões for clicado.

Observação:
Para especificar mais do que o primeiro argumento, você deve usar o MsgBox função em uma expressão. Se você omitir argumentos posicionais, você deve manter o delimitador vírgula correspondente.

Observação:
O MsgBox função requer UIPermission com o SafeTopLevelWindows nível, que pode afetar sua execução em situações de confiança parcial. Para obter mais informações, consulte Solicitando permissões e UIPermission.

Exemplo

Este exemplo usa a função MsgBox para exibir uma mensagem de erro crítico em um caixa de diálogo com os botões Sim e Não.O botão não é especificado como a resposta padrão.Isso é feito combinando os valores constantes MsgBox em um expressão numérica.Nesse caso, adicionando 4 (a combinação de botão Sim/não) e 16 (a Mensagem crítica janela) e oferece um total de 276 a 256 (o segundo botão sistema autônomo botão padrão).O valor retornado pelo MsgBox função depende do botão escolhido pelo usuário: Sim retorna um valor de 6; não retorna um valor de 7.

Dim msg As String
Dim title As String
Dim style As MsgBoxStyle
Dim response As MsgBoxResult
msg = "Do you want to continue?"   ' Define message.
style = MsgBoxStyle.DefaultButton2 Or _
   MsgBoxStyle.Critical Or MsgBoxStyle.YesNo
title = "MsgBox Demonstration"   ' Define title.
' Display message.
response = MsgBox(msg, style, title)
If response = MsgBoxResult.Yes Then   ' User chose Yes.
   ' Perform some action.
Else
   ' Perform some other action.
End If

Requisitos

Namespace: Microsoft.VisualBasic

**Módulo:**Interaction

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Função InputBox (Visual Basic)