Ação da macro DefinirVardeRetorno

Aplica-se ao: Access 2013, Office 2013

A ação SetReturnVar cria uma variável de retorno e a define como um valor específico.

Observação

A ação SetReturnVar está disponível somente em Macros de Dados.

Configuração

A ação SetReturnVar tem os seguintes argumentos.

Argumento

Obrigatório

Descrição

Nome

Sim

Uma cadeia de caracteres que especifica o nome da variável.

Expression

Sim

Uma expressão que 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 Build para usar o Construtor de Expressões para definir esse argumento.

Comentários

A ação SetReturnVar é usada para criar uma ReturnVar, que é uma variável que pode ser usada por macros que chamam uma macro de dados usando a ação RunDataMacro .

Depois que um ReturnVar é criado pela ação SetReturnVar , a macro de chamada pode usá-lo em uma expressão. Por exemplo, se você criou uma ReturnVar chamada UpdateSuccess, pode usar a variável usando a seguinte sintaxe:

    =[ReturnVars]![UpdateSuccess]

A ação SetReturnVar pode ser usada somente em macros de dados nomeadas. Ele não está disponível em macros de dados anexadas a um evento de macro de dados.

Exemplo

O exemplo a seguir mostra como usar a ação SetReturnVar para retornar um valor de uma macro de dados nomeada. Um ReturnVar chamado CurrentServiceRequest é retornado para a macro ou sub-rotina do Visual Basic for Applications (VBA) que chamou a macro de dados nomeada.

Código de exemplo fornecido por: a Referência do programador do Microsoft Access 2010.

    RunDataMacro
        Macro Name tblServiceRequests.dmGetCurrentServiceRequest
    
    Parameters
        prmAssignedTo =[ID]
    
    SetProperty
        Control Name txtCurrentSR
        Property Value
        Value =[ReturnVars]![CurrentServiceRequest]
  • Last updated on