VBA - Caixa de Mensagem

o MsgBox function exibe uma caixa de mensagem e espera que o usuário clique em um botão e, em seguida, uma ação é executada com base no botão clicado pelo usuário.

Sintaxe

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

Descrição do Parâmetro

  • Prompt- Um parâmetro obrigatório. Um String que é exibido como uma mensagem na caixa de diálogo. O comprimento máximo do prompt é de aproximadamente 1.024 caracteres. Se a mensagem se estender por mais de uma linha, as linhas podem ser separadas usando um caractere de retorno de carro (Chr (13)) ou um caractere de alimentação de linha (Chr (10)) entre cada linha.

  • Buttons- Um parâmetro opcional. Uma expressão numérica que especifica o tipo de botões a serem exibidos, o estilo do ícone a ser usado, a identidade do botão padrão e a modalidade da caixa de mensagem. Se deixado em branco, o valor padrão para os botões é 0.

  • Title- Um parâmetro opcional. Uma expressão String exibida na barra de título da caixa de diálogo. Se o título for deixado em branco, o nome do aplicativo será colocado na barra de título.

  • Helpfile- Um parâmetro opcional. Uma expressão String que identifica o arquivo de Ajuda a ser usado para fornecer ajuda contextual para a caixa de diálogo.

  • Context- Um parâmetro opcional. Uma expressão numérica que identifica o número do contexto da Ajuda atribuído pelo autor da Ajuda ao tópico da Ajuda apropriado. Se o contexto for fornecido, o arquivo de ajuda também deve ser fornecido.

o Buttons parâmetro pode assumir qualquer um dos seguintes valores -

  • 0 vbOKOnly - Exibe apenas o botão OK.

  • 1 vbOKCancel - Exibe os botões OK e Cancelar.

  • 2 vbAbortRetryIgnore - Exibe os botões Abortar, Repetir e Ignorar.

  • 3 vbYesNoCancel - Exibe os botões Sim, Não e Cancelar.

  • 4 vbYesNo - Exibe os botões Sim e Não.

  • 5 vbRetryCancel - Exibe os botões Repetir e Cancelar.

  • 16 vbCritical - Exibe o ícone de mensagem crítica.

  • 32 vbQuestion - Exibe o ícone Consulta de Aviso.

  • 48 vbExclamation - Exibe o ícone de Mensagem de Aviso.

  • 64 vbInformation - Exibe o ícone de mensagem de informação.

  • 0 vbDefaultButton1 - O primeiro botão é o padrão.

  • 256 vbDefaultButton2 - O segundo botão é o padrão.

  • 512 vbDefaultButton3 - O terceiro botão é o padrão.

  • 768 vbDefaultButton4 - Quarto botão é o padrão.

  • 0 vbApplicationModal Modal de aplicativo - O aplicativo atual não funcionará até que o usuário responda à caixa de mensagem.

  • 4096 vbSystemModal Sistema modal - Todos os aplicativos não funcionarão até que o usuário responda à caixa de mensagem.

Os valores acima são divididos logicamente em quatro grupos: O first group(0 a 5) indica os botões a serem exibidos na caixa de mensagem. osecond group (16, 32, 48, 64) descreve o estilo do ícone a ser exibido, o third group (0, 256, 512, 768) indica qual botão deve ser o padrão e o fourth group (0, 4096) determina a modalidade da caixa de mensagem.

Valores Retornados

A função MsgBox pode retornar um dos seguintes valores que podem ser usados ​​para identificar o botão que o usuário clicou na caixa de mensagem.

  • 1 - vbOK - OK foi clicado
  • 2 - vbCancel - Cancelar foi clicado
  • 3 - vbAbort - Abort foi clicado
  • 4 - vbRetry - Foi clicado novamente
  • 5 - vbIgnore - Ignorar foi clicado
  • 6 - vb Sim - Sim foi clicado
  • 7 - vbNo - Não foi clicado

Exemplo

Function MessageBox_Demo() 
   'Message Box with just prompt message 
   MsgBox("Welcome")     
   
   'Message Box with title, yes no and cancel Butttons  
   int a = MsgBox("Do you like blue color?",3,"Choose options") 
   ' Assume that you press No Button  
   msgbox ("The Value of a is " & a) 
End Function

Resultado

Step 1 - A função acima pode ser executada clicando no botão "Executar" na janela VBA ou chamando a função a partir da planilha do Excel, conforme mostrado na imagem a seguir.

Step 2 - Uma caixa de mensagem simples é exibida com uma mensagem "Bem-vindo" e um botão "OK"

Step 3 - Após clicar em OK, outra caixa de diálogo é exibida com uma mensagem junto com os botões "sim, não e cancelar".

Step 4- Após clicar no botão 'Não', o valor desse botão (7) é armazenado como um número inteiro e exibido como uma caixa de mensagem para o usuário, conforme mostrado na imagem a seguir. Usando este valor, pode-se entender qual botão o usuário clicou.