Office: SetzenWert-Makroaktion

SetzenWert-Makroaktion
Access für Microsoft 365 Access 2019 Access 2016 Access 2013 Access 2010 Access 2007 Mehr... Weniger Sie können die Makroaktion SetzenWert verwenden, um den Wert für ein Access-Feld, ein -Steuerelement oder eine -Eigenschaft auf einem Formular, ein -Datenblatt (Formular) oder einen -Bericht festzulegen.

Hinweis: Sie können mit der Makroaktion SetzenWert nicht den Wert für eine Access-Eigenschaft festlegen, die ein Objekt zurückgibt.

Hinweis: Diese Aktion ist nur bei vertrauenswürdigen Datenbanken zulässig.

Einstellung
Die SetzenWert-Makroaktion weist die folgenden Argumente auf:

Aktionsargument	Beschreibung
Artikel	Der Name des Felds, des Steuerelements oder der Eigenschaft, dessen/deren Wert Sie festlegen möchten. Geben Sie den Namen des Felds, des Steuerelements oder der Eigenschaft in das Feld Element im Abschnitt Aktionsargumente des Makroentwurfsfensters ein. Sie müssen für den Verweis auf dieses Element die vollständige Syntax verwenden, z. B. Steuerelementname (für ein Steuerelement auf einem Formular oder in einem Bericht, über das das Makro aufgerufen wurde) oder Formulare!Formularname!Steuerelementname. Dieses Argument ist erforderlich.
Ausdruck	Der Ausdruck, der von Access verwendet wird, um den Wert für dieses Element festzulegen. Sie müssen immer die vollständige Syntax verwenden, um auf eines der Objekte im Ausdruck zu verweisen. Verwenden Sie z. B. Forms!Employees!Salary*1.1, um den Wert im Steuerelement für "Gehalt" um 10 Prozent zu erhöhen, das sich auf einem Mitarbeiterformular befindet. Dieses Argument ist erforderlich. Hinweis: Verwenden Sie vor dem Ausdruck in diesem Argument kein Gleichheitszeichen (=). Access wertet ansonsten den Ausdruck aus und verwendet diesen Wert als Ausdruck in diesem Argument. Dies kann zu unerwarteten Ergebnissen führen, wenn der Ausdruck eine Zeichenfolge ist. Wenn Sie z. B. ="Zeichenfolge1" für dieses Argument eingeben, wertet Access zuerst den Ausdruck als "Zeichenfolge1" aus. Dann wird "Zeichenfolge1" als Ausdruck in diesem Argument verwendet, wobei erwartet wird, dass ein Steuerelement oder eine Eigenschaft namens "Zeichenfolge1" auf dem Formular oder im Bericht gefunden wird, über das/den das Makro aufgerufen wurde.

Hinweis: Klicken Sie in einer Access-Datenbank (MDB oder ACCDB) auf die Schaltfläche Erstellen, um den Ausdrucks-Generator zum Erstellen eines Ausdrucks für eines dieser Argumente zu verwenden.

Hinweise
Sie können mithilfe dieser Aktion einen Wert für ein Feld oder Steuerelement auf einem Formular, einem Formulardatenblatt oder in einem Bericht festlegen. Sie können auch den Wert für fast alle Steuerelement-, Formular- und Berichtseigenschaften in einer beliebigen Ansicht festlegen. Wenn Sie erfahren möchten, ob eine bestimmte Eigenschaft mithilfe eines Makros festgelegt werden kann und in welchen Ansichten dies möglich ist, finden Sie weitere Informationen im Hilfethema zu dieser Eigenschaft im Visual Basic-Editor.

Sie können auch den Wert für ein Feld in der Tabelle festlegen, die einem Formular zugrunde liegt, auch wenn das Formular kein Steuerelement enthält, das mit dem Feld verbunden ist. Verwenden Sie die Syntax Formulare!Formularname!Feldname im Feld Element, um den Wert für ein derartiges Feld festzulegen. Sie können auch auf ein Feld in der Tabelle verweisen, die einem Bericht zugrunde liegt, indem Sie die Syntax Berichte!Berichtsname!Feldname verwenden, aber der Bericht muss ein Steuerelement enthalten, das mit diesem Feld verbunden ist, oder auf das Feld muss in einem Berechnetes Steuerelement des Berichts verwiesen werden.

Wenn Sie den Wert eines Steuerelements auf einem Formular festlegen, löst die SetzenWert-Makroaktion nicht die Gültigkeitsprüfungsregeln des Steuerelements auf Formularebene aus, aber es löst die Gültigkeitsprüfungsregeln des zugrunde liegenden Felds auf Tabellenebene aus, wenn das Steuerelement ein gebundenes Steuerelement ist. Die SetzenWert-Makroaktion löst auch eine Neuberechnung aus, aber diese Neuberechnung erfolgt möglicherweise nicht sofort. Verwenden Sie die AktualisierenObjekt-Makroaktion, um die sofortige Aktualisierung auszulösen und den Abschluss der Neuberechnung zu erzwingen. Der Wert, den Sie in einem Steuerelement mithilfe der SetzenWert-Makroaktion festlegen, ist auch nicht von einem Eingabeformat betroffen, das Sie in der Eigenschaft Eingabeformat des Steuerelements oder des zugrunde liegenden Felds festlegen.

Wenn Sie den Wert eines Steuerelements ändern möchten, können Sie die SetzenWert-Aktion in einem Makro verwenden, das von der NachAktualisierung-Ereigniseigenschaft des Steuerelements angegeben wird. Sie können die SetzenWert-Aktion jedoch nicht in einem Makro verwenden, das von der VorAktualisierung-Ereigniseigenschaft eines Steuerelements angegeben wurde, um den Wert des Steuerelements zu ändern (obwohl Sie mit der SetzenWert-Aktion den Wert anderer Steuerelemente ändern können). Sie können auch die SetzenWert-Aktion in einem Makro verwenden, das von der Eigenschaft VorAktualisierung oder NachAktualisierung eines Formulars angegeben wurde, um den Wert beliebiger Steuerelemente im aktuellen Datensatz zu ändern.

Hinweis: Mithilfe der SetzenWert-Makroaktion können Sie nicht den Wert der folgenden Steuerelemente festlegen:

• Gebundene und berechnete Steuerelemente in Berichten
  
• Berechnete Steuerelemente in Formularen
  

Tipps

Mithilfe der SetzenWert-Makroaktion können Sie ein Formular in der Formularansicht aus- oder einblenden. Geben Sie Formulare!Formularname.Sichtbar in das Feld Element und Nein oder Ja in das Feld Ausdruck ein. Wenn Sie für die Sichtbar-Eigenschaft eines Formulars (Modal) "Nein" festlegen, wird das Formular ausgeblendet und zu einem Formular ohne Modus. Wenn Sie für die Eigenschaft "Ja" festlegen, wird das Formular angezeigt und wieder zu einem modalen Formular.

Wenn Sie den Wert eines Steuerelements ändern oder neue Daten zu einem Steuerelement hinzufügen, indem Sie die SetzenWert-Aktion in einem Makro verwenden, werden keine Ereignisse wie VorAktualisierung, VorEingabe oder Ändern ausgelöst, die beim Ändern oder Eingeben von Daten in diesen Steuerelementen der Benutzeroberfläche auftreten. Diese Ereignisse treten auch nicht auf, wenn Sie den Wert des Steuerelements mithilfe eines VBA-Moduls (Visual Basic for Applications) festlegen.

Diese Aktion ist in einem VBA-Modul nicht verfügbar. Legen Sie den Wert direkt in VBA fest.

Beispiel
Festlegen des Werts eines Steuerelements mithilfe eines Makros
Mit dem folgenden Makro wird das Formular "Artikel hinzufügen" über eine Schaltfläche im Formular "Lieferanten" geöffnet. Es zeigt die Verwendung der Echo-, Schließen-, ÖffnenFormular-, SetzenWert- und GeheZuSteuerelement-Makroaktionen. Mit der SetzenWert-Aktion wird das Steuerelement "Lieferanten-Nr." im Formular "Artikel" auf den aktuellen Lieferanten im Formular "Lieferanten" festgelegt. Mit der GeheZuSteuerelement-Aktion wird dann der Fokus auf das Feld "Kategorie-ID" verschoben, in dem Sie mit der Dateneingabe für den neuen Artikel beginnen können. Dieses Makro sollte an die Schaltfläche "Artikel hinzufügen" des Formulars "Lieferanten" angefügt werden.

Aktion	Argumente: Einstellung	Kommentar
Echo	Echo: Nein	Hält die Bildschirmaktualisierung während der Ausführung des Makros an.
Schließen	Objekttyp: Formular Objektname: Artikelliste Speichern: Nein	Schließt das Formular "Artikelliste".
ÖffnenFormular	Formularname: Artikel Ansicht: Formular Datenmodus: Hinzufügen Fenstermodus: Normal	Öffnet das Formular "Artikel".
SetzenWert	Element: [Formulare]![Artikel]![LieferantenNr] Ausdruck: LieferantenNr	Legt das Steuerelement "LieferantenNr" auf den aktuellen Lieferanten im Formular "Lieferanten" fest.
GeheZuSteuerelement	Steuerelementname: KategorieID	Ruft das Steuerelement "KategorieID" auf.

:)