Ação da macro DefinirVariávelTemporária

Aplica-se ao: Access 2013, Office 2013

Use a ação DefinirVariávelTemporária para criar uma variável temporária e defini-la com um valor específico. A variável poderá ser usada como condição ou argumento em ações subsequentes, ou em outra macro, em um procedimento de evento, ou ainda em um formulário ou relatório.

Setting

A ação DefinirVariávelTemporária tem os seguintes argumentos.

Argumento da ação	Descrição
Nome	Digite o nome da variável temporária.
Expressão.	Insira a expressão a ser usada para definir o valor dessa variável temporária. Não preceda a expressão com o sinal de igualdade (=). Você pode clicar no botão Criar para usar o Construtor de Expressões para definir esse argumento.

Comentários

• É possível definir até 255 variáveis temporárias de uma só vez. Se você não remover uma variável temporária, ela permanecerá na memória até você fechar o banco de dados. É recomendável remover variáveis temporárias após a conclusão do trabalho. Para remover uma única variável temporária, use a ação RemoverVariávelTemporária e defina o respectivo argumento com o nome da variável temporária a ser removida. Se for necessário remover mais de uma variável temporária e você quiser removê-las todas de uma só vez, use a ação RemoverTodasVariáveisTemporárias.

• Variáveis temporária são globais. Após a criação de uma variável temporária, você pode referenciá-la em um procedimento de evento, um módulo do VBA (Visual Basic for Applications), uma consulta ou em uma expressão. Por exemplo, se você criou uma variável temporária chamada MyVar, poderá usar a variável como fonte de controle para uma caixa de texto usando a seguinte sintaxe:

  =[TempVars]![MyVar]

  Observação

  [!OBSERVAçãO] Em macros, consultas e procedimentos de evento, não é preciso preceder a expressão com um sinal de igualdade.

  Também é possível referenciar variáveis temporárias em qualquer suplemento ou bancos de dados especificado.

• Para executar a ação DefinirVariávelTemporária em um módulo do VBA, use o método Add do objeto TempVars.

Exemplo

A macro a seguir demonstra como criar uma variável temporária usando a ação DefinirVariávelTemporária e, depois, utilizando-a em uma condição e em uma caixa de mensagem, e finalmente removendo-a.

Condition	Ação	Argumentos
	SetTempVar	Nome:Expressão MyVar: InputBox("Inserir um número não zero.")
[TempVars]! [MyVar]<>0	CaixaDeMensagem	Mensagem: ="Você inseriu " & [TempVars]! [MyVar] & "". Bip: YesType: Informações
	RemoveTempVar	Nome: MinhaVar