Ação de macro DefinirValor

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.

Você pode usar a ação de macro DefinirValor para definir o valor de uma campo Access, controle ou propriedade em um formulário, um formulário folha de dados ou um relatório.

Observação : Você não pode usar a ação de macro DefinirValor para definir o valor de uma propriedade de acesso que retorna um objeto.

Observação : Esta ação não poderão ser se o banco de dados não é confiável.

Configuração

A ação de macro DefinirValor tem os seguintes argumentos.

Argumento da ação

Descrição

Item

O nome do campo, controle ou propriedade cujo valor você deseja definir. Insira o nome de campo, controle ou propriedade na caixa Item na seção Argumentos da ação da janela de design de macro. Você deve usar a sintaxe completa para se referir a este item, como o nome do controle (para um controle no formulário ou relatório do qual a macro foi chamada) ou formulários ! nome do formulário! nome do controle. Este é um argumento obrigatório.

Expressão

O expressão Access usa para definir o valor para este item. Você sempre deve usar a sintaxe completa para se referir a quaisquer objetos na expressão. Por exemplo, para aumentar o valor em um controle salário em um formulário funcionários em 10 por cento, use Forms!Employees!Salary*1.1. Este é um argumento obrigatório.

Observação : Você não deve usar um sinal de igual (=) antes da expressão nesse argumento. Nesse caso, o Access avalia a expressão e usa esse valor como a expressão neste argumento. Isso pode produzir resultados inesperados se a expressão for uma cadeia de caracteres.

Por exemplo, se você digitar = "Cadeia1" para este argumento, o Access primeiro avalia a expressão como cadeia1. Em seguida, ele usa cadeia1 como a expressão neste argumento, esperando encontrar um controle ou propriedade chamada cadeia1 no formulário ou relatório que chamou a macro.

Observação : Um banco de dados (. mdb ou. accdb), clique no botão Construir para usar o construtor de expressões para criar uma expressão para um desses argumentos.

Comentários

Você pode usar esta ação para definir um valor para um campo ou controle em um formulário, uma folha de dados do formulário ou um relatório. Você também pode definir o valor para quase todas as propriedades de relatório, formulário e controle em qualquer modo de exibição. Para descobrir se uma determinada propriedade pode ser definida usando uma macro e quais modos de exibição pode ser definida, consulte o tópico da Ajuda para essa propriedade no Editor do Visual Basic.

Você também pode definir o valor de um campo na tabela de base de um formulário, mesmo se o formulário não contém um controle acoplado ao campo. Use a sintaxe Forms ! nome do formulário! fieldname na caixa Item para definir o valor desse campo. Você também pode se referir a um campo na tabela de base de um relatório usando a sintaxe relatórios ! NomeDoRelatório! fieldname, mas deve haver um controle no relatório acoplado a esse campo ou o campo precisa estar referido em um controle calculado no relatório.

Se você definir o valor de um controle em um formulário, a ação de macro DefinirValor não aciona as regras de validação de nível de formulário do controle, mas ela acionará as regras de validação de nível de tabela do campo subjacente se o controle é um controle acoplado. A ação de macro DefinirValor também aciona o recálculo, mas o recálculo pode não ocorrer imediatamente. Para disparar redesenho imediato e forçar a conclusão do recálculo, use a ação de macro RedesenharObjeto . O valor definido em um controle usando a ação de macro DefinirValor também não é afetado por um máscara de entrada definido no controle do propriedade ou campo base da máscara de entrada .

Para alterar o valor de um controle, você pode usar a ação DefinirValor em uma macro especificada pela propriedade de evento AfterUpdate do controle. No entanto, você não pode usar a ação DefinirValor em uma macro especificada pela propriedade de evento BeforeUpdate de um controle para alterar o valor do controle (embora você possa usar a ação DefinirValor para alterar o valor de outros controles). Você também pode usar a ação DefinirValor em uma macro especificada pela propriedade BeforeUpdate ou AfterUpdate de um formulário para alterar o valor de quaisquer controles no registro atual.

Observação : Você não pode usar a ação de macro DefinirValor para definir o valor dos seguintes controles:

  • Controles acoplados e controles calculados em relatórios.

  • Controles calculados em formulários.

Dicas

Você pode usar a ação de macro DefinirValor para ocultar ou mostrar um formulário no modo formulário. Insira formulários !nome do formulário. Visível na caixa Item e não ou Sim na caixa expressão. Definindo a propriedade Visible do formulário um janela restrita como não oculta o formulário e o torna sem restrição. Definindo a propriedade como Sim exibe o formulário e o torna restrito novamente.

Alterar o valor de ou adicionar novos dados em um controle usando a ação DefinirValor em uma macro não aciona eventos como BeforeUpdate, BeforeInsertou Change que ocorrem quando você altera ou insere dados nesses controles na interface do usuário. Esses eventos também não ocorrem se você definir o valor do controle usando um Visual Basic para módulo Applications (VBA).

Esta ação não está disponível em um módulo do VBA. Defina o valor diretamente no VBA.

Exemplo

Defina o valor de um controle usando uma macro

A macro a seguir abre o formulário Adicionar produtos de um botão no formulário fornecedores. Ela mostra o uso do eco, Fechar, AbrirFormulário, DefinirValore IrParaControle ações de macro. A ação DefinirValor define o controle CódigoDoFornecedor no formulário produtos como o fornecedor atual no formulário fornecedores. A ação IrParaControle então move o foco para o campo CódigoDaCategoria, onde você pode começar a inserir dados para o novo produto. Essa macro deve ser anexada ao botão Adicionar produtos no formulário fornecedores.

Ação

Argumentos: configuração

Comentário

Eco

Eco: não

Pare a atualização da tela enquanto a macro está em execução.

Fechar

Tipo de objeto: formulário

Nome do objeto: lista de produtos

Salvar: não

Feche o formulário de lista de produtos.

AbrirFormulário

Nome do formulário: produtos

Modo de exibição: formulário

Modo de dados: Adicionar

Modo janela: Normal

Abra o formulário de produtos.

DefinirValor

Item: [Forms]! [Produtos]! [CódigoDoFornecedor]

Expressão: CódigoDoFornecedor

Defina o controle CódigoDoFornecedor como o fornecedor atual no formulário fornecedores.

IrParaControle

Nome do controle: CategoryID

Vá para o controle CódigoDaCategoria.

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.

×