SetProperty-Makroaktion

Gilt für: Access 2013, Office 2013

Sie können die FestlegenEigenschaft -Aktion verwenden, um eine Eigenschaft für ein Steuerelement in einem Formular oder Bericht festzulegen.

Einstellung

Die FestlegenEigenschaft-Aktion verwendet die folgenden Argumente.

Aktionsargument	Beschreibung
Steuerelementname	Geben Sie den Namen des Felds oder Steuerelements ein, für das Sie den Eigenschaftswert festlegen möchten. Verwenden Sie lediglich den Namen des Steuerelements, nicht die vollständige Syntax. Lassen Sie das Argument leer, um die Eigenschaft für das aktuelle Formular oder den aktuellen Bericht festzulegen.
Eigenschaft	Wählen Sie die Eigenschaft aus, die Sie festlegen möchten. Der Abschnitt Hinweise in diesem Artikel enthält eine Auflistung der Eigenschaften, die mithilfe dieser Aktion festgelegt werden können.
Wert	Geben Sie den Wert ein, auf den die Eigenschaft festgelegt werden soll. Verwenden Sie für Eigenschaften, deren Werte entweder Ja oder Nein sind, -1 für Ja und 0 für Nein.

Hinweise

• Mithilfe der FestlegenEigenschaft-Aktion können Sie die folgenden Eigenschaften eines Steuerelements festlegen: Aktiviert, Sichtbar, Gesperrt, Links, Oben, Breite, Höhe, Textfarbe, Hintergrundfarbe oder Beschriftung.

• Wenn Sie einen ungültigen Wert für das Argument Value eingeben, tritt kein Fehler auf, aber Access kann die Eigenschaft in einen anderen Wert ändern, je nachdem, wie das Argument interpretiert wird.

• Sie können die SetProperty-Aktion in einem eigenständigen Makro nur verwenden, wenn Sie ihr eine Aktion voranstellen, die das Formular oder den Bericht auswählt, das das Steuerelement enthält, für das Sie die Eigenschaft festlegen. Wenn das Formular oder der Bericht nicht geöffnet ist, können Sie die Aktion ÖffnenFormular oder ÖffnenBericht verwenden, um es zu öffnen und auszuwählen. Wenn das Formular oder der Bericht bereits geöffnet ist, können Sie es mithilfe der SelectObject-Aktion auswählen. Anschließend können Sie die SetProperty-Aktion verwenden, um die -Eigenschaft festzulegen. Das Auswählen des Objekts ist nicht erforderlich, wenn Sie die SetProperty-Aktion in einem Makro verwenden, das in ein Steuerelement auf demselben Formular oder Bericht eingebettet ist wie das Steuerelement, für das Sie die Eigenschaft festlegen.

• Verwenden Sie die FestlegenEigenschaft -Methode des DoCmd -Objekts, um die FestlegenEigenschaft -Aktion in einem VBA-Modul auszuführen.

Beispiel

Im folgenden Beispiel wird gezeigt, wie die SetProperty-Aktion verwendet wird, um die Sichtbarkeit des Textfelds MyTextBox umzuschalten.

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

    Submacro: TestVisible
        SetProperty
            Control Name Text40
            Property Visible
            Value =Not[Text40].[Visible]
    End Submacro