Função MsgBox

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Um desktop banco de dados, a função MsgBox exibe uma mensagem em uma caixa de diálogo, aguarda que o usuário clicar em um botão e retorna um número inteiro indicando qual botão o usuário clicou.

Sintaxe

MsgBox ( prompt [botões ] [título ] [ arquivo de ajuda do, ] [contexto ] )

A sintaxe da função MsgBox possui os seguintes argumentos:

Argumento

Descrição

prompt

Necessário. Exibida como a mensagem na caixa de diálogo de expressão de cadeia de caracteres. O comprimento máximo de prompt é aproximadamente 1024 caracteres, dependendo a largura dos caracteres usados. Se o prompt consiste em mais de uma linha, você pode separar as linhas usando um caractere retorno de carro (Chr(13)), um caractere de alimentação de linha (Chr(10)) ou retorno de carro-alimentação de linha combinação de caracteres (Chr(13) & Chr(10)) entre cada linha.

botões

Opcional. expressão numérica que é a soma dos valores especificando o número e o tipo de botões para exibir, 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 botões é 0.

título

Opcional. Expressão exibida na barra de título da caixa de diálogo de cadeia de caracteres. Se você omitir o título, o nome do aplicativo é colocado na barra de título.

arquivo de ajuda

Opcional. Expressão de cadeia de caracteres que identifica o arquivo de ajuda para usar para fornecer ajuda contextual para a caixa de diálogo. Se o arquivo de ajuda é fornecido, contexto também deve ser fornecido.

contexto

Opcional. Expressão numérica que é o número de contexto de Ajuda atribuído para o tópico de Ajuda apropriado pelo autor da Ajuda. Se o contexto é fornecido, o arquivo de ajuda também deve ser fornecido.


Configurações

As configurações deargumento de botõessão:

Constante

Valor

Descrição

vbOKOnly

0

Exibir botão Okey somente.

vbOKCancel

1

Exibir botões Okey e Cancelar .

vbAbortRetryIgnore

2

Exibir botões Anular, Repetire Ignorar .

vbYesNoCancel

3

Exibir botões Sim, nãoe Cancelar .

vbYesNo

4

Exibe os botões Sim e não .

vbRetryCancel

5

Exibir botões Repetir e Cancelar .

vbCritical

16

Exiba ícone de Mensagem crítica .

vbQuestion

32

Exiba ícone de Aviso de consulta    .

vbExclamation

48

Exiba ícone de Mensagem de aviso    .

vbInformation

64

Exiba ícone de Mensagem de informação .

vbDefaultButton1

0

Primeiro botão é padrão.

vbDefaultButton2

256

Segundo botão é padrão.

vbDefaultButton3

512

Terceiro botão é padrão.

vbDefaultButton4

768

Quarto botão é padrão.

vbApplicationModal

0

Modalidade do aplicativo; o usuário deve responder à caixa de mensagem antes de continuar o trabalho no aplicativo atual.

vbSystemModal

4096

Modalidade do sistema; todos os aplicativos estão suspensos até que o usuário responda à caixa de mensagem.

vbMsgBoxHelpButton

16384

Adiciona o botão Ajuda à caixa de mensagem

VbMsgBoxSetForeground

65536

Especifica a janela da caixa de mensagem como a janela de primeiro plano

vbMsgBoxRight

524288

Texto é alinhado à direita

vbMsgBoxRtlReading

1048576

Especifica o texto deverá aparecer como direita para a esquerda nos sistemas hebraico e árabe de leitura


Dica : No Access 2010, o construtor de expressões tem IntelliSense, assim você pode ver quais argumentos requer sua expressão.

O primeiro grupo de valores (0 – 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 que botão é o padrão; e o quarto grupo (0, 4096) determina a modalidade da caixa de mensagem. 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 : Constantes são especificadas pelo Visual Basic for Applications. Como resultado, os nomes podem ser usados em qualquer lugar no seu código no lugar dos valores reais.

Retornar valores

Constante

Valor

Descrição

vbOK

1

Okey

vbCancel

2

Cancelar

vbAbort

3

Anular

vbRetry

4

Repetir

vbIgnore

5

Ignorar

vbYes

6

Sim

vbNo

7

Não


Comentários

Quando o arquivo de ajuda e contexto são fornecidos, o usuário pode pressionar F1 (Windows) ou HELP (Macintosh) para exibir o tópico de ajuda correspondente ao contexto. Alguns aplicativos do host, por exemplo, o Microsoft Excel, também adicionam automaticamente um botão Ajuda à caixa de diálogo.

Se a caixa de diálogo exibe um botão Cancelar , pressionando a tecla ESC tem o mesmo efeito que clicar em Cancelar. Se a caixa de diálogo contiver um botão Ajuda , ajuda contextual é fornecida para a caixa de diálogo. No entanto, nenhum valor é retornado até que um dos outros botões for clicado.

Observação : Para especificar mais que o primeiro argumento nomeado, você deve usar MsgBox em um expressão. Para omitir alguns argumentos posicionais, você deve incluir a vírgula delimitadora correspondente.

Exemplo

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA).

Este exemplo usa a função CaixaDeMensagem para exibir uma mensagem de erro crítico em uma 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 retornado pela função MsgBox depende o botão escolhido pelo usuário. 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

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×