Ação da macro CaixaDeMensagem

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação MessageBox para exibir uma caixa de mensagens contendo um aviso ou uma mensagem informativa. Por exemplo, você pode usar a ação MessageBox com macros de validação. Quando um controle ou registro falha em uma condição de validação na macro, uma caixa de mensagem pode exibir uma mensagem de erro e fornecer instruções sobre o tipo de dados que devem ser inseridos.

Setting

A ação MessageBox tem os seguintes argumentos.

Argumento da ação	Descrição
Mensagem	O texto na caixa de mensagens. Insira o texto da mensagem na caixa Mensagem na seção Argumentos de Ação do painel Construtor de Macros. Você pode digitar até 255 caracteres ou inserir uma expressão (precedida por um sinal igual).
Beep	Especifica se o alto-falante do computador soa um tom de bipe quando a mensagem é exibida. Clique em Sim (soe o tom de bipe) ou Não (não soe o tom de bipe). O padrão é Sim.
Tipo	O tipo de caixa de mensagem. Cada tipo tem um ícone diferente. Clique em Nenhum, Crítico, Aviso?, Aviso!ou Informações. O padrão é Nenhum.
Título	O texto exibido na barra de título da caixa de mensagens. Por exemplo, você pode ter a barra de título exibindo "Validação da ID do Cliente". Se você deixar esse argumento em branco, "Microsoft Access" será exibido.

Comentários

Você pode usar a ação MessageBox para criar uma mensagem de erro formatada semelhante a mensagens de erro internas exibidas pelo Microsoft Access. A ação MessageBox permite que você forneça uma mensagem em três seções para o argumento Mensagem. Você separa as seções com o caractere "@".

O exemplo a seguir exibe uma caixa de mensagem formatada com uma mensagem seccionada. A primeira seção de texto na mensagem é exibida como um título em negrito. A segunda seção é exibida como texto sem formatação abaixo desse título. A terceira seção é exibida como texto simples abaixo da segunda seção, com uma linha em branco entre elas.

Digite a seguinte cadeia de caracteres no argumento Mensagem :

Botão errado!@This o botão não funciona.@Try Outro.

Você não pode executar a ação MessageBox em um módulo VBA (Visual Basic for Applications). Em vez disso, use a função MsgBox .

Exemplos

Sincronizar formulários usando uma macro

A macro a seguir abre um formulário de Lista de Produtos no canto inferior direito do formulário Fornecedores, exibindo os produtos do fornecedor atual. Ele mostra o uso das ações Echo, MessageBox, GoToControl, StopMacro, OpenForm e MoveAndSizeWindow . Ele também mostra o uso de uma expressão condicional com as ações MessageBox, GoToControl e StopMacro . Essa macro deve ser anexada ao botão Revisar Produtos no formulário Fornecedores.

Condition	Ação	Argumentos: Configuração	Comentário
	Echo	Echo On: No	Interrompe a atualização de tela quando a macro é executada.
IsNull([SupplierID])	CaixaDeMensagem	Mensagem: mova para o registro de fornecedor cujos produtos você deseja ver e clique no botão Revisar Produtos novamente. Beep: YesType: NoneTitle: selecione um fornecedor	Se não houver nenhum fornecedor atual no formulário Fornecedores, exiba uma mensagem.
...	GoToControl	Nome do controle: CompanyName	Mova o foco para o controle CompanyName.
...	Pararmacro		Pare a macro.
	OpenForm	Nome do formulário: Exibição da lista de produtos: DatasheetFilter Name: Where Condition: [SupplierID] = [Forms]! [Fornecedores]! [SupplierID] Modo de Dados: Modo OnlyWindow de leitura: normal	Abra o formulário Lista de Produtos e mostre os produtos do fornecedor atual.
	MoveAndSizeWindow	Direito: 0,7799" Para baixo: 1,8"	Posicione o formulário Lista de Produtos no canto inferior direito do formulário Fornecedores.

Validar dados usando uma macro

A macro de validação a seguir verifica os códigos postais inseridos em um formulário Fornecedores. Ela mostra o uso das ações PararMacro, CaixadeMensagem, CancelarEvento e IrParaControle. Uma expressão condicional verifica o país/região e o código postal inseridos em um registro do formulário. Se o código postal não estiver no formato certo para o país/região, a macro exibirá uma caixa de mensagens e cancelará salvar o registro. Em seguida, ele retorna você para o controle PostalCode, onde você pode corrigir o erro. Essa macro deve ser anexada à propriedade AntesdeAtualizar do formulário Fornecedores.

Condition	Ação	Argumentos: Configuração	Comentário
IsNull([CountryRegion])	Pararmacro		Se CountryRegion for Null, o código postal não poderá ser validado.
[CountryRegion] Em ("França", "Itália", "Espanha") e Len([PostalCode]) <> 5	CaixaDeMensagem	Mensagem: o código postal deve ter 5 caracteres. Beep: YesType: InformationTitle: Erro do Código Postal	Se o código postal não tiver 5 caracteres, exiba uma mensagem.
...	CancelEvent		Cancele o evento.
	GoToControl	Nome do controle: PostalCode
[CountryRegion] Em ("Austrália", "Cingapura") e Len([PostalCode]) <> 4	CaixaDeMensagem	Mensagem: o código postal deve ter 4 caracteres. Beep: YesType: InformationTitle: Erro do Código Postal	Se o código postal não tiver 4 caracteres, exiba uma mensagem.
...	CancelEvent		Cancele o evento.
	GoToControl	Nome do controle: PostalCode
([CountryRegion] = "Canadá") E ([PostalCode] Não como"[A-Z][0-9][A-Z] [0-9][A-Z][0-9]")	CaixaDeMensagem	Mensagem: o código postal não é válido. Exemplo de código canadense: H1J 1C3 Beep: YesType: InformationTitle: Postal Code Error	Se o código postal não estiver correto para Canadá, exiba uma mensagem. (Exemplo de código de Canadá: H1J 1C3)
...	CancelEvent		Cancele o evento.