Em um banco de dados da área de trabalho 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 Inteiro indicando qual botão o usuário clicou.
Sintaxe
MsgBox ( prompt [, botões ] [, título ] [, helpfile ] [, contexto ] )
A sintaxe da função MsgBox tem esses 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ê poderá separar as linhas usando um caractere de retorno de carruagem (Chr(13)), um caractere de linefeed (Chr(10)) ou retorno de carruagem – combinação de caracteres de linefeed (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 serem exibidos, o estilo de ícone a ser usado, a identidade do botão padrão e a modalidade da caixa de mensagens. 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 Help a ser usado para fornecer ajuda sensível ao contexto para a caixa de diálogo. Se o arquivo de ajuda for fornecido, o contexto também deverá ser fornecido. |
|
Contexto |
Opcional. Expressão numérica que é o número de contexto de ajuda atribuído ao tópico ajuda apropriado pelo autor da Ajuda. Se o contexto for fornecido, o arquivo de ajuda também deve 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 |
Exiba botões Abortar, Repetir e Ignorar . |
|
vbYesNoCancel |
3 |
Exibir botões Sim, Não e Cancelar . |
|
vbYesNo |
4 |
Exibir botões Sim e Não . |
|
vbRetryCancel |
5 |
Exibir botões Repetir e Cancelar . |
|
vbCritical |
16 |
Exibir ícone Mensagem Crítica . |
|
vbQuestion |
32 |
Exibir ícone 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 mensagens antes de continuar trabalhando no aplicativo atual. |
|
vbSystemModal |
4096 |
Modal do sistema; todos os aplicativos são suspensos até que o usuário responda à caixa de mensagens. |
|
vbMsgBoxHelpButton |
16384 |
Adiciona o botão Ajuda à caixa de mensagens |
|
VbMsgBoxSetForeground |
65536 |
Especifica a janela da caixa de mensagens como a janela em 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 hebraicos e árabes |
O primeiro grupo de valores (0 a 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 mensagens. Ao adicionar números para criar um valor final para o argumento de botões , 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 do código no lugar dos valores reais.
Valores retornados
|
Constante |
Valor |
Descrição |
|---|---|---|
|
vbOK |
1 |
OK |
|
vbCancel |
2 |
Cancelar |
|
vbAbort |
3 |
Abortar |
|
vbRetry |
4 |
Repetição |
|
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 (macOS) para exibir o tópico Ajuda correspondente ao contexto. Alguns aplicativos host, por exemplo, Microsoft Excel, também adicionam automaticamente um botão 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 Ajuda , 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 o 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 VBA (Visual Basic for Applications).
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 pressupõe que DEMO.HLP é um arquivo help 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
