Você pode usar a ação macro SetValue para definir o valor de um campo de acesso , 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 macro SetValue para definir o valor de uma propriedade Access que retorna um objeto.
Observação: Essa ação não será permitida se o banco de dados não for confiável.
Configuração
A ação de macro SetValue 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 campo, o controle ou o nome da propriedade na caixa Item na seção Argumentos de Ação da janela de design de macro. Você deve usar a sintaxe completa para se referir a esse item, como nome de controle (para um controle no formulário ou relatório do qual o macro foi chamado) ou Forms! formname! nome de controle. Esse é 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 salarial em um formulário de funcionários em 10%, use Forms!Employees!Salary*1.1. Esse é um argumento obrigatório. Observação: Você não deve usar um sinal igual (=) antes da expressão neste argumento. Se você fizer isso, o Access avaliará a expressão e, em seguida, usará 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 ="String1" para esse argumento, o Access primeiro avaliará a expressão como String1. Em seguida, ele usa String1 como a expressão neste argumento, esperando encontrar um controle ou propriedade chamada String1 no formulário ou relatório que chamou a macro. |
Observação: Em um banco de dados access (.mdb ou .accdb), clique no botão Compilar para usar o Construtor de Expressões para criar uma expressão para qualquer um desses argumentos.
Comentários
Você pode usar essa ação para definir um valor para um campo ou controle em um formulário, uma folha de dados de formulário ou um relatório. Você também pode definir o valor para quase todas as propriedades de controle, formulário e relatório em qualquer exibição. Para descobrir se uma determinada propriedade pode ser definida usando uma macro e em quais exibições ela pode ser definida, consulte o tópico Ajuda para essa propriedade no Editor do Visual Basic.
Você também pode definir o valor de um campo na tabela subjacente de um formulário, mesmo que o formulário não contenha um controle vinculado ao campo. Use os Formulários de sintaxe! formname! fieldname na caixa Item para definir o valor para esse campo. Você também pode se referir a um campo na tabela subjacente de um relatório usando os Relatórios de sintaxe! nome do relatório! fieldname, mas deve haver um controle no relatório associado a esse campo ou o campo deve ser referido em um controle calculado no relatório.
Se você definir o valor de um controle em um formulário, a ação macro SetValue não disparará as regras de validação no nível do formulário do controle, mas disparará as regras de validação no nível da tabela do campo subjacente se o controle for um controle vinculado. A ação macro SetValue também dispara o recálculo, mas o recálculo pode não acontecer imediatamente. Para disparar a repintura imediata e forçar a conclusão do recálculo, use a ação macro RepaintObject . O valor definido em um controle usando a ação macro SetValue também não é afetado por um máscara de entrada definido na propriedade InputMask do campo de controle ou subjacente.
Para alterar o valor de um controle, você pode usar a ação SetValue em uma macro especificada pela propriedade de evento AfterUpdate do controle. No entanto, você não pode usar a ação SetValue 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 SetValue para alterar o valor de outros controles). Você também pode usar a ação SetValue 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 macro SetValue para definir o valor dos seguintes controles:
-
Controles vinculados e controles calculados em relatórios.
-
Controles calculados em formulários.
Dicas
Você pode usar a ação macro SetValue para ocultar ou mostrar um formulário no modo de exibição Formulário. Insira Forms!formname. Visível na caixa Item e Não ou Sim na caixa Expressão. Definir a propriedade Visible de um formulário janela restrita como Não oculta o formulário e o torna modelado. Definir a propriedade como Sim exibe o formulário e o torna modal novamente.
Alterar o valor de ou adicionar novos dados em um controle usando a ação SetValue em uma macro não dispara eventos como BeforeUpdate, BeforeInsert ou Change que ocorrem quando você altera ou insere dados nesses controles na interface do usuário. Esses eventos também não ocorrerão se você definir o valor do controle usando um módulo VBA (Visual Basic for Applications).
Essa ação não está disponível em um módulo 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. Ele mostra o uso das ações macro Echo, Close, OpenForm, SetValue e GoToControl . A ação SetValue define o controle SupplierID no formulário Produtos como o fornecedor atual no formulário Fornecedores. A ação GoToControl move o foco para o campo CategoryID, 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 |
Comentar |
|
Echo |
Echo On: Não |
Interromper a atualização de 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 Lista de Produtos. |
|
Abrirformulário |
Nome do Formulário: Produtos Exibição: Formulário Modo de Dados: Adicionar Modo de Janela: Normal |
Abra o formulário Produtos. |
|
Setvalue |
Item: [Forms]! [Produtos]! [SupplierID] Expressão: SupplierID |
Defina o controle SupplierID como o fornecedor atual no formulário Fornecedores. |
|
Irparacontrole |
Nome do controle: CategoryID |
Vá para o controle CategoryID. |
