Em um banco de dados da área de trabalho access, a MsgBox função exibe uma mensagem em uma caixa de diálogo, aguarda o usuário selecionar um botão e retorna um Integer que indica qual botão o usuário selecionou.
Sintaxe
MsgBox(prompt[, buttons][, title][, helpfile][, context])
A MsgBox sintaxe da função 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 de é de cerca de prompt 1024 caracteres, dependendo da largura dos caracteres usados. Se prompt tiver mais de uma linha, você poderá separar as linhas usando um caractere de retorno de transporte (Chr(13)), um caractere de alimentação de linha (Chr(10)) ou uma combinação de alimentação de retorno de transporte (Chr(13) & Chr(10)) entre cada linha. |
buttons |
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 mensagem. Se omitido, o valor padrão para buttons é 0. |
title |
Opcional. Expressão de cadeia de caracteres exibida na barra de título da caixa de diálogo. Se você omitir title, o nome do aplicativo será exibido 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 helpfile for fornecido, context também deverá ser fornecido. |
context |
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 context for fornecido, helpfile também deverá ser fornecido. |
Configurações
As buttons configurações de argumento são:
| Constante | Valor | Descrição |
|---|---|---|
vbOKOnly |
0 |
Exibir SOMENTE OK . |
vbOKCancel |
1 |
Exibir OK e Cancelar. |
vbAbortRetryIgnore |
2 |
Exiba Abortar, Repetir e Ignorar. |
vbYesNoCancel |
3 |
Exibir Sim, Não e Cancelar. |
vbYesNo |
4 |
Exibir Sim e Não. |
vbRetryCancel |
5 |
Exibir Repetição e Cancelar. |
vbCritical |
16 |
Exiba o ícone Mensagem Crítica . |
vbQuestion |
32 |
Exiba o ícone Consulta de Aviso . |
vbExclamation |
48 |
Exiba o ícone Mensagem de Aviso . |
vbInformation |
64 |
Exiba o ícone Mensagem de Informações . |
vbDefaultButton1 |
0 |
Faça do primeiro botão o padrão. |
vbDefaultButton2 |
256 |
Faça do segundo botão o padrão. |
vbDefaultButton3 |
512 |
Faça do terceiro botão o padrão. |
vbDefaultButton4 |
768 |
Faça do quarto botão 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 |
Adicione um botão Ajuda à caixa de mensagens. |
VbMsgBoxSetForeground |
65536 |
Especifique a janela da caixa de mensagens como a janela em primeiro plano. |
vbMsgBoxRight |
524288 |
Alinhe o texto com o botão direito do mouse. |
vbMsgBoxRtlReading |
1048576 |
Faça com que o texto apareça com leitura da direita para a esquerda em sistemas hebraicos e árabes. |
O primeiro grupo de valores (0 por meio 5) descreve o número e o tipo de botões exibidos na caixa de diálogo. O segundo grupo (16, , 32, 6448) descreve o estilo de ícone. O terceiro grupo (0, , 512256) determina qual botão é o padrão. O quarto grupo (0, 4096) determina a modalidade da caixa de mensagens. Ao adicionar números para criar um valor final para o buttons argumento, use apenas um número de cada grupo.
Observação
Essas constantes são especificadas por Visual Basic for Applications. Como resultado, você pode usar os nomes em qualquer lugar do código, em vez dos valores reais.
Retornar valores
| 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 ambos helpfile e context são fornecidos, o usuário pode pressionar F1 no Windows ou Ajuda no macOS para exibir o tópico Ajuda que corresponde a context. Alguns aplicativos host, como o 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 o Esc terá o mesmo efeito que selecionar 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 o usuário selecione um dos outros botões.
Observação
Para especificar mais do que o primeiro argumento nomeado, você deve usar MsgBox em uma expressão. Para omitir alguns argumentos posicionais, você deve incluir o delimitador de vírgula correspondente.
Exemplo
Observação
O exemplo a seguir demonstra como usar essa função em um módulo VBA (Visual Basic for Applications).
Este exemplo usa a MsgBox função 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 depende do botão selecionado pelo MsgBox usuário. Este exemplo pressupõe que DEMO.HLP seja 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