Em um banco de dados da área de trabalho do Access, a função MsgBox exibe uma mensagem em uma caixa de diálogo, aguarda o usuário clicar em um botão e retorna um Integer indicando qual botão o usuário clicou.

Sintaxe

MsgBox ( prompt [, buttons ] [ ,title ] [, helpfile ] [, context ] )

A sintaxe da função MsgBox tem estes argumentos:

Argumento

Descrição

prompt

Obrigatório. Expressão de cadeia de caracteres exibida como a mensagem na caixa de diálogo. O comprimento máximo do prompt é de aproximadamente 1024 caracteres, dependendo da largura dos caracteres usados. Se o prompt consistir em mais de uma linha, você pode separar as linhas usando um caractere de retorno de carro (Chr(13)), um caractere de linha (Chr(10 )) ouretorno de carro – combinação de caracteres de linha (Chr(13) & Chr(10)entre cada linha.

botões

Opcional. expressão numérica que é a soma de valores que especificam o número e o tipo de botões a ser exibido, o estilo de ícone a ser usado, a identidade do botão padrão e a modalidade da caixa de mensagem. Se omitido, o valor padrão para botões será 0.

title

Opcional. Expressão de cadeia de caracteres exibida na barra de título da caixa de diálogo. Se você omitir o título,o nome do aplicativo será colocado na barra de título.

helpfile

Opcional. Expressão de cadeia de caracteres que identifica o arquivo de Ajuda a ser usado para fornecer ajuda confidencial de contexto para a caixa de diálogo. Se o arquivo de ajuda for fornecido, o contexto também deverá ser fornecido.

context

Opcional. Expressão numérica que é o número de contexto da Ajuda atribuído ao tópico de Ajuda apropriado pelo autor da Ajuda. Se o contexto for fornecido, o arquivo de ajuda também deverá ser fornecido.


Configurações

Os botõesargumento configurações são:

Constante

Valor

Descrição

vbOKOnly

0

Exibir somente o botão OK.

vbOKCancel

1

Exibir botões OK e Cancelar.

vbAbortRetryIgnore

2

Exibe os botões Abortar,Repetire Ignorar.

vbYesNoCancel

3

Exibe os botões Sim,Nãoe Cancelar.

vbYesNo

4

Exibe os botões Sime Não.

vbRetryCancel

5

Exibe os botões Repetire Cancelar.

vbCritical

16

Exibir ícone de Mensagem Crítica.

vbQuestion

32

Exibir ícone de consulta de    aviso.

vbExclamation

48

Exibir ícone mensagem de    aviso.

vbInformation

64

Exibir ícone mensagem de informações.

vbDefaultButton1

0

O primeiro botão é padrão.

vbDefaultButton2

256

O segundo botão é padrão.

vbDefaultButton3

512

O terceiro botão é padrão.

vbDefaultButton4

768

O quarto botão é padrão.

vbApplicationModal

0

Modal de aplicativo; o usuário deve responder à caixa de mensagem antes de continuar a trabalhar no aplicativo atual.

vbSystemModal

4096

Modal do sistema; todos os aplicativos são suspensos até que o usuário responda à caixa de mensagem.

vbMsgBoxHelpButton

16384

Adiciona o botão Ajuda à caixa de mensagem

VbMsgBoxSetForeground

65536

Especifica a janela da caixa de mensagem como a janela de primeiro plano

vbMsgBoxRight

524288

O texto está alinhado à direita

vbMsgBoxRtlReading

1048576

Especifica que o texto deve aparecer como leitura da direita para a esquerda em sistemas hebraico e árabe


Dica:  No Access 2010, o Construtor de Expressões IntelliSense, para que você possa ver quais argumentos sua expressão exige. 

O primeiro grupo de valores (0-5) descreve o número e o tipo de botões exibidos na caixa de diálogo; o segundo grupo (16, 32, 48, 64) descreve o estilo de ícone; o terceiro grupo (0, 256, 512) determina qual botão é o padrão; e o quarto grupo (0, 4096) determina a modalidade da caixa de mensagem. Ao adicionar números para criar um valor final para o argumento buttons, use apenas um número de cada grupo.

Observação: Essas constantes são especificadas por Visual Basic for Applications. Como resultado, os nomes podem ser usados em qualquer lugar em seu código no lugar dos valores reais.

Valores de retorno

Constante

Valor

Descrição

vbOK

1

OK

vbCancel

2

Cancelar

vbAbort

3

Abort

vbRetry

4

Repetir

vbIgnore

5

Ignorar

vbYes

6

Sim

vbNo

7

Não


Comentários

Quando o arquivo de ajuda e o contexto são fornecidos, o usuário pode pressionar F1 (Windows) ou HELP (Macintosh) para exibir o tópico de Ajuda correspondente ao contexto. Alguns aplicativos host, por exemplo, o Microsoft Excel, também adicionam automaticamente um botão de Ajuda à caixa de diálogo.

Se a caixa de diálogo exibir um botão Cancelar, pressionar a tecla ESC terá o mesmo efeito que clicar em Cancelar. Se a caixa de diálogo contiver um botão de Ajuda, a Ajuda sensível ao contexto será fornecida para a caixa de diálogo. No entanto, nenhum valor é retornado até que um dos outros botões seja clicado.

Observação: Para especificar mais do que o primeiro argumento nomeado, você deve usar MsgBox em um expressão. Para omitir alguns argumentos posicionais, você deve incluir o delimitador de vírgula correspondente.

Exemplo

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo Visual Basic for Applications (VBA).

Este exemplo usa a função MsgBox para exibir uma mensagem de erro crítico em uma caixa de diálogo com botões Sim e Não. O botão Não é especificado como a resposta padrão. O valor retornado pela função MsgBox depende do botão escolhido pelo usuário. Este exemplo supõe que DEMO.HLP é um arquivo de Ajuda que contém um tópico com um número de contexto de Ajuda igual a 1000.

Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If

Precisa de mais ajuda?

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar Microsoft Office Insider

Essas informações foram úteis?

Qual é o seu grau de satisfação com a qualidade do idioma?
O que afetou sua experiência?

Obrigado pelos seus comentários!

×