Compartilhar via


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 apenas em Macros de Dados.

Setting

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 um 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 for criado pela ação SetReturnVar , a macro de chamada poderá usá-la em uma expressão. Por exemplo, se você criou um ReturnVar chamado UpdateSuccess, poderá usar a variável usando a seguinte sintaxe:

    =[ReturnVars]![UpdateSuccess]

A ação SetReturnVar só pode ser usada em macros de dados nomeadas. Ela 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 à sub-rotina de macro ou 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]