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)