EstablecerVariableDevuelta (acción de macro)

Se aplica a: Access 2013, Office 2013

La acción SetReturnVar crea una variable de retorno y la establece en un valor específico.

Nota:

La acción SetReturnVar solo está disponible en macros de datos.

Configuración

La acción SetReturnVar tiene los argumentos siguientes.

Argumento	Necesario	Descripción
Nombre	Sí	Una cadena que especifica el nombre de la variable.
Expression	Sí	Una expresión que se utilizará para establecer el valor de esta variable temporal. No anteponga el signo igual (=) a la expresión. Puede hacer clic en el botón Generar para utilizar el Generador de expresiones para establecer este argumento.

Comentarios

La acción SetReturnVar se usa para crear un Valor ReturnVar, que es una variable que pueden usar las macros que llaman a una macro de datos mediante la acción RunDataMacro .

Una vez que la acción SetReturnVar crea un valor ReturnVar, la macro que realiza la llamada puede usarla en una expresión. Por ejemplo, si creó un ReturnVar denominado UpdateSuccess, podría usar la variable mediante la sintaxis siguiente:

    =[ReturnVars]![UpdateSuccess]

La acción SetReturnVar solo se puede usar en macros de datos con nombre. No está disponible en las macros de datos asociadas a un evento de macro de datos.

Ejemplo

En el ejemplo siguiente se muestra cómo usar la acción SetReturnVar para devolver un valor de una macro de datos con nombre. Un Valor ReturnVar denominado CurrentServiceRequest se devuelve a la macro o a la subrutina de Visual Basic para Aplicaciones (VBA) que llamó a la macro de datos con nombre.

Código de ejemplo proporcionado por la Referencia del programador de Microsoft Access 2010.

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