SetReturnVar, action de macro

S’applique à : Access 2013, Office 2013

L’action SetReturnVar crée une variable de retour et la définit sur une valeur spécifique.

Remarque

L’action SetReturnVar est disponible uniquement dans les macros de données.

Setting

L’action SetReturnVar contient les arguments suivants.

Argument	Obligatoire	Description
Nom	Oui	Chaîne qui spécifie le nom de la variable.
Expression	Oui	Expression destiné à être utilisé pour définir la valeur de cette variable temporaire. Ne faites pas précéder l’expression d’un signe égal (=). Vous pouvez cliquer sur le bouton Générer afin d’utiliser le Générateur d’expressions pour définir cet argument.

Remarques

L’action SetReturnVar est utilisée pour créer un objet ReturnVar, qui est une variable qui peut être utilisée par les macros qui appellent une macro de données à l’aide de l’action RunDataMacro.

Une fois qu’un objet ReturnVar est créé par l’action SetReturnVar , la macro appelante peut l’utiliser dans une expression. Par exemple, si vous avez créé un objet ReturnVar nommé UpdateSuccess, vous pouvez utiliser la variable à l’aide de la syntaxe suivante :

    =[ReturnVars]![UpdateSuccess]

L’action SetReturnVar ne peut être utilisée que dans les macros de données nommées. Il n’est pas disponible dans les macros de données attachées à un événement de macro de données.

Exemple

L’exemple suivant montre comment utiliser l’action SetReturnVar pour retourner une valeur à partir d’une macro de données nommée. Un objet ReturnVar nommé CurrentServiceRequest est retourné à la macro ou à la sous-routine Visual Basic pour Applications (VBA) qui a appelé la macro de données nommée.

Exemple de code fourni parMicrosoft Access 2010 Programmer’s Reference.

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