Ação de macro DefinirVariávelTemporária

Mostrar tudo
Ocultar tudo
É possível usar a ação DefinirVariávelTemporária para criar uma variável temporária e defin
para um valor específico. A variável pode ser usada como uma condição ou um argumento na
s ações subseqüentes, ou você pode usá-la em outra macro, em um procedimento de evento ou
em um formulário ou relatório.
Configuração
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 Digite uma expressão a ser usada para definir o valor para essa variável tem
porária. Não coloque um sinal de igual (=) antes da expressão. É possível clicar no botão C
iar para usar o Construtor de expressões e definir esse argumento.
Comentários
É possível definir até 255 variáveis temporárias simultaneamente. Se você não remover uma v
el temporária, ela permanecerá na memória até que você feche o banco de dados. Trata-se de
uma prática recomendada remover as variáveis temporárias quando acabar de usá-las. Para
remover uma única variável temporária, use a ação RemoverVariávelTemporária e defina seu a
mento como o nome da variável temporária a ser removida. Se houver mais de uma variáve
l temporária e você quiser remover todas elas de uma só vez, use a ação RemoverTodasVariáve
sTemporárias.
As variáveis temporárias são globais. Depois que uma variável temporária é criada, você pod
onsultá-la em um procedimento de evento (procedimento do evento: um procedimento e
xecutado automaticamente em resposta de um evento iniciado pelo usuário ou pelo códi
go de programa, ou acionado pelo sistema.), um módulo VBA (Visual Basic for Applic
ations) (Visual Basic for Applications (VBA):uma versão de linguagem macro do Micr
osoft Visual Basic usada para programar aplicativos do Microsoft Windows e incluíd
a em vários programas da Microsoft.), uma consulta ou expressão. Por exemplo, se você
criou uma variável temporária chamada MyVar, ela pode ser usada como a origem do con
trole para uma caixa de texto, usando a seguinte sintaxe:
=[TempVars]![MyVar] Observação Em macros, consultas e procedimentos de evento, vo
cê não precisa colocar um sinal de igual antes da expressão.
Também é possível consultar variáveis temporárias em bancos de dados suplementares ou refe
renciados.
Para executar a ação DefinirVariávelTemporária em um módulo VBA, use o método Add do objeto
TempVars.
Exemplo
A macro a seguir mostra como criar uma variável temporária usando a ação DefinirVariávelTe
mporária, como usá-la em uma condição e em uma caixa de mensagem e como remover essa var
iável temporária.
Condição Ação Argumentos
DefinirVariávelTemporária Nome: MyVar
Expressão: InputBox("Insira um número diferente de zero.")
[TempVars]![MyVar]<>0 CaixaDeMensagem Mensagem:="Você digitou " & TempVars("MyVar"
) & ".", Sim, Nenhum
Alarme sonoro: Sim
Tipo: Informação
RemoverVariávelTemporária Nome: MyVar