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.

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

Exceções

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)