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 que indica o botão que o utilizador selecionou.
Sintaxe
MsgBox(prompt[, buttons][, title][, helpfile][, context])
A MsgBox sintaxe da função tem estes 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 é 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 símbolo (Chr(13)), um caráter de linefeed (Chr(10)) ou uma combinação de avanço de linha de retorno (Chr(13) & Chr(10)) entre cada linha. |
buttons |
Opcional. Expressão numérica que é a soma dos 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 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 é apresentado 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 tem de 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 tem de ser fornecido. |
Definições
As buttons definições do argumento são:
| Constante | Valor | Descrição |
|---|---|---|
vbOKOnly |
0 |
Apresentar apenas OK . |
vbOKCancel |
1 |
Apresentar OK e Cancelar. |
vbAbortRetryIgnore |
2 |
Apresentar Abortar, Repetir e Ignorar. |
vbYesNoCancel |
3 |
Apresentar Sim, Não e Cancelar. |
vbYesNo |
4 |
Apresentar Sim e Não. |
vbRetryCancel |
5 |
Apresentar Repetição 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 |
Predefinir o primeiro botão. |
vbDefaultButton2 |
256 |
Predefinir o segundo botão. |
vbDefaultButton3 |
512 |
Predefinir o terceiro botão. |
vbDefaultButton4 |
768 |
Predefinir o quarto botão. |
vbApplicationModal |
0 |
Modal da aplicação. O utilizador tem de responder à caixa de mensagem antes de continuar a trabalhar na aplicação atual. |
vbSystemModal |
4096 |
Modal do sistema. Todas as aplicações são suspensas até que o utilizador responda à caixa de mensagem. |
vbMsgBoxHelpButton |
16384 |
Adicionar um botão Ajuda à caixa de mensagem. |
VbMsgBoxSetForeground |
65536 |
Especifique a janela da caixa de mensagem como a janela de primeiro plano. |
vbMsgBoxRight |
524288 |
Alinhar o texto à direita. |
vbMsgBoxRtlReading |
1048576 |
Faça com que o texto apareça com leitura da direita para a esquerda em sistemas hebraico e árabe. |
O primeiro grupo de valores (0 através 5de ) descreve o número e o tipo de botões apresentados na caixa de diálogo. O segundo grupo (16, 32, 48, 64) descreve o estilo do ícone. O terceiro grupo (0, 256, 512) determina qual é o botão predefinido. O quarto grupo (0, 4096) determina a modalidade da caixa de mensagem. Quando adicionar 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 e helpfilecontext são fornecidos, o utilizador pode premir F1 no Windows ou Ajuda no macOS para ver 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 contiver um botão Ajuda , a Ajuda sensível ao contexto é fornecida para a caixa de diálogo. No entanto, não é devolvido nenhum valor até que o utilizador selecione um dos outros botões.
Nota
Para especificar mais do que o primeiro argumento nomeado, 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 predefinida. O valor devolvido pela MsgBox função depende do botão que o utilizador seleciona. Este exemplo pressupõe que DEMO.HLP é um ficheiro 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