SetReturnVar-Makroaktion

Gilt für: Access 2013, Office 2013

Die SetReturnVar-Aktion erstellt eine Rückgabevariable und legt sie auf einen bestimmten Wert fest.

Hinweis

Die Aktion SetReturnVar ist nur in Datenmakros verfügbar.

Einstellung

Die SetReturnVar-Aktion weist die folgenden Argumente auf.

Argument	Erforderlich	Beschreibung
Name	Ja	Eine Zeichenfolge, die den Namen der Variablen angibt.
Expression	Ja	Ein Ausdruck, mit dem der Wert für diese temporäre Variable festgelegt wird. Stellen Sie dem Ausdruck kein Gleichheitszeichen (=) voran. Sie können auf die Schaltfläche Erstellen klicken, um das Argument mithilfe des Ausdrucks-Generators festzulegen.

Bemerkungen

Die SetReturnVar-Aktion wird verwendet, um eine ReturnVar-Variable zu erstellen, die von Makros verwendet werden kann, die mithilfe der RunDataMacro-Aktion ein Datenmakro aufrufen.

Nachdem ein ReturnVar-Element durch die SetReturnVar-Aktion erstellt wurde, kann es vom aufrufenden Makro in einem Ausdruck verwendet werden. Wenn Sie beispielsweise ein ReturnVar-Objekt mit dem Namen UpdateSuccess erstellt haben, können Sie die Variable mit der folgenden Syntax verwenden:

    =[ReturnVars]![UpdateSuccess]

Die SetReturnVar-Aktion kann nur in benannten Datenmakros verwendet werden. Sie ist in Datenmakros, die an ein Datenmakroereignis angefügt sind, nicht verfügbar.

Beispiel

Im folgenden Beispiel wird gezeigt, wie die SetReturnVar-Aktion verwendet wird, um einen Wert aus einem benannten Datenmakro zurückzugeben. Ein ReturnVar mit dem Namen CurrentServiceRequest wird an die Makro- oder Visual Basic for Applications-Unterroutine (VBA) zurückgegeben, die das benannte Datenmakro aufgerufen hat.

Der Beispielcode stammt von:Microsoft Access 2010 Programmer's Reference.

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