Ação da macro DefinirVardeRetorno

Aplica-se ao: Access 2013, Office 2013

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

Observação

A ação SetReturnVar só está disponível 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 é utilizada para criar uma ReturnVar, que é uma variável que pode ser utilizada por macros que chamam uma macro de dados através da ação RunDataMacro .

Assim que uma ReturnVar for criada pela ação SetReturnVar , a macro de chamada pode utilizá-la numa expressão. Por exemplo, se tiver criado um ReturnVar com o nome UpdateSuccess, pode utilizar a variável com a seguinte sintaxe:

    =[ReturnVars]![UpdateSuccess]

A ação SetReturnVar só pode ser utilizada em macros de dados nomeadas. Não está disponível em macros de dados anexadas a um evento de macro de dados.

Exemplo

O exemplo seguinte mostra como utilizar a ação SetReturnVar para devolver um valor de uma macro de dados com nome. Uma ReturnVar com o nome CurrentServiceRequest é devolvida à macro ou à sub-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