Ação da macro CaixaDeMensagem

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação MessageBox para exibir uma caixa de mensagem 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.

Configuração

A ação MessageBox tem os seguintes argumentos.

Argumento da ação

Descrição

Mensagem

O texto na caixa de mensagem. Insira o texto da mensagem na caixa Mensagem na seção Argumentos da Ação do painel Construtor de Macros. Você pode digitar até 255 caracteres ou inserir uma expressão (precedida por um sinal de igual).

Beep

Especifica se o alto-falante do computador emite um bipe quando a mensagem é exibida. Clique em Sim (soar o tom de bipe) ou Não (não soar 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ção. O padrão é Nenhum.

Título

O texto exibido na barra de título da caixa de mensagem. Por exemplo, você pode fazer com que a barra de título exiba "Validação de 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 às 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 Message. 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 da mensagem é exibida com o 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 sem formatação 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 não funciona.@Try outro.

Não é possível executar a ação MessageBox em um módulo do Visual Basic for Applications (VBA). Em vez disso, use a função MsgBox .

Exemplos

Sincronizar formulários usando uma macro

A macro a seguir abre um formulário Lista de Produtos no canto inferior direito do formulário Fornecedores, exibindo os produtos do fornecedor atual. Ele mostra o uso das ações Eco, MessageBox, GoToControl, StopMacro, OpenForm e MoveAndSizeWindow . Também mostra o uso de uma expressão condicional com as ações CaixaDeMensagem, IrParaControle e PararMacro . 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: Vá para o registro do fornecedor cujos produtos você deseja ver e clique no botão Revisar produtos novamente. Bipe: SimTipo: NenhumTítulo: Selecionar um fornecedor

Se não houver um fornecedor atual no formulário Fornecedores, exiba uma mensagem.

...

GoToControl

Nome do Controle: CompanyName

Mova o foco para o controle CompanyName.

...

StopMacro

Pare a macro.

OpenForm

Nome do formulário: Exibição de lista de produtos: Folha de dadosNome do filtro: where Condição: [SupplierID] = [Formulários]! [Fornecedores]! [SupplierID] Modo de dados: Somente leituraModo de janela:normal

Abra o formulário Lista de Produtos e mostre os produtos do fornecedor atual.

MoveAndSizeWindow

Direita: 0,7799" 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 CEP não estiver no formato correto para o país/região, a macro exibirá uma caixa de mensagem e cancelará o salvamento do registro. Em seguida, ele retorna ao controle CEP, no qual 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])

StopMacro

Se CountryRegion for Null, o CEP não poderá ser validado.

[PaísRegião] In ("France","Italy","Spain") And Len([PostalCode]) <> 5

CaixaDeMensagem

Mensagem: O código postal deve ter 5 caracteres. Bipe: SimTipo: InformationTitle: Erro de CEP

Se o código postal não tiver 5 caracteres, exiba uma mensagem.

...

CancelEvent

Cancele o evento.

GoToControl

Nome do controle: PostalCode

[PaísRegião] In ("Australia","Singapore") And Len([PostalCode]) <> 4

CaixaDeMensagem

Mensagem: O código postal deve ter 4 caracteres. Bipe: SimTipo: InformationTitle: Erro de CEP

Se o código postal não tiver 4 caracteres, exiba uma mensagem.

...

CancelEvent

Cancele o evento.

GoToControl

Nome do controle: PostalCode

([PaísRegião] = "Canadá") e ([PostalCode] not like"[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 Bipe: SimTipo: InformationTitle: Erro de CEP

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.