Numa base de dados de ambiente de trabalho do Access, a MsgBox função apresenta uma mensagem numa caixa de diálogo, aguarda que o utilizador selecione um botão e devolve um Integer botão que indica que botão o utilizador selecionou.
Sintaxe
MsgBox(prompt[, buttons][, title][, helpfile][, context])
A MsgBox sintaxe da função tem os seguintes argumentos:
| Argumento | Descrição |
|---|---|
prompt |
Obrigatório. Expressão de cadeia apresentada como a mensagem na caixa de diálogo. O comprimento máximo é de cerca de prompt 1024 carateres, consoante a largura dos carateres utilizados. Se prompt tiver mais do que uma linha, pode separar as linhas utilizando um caráter de retorno de carro (Chr(13)), um caráter de avanço de linha (Chr(10)) ou uma combinação de avanço de linha de carro (Chr(13) & Chr(10)) entre cada linha. |
buttons |
Opcional. Expressão numérica que corresponde à soma de valores que especificam o número e o tipo de botões a apresentar, o estilo de ícone a utilizar, a identidade do botão predefinido e a modalidade da caixa de mensagem. Se for omitido, o valor predefinido para buttons é 0. |
title |
Opcional. Expressão de cadeia apresentada na barra de título da caixa de diálogo. Se omitir title, o nome da aplicação aparece na barra de título. |
helpfile |
Opcional. Expressão de cadeia que identifica o ficheiro de Ajuda a utilizar para fornecer Ajuda sensível ao contexto para a caixa de diálogo. Se helpfile for fornecido, context também deve ser fornecido. |
context |
Opcional. Expressão numérica que é o número de contexto da Ajuda atribuído ao tópico de Ajuda adequado pelo autor da Ajuda. Se context for fornecido, helpfile também deve ser fornecido. |
Definições
As buttons definições de argumento são:
| Constante | Valor | Descrição |
|---|---|---|
vbOKOnly |
0 |
Apresentar apenas OK . |
vbOKCancel |
1 |
Apresentar OK e Cancelar. |
vbAbortRetryIgnore |
2 |
Apresentar Anular, Repetir e Ignorar. |
vbYesNoCancel |
3 |
Apresentar Sim, Não e Cancelar. |
vbYesNo |
4 |
Apresentar Sim e Não. |
vbRetryCancel |
5 |
Apresentar Repetir e Cancelar. |
vbCritical |
16 |
Apresentar o ícone Mensagem Crítica . |
vbQuestion |
32 |
Apresentar o ícone Consulta de Aviso . |
vbExclamation |
48 |
Apresentar o ícone Mensagem de Aviso . |
vbInformation |
64 |
Apresentar o ícone Mensagem de Informação . |
vbDefaultButton1 |
0 |
Torne o primeiro botão no predefinido. |
vbDefaultButton2 |
256 |
Torne o segundo botão no predefinido. |
vbDefaultButton3 |
512 |
Torne o terceiro botão na predefinição. |
vbDefaultButton4 |
768 |
Torne o quarto botão no predefinido. |
vbApplicationModal |
0 |
Modalidade de aplicação. O utilizador tem de responder à caixa de mensagem antes de continuar a trabalhar na aplicação atual. |
vbSystemModal |
4096 |
Sistema modal. Todas as aplicações são suspensas até que o utilizador responda à caixa de mensagem. |
vbMsgBoxHelpButton |
16384 |
Adicione um botão de Ajuda à caixa de mensagem. |
VbMsgBoxSetForeground |
65536 |
Especifique a janela da caixa de mensagens como a janela de primeiro plano. |
vbMsgBoxRight |
524288 |
Alinhar o texto à direita. |
vbMsgBoxRtlReading |
1048576 |
Apresente o texto com a leitura da direita para a esquerda nos sistemas hebraico e árabe. |
O primeiro grupo de valores (0 through 5) descreve o número e o tipo de botões apresentados na caixa de diálogo. O segundo grupo (16, 32, 4864, ) descreve o estilo do ícone. O terceiro grupo (0, 256, 512) determina qual botão é o padrão. O quarto grupo (0, 4096) determina a modalidade da caixa de mensagem. Ao somar números para criar um valor final para o buttons argumento, utilize apenas um número de cada grupo.
Nota
Estas constantes são especificadas por Visual Basic for Applications. Como resultado, pode utilizar os nomes em qualquer parte do seu código em vez dos valores reais.
Valores devolvidos
| Constante | Valor | Descrição |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Cancelar |
vbAbort |
3 |
Abortar |
vbRetry |
4 |
Tentar novamente |
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 visualizar o tópico de Ajuda que corresponde contexta . Algumas aplicações anfitriãs, como o Microsoft Excel, também adicionam automaticamente um botão Ajuda à caixa de diálogo.
Se a caixa de diálogo apresentar um botão Cancelar , premir Esc tem o mesmo efeito que selecionar Cancelar. Se a caixa de diálogo incluir um botão Ajuda , fornece Ajuda sensível ao contexto para a caixa de diálogo. No entanto, nenhum valor é retornado até que o usuário selecione um dos outros botões.
Nota
Para especificar mais do que o primeiro argumento com nome, tem de utilizar MsgBox numa expressão. Para omitir alguns argumentos posicionais, tem de incluir o delimitador de vírgulas correspondente.
Exemplo
Nota
O exemplo seguinte demonstra como utilizar esta função num módulo Visual Basic for Applications (VBA).
Este exemplo utiliza a MsgBox função para apresentar uma mensagem de erro crítico numa caixa de diálogo com os botões Sim e Não . O botão Não é especificado como a resposta padrão. O valor devolvido pela MsgBox função depende do botão que o utilizador selecionar. Este exemplo pressupõ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