SetMenuItem-Makroaktion

Gilt für: Access 2013, Office 2013

Sie können die SetzenMenüelement-Aktion verwenden, um den Zustand des Menüelements (es kann aktiviert oder deaktiviert bzw. ausgewählt oder nicht ausgewählt sein) in benutzerdefinierten oder globalen Menüs auf der Registerkarte Add-Ins festzulegen.

Hinweis

Die SetMenuItem-Aktion funktioniert nur mit benutzerdefinierten und globalen Menüs, die mithilfe von Menümakros erstellt werden. Die SetMenuItem-Aktion ist nur aus Gründen der Kompatibilität mit früheren Versionen in Microsoft Access enthalten. Es funktioniert nicht mit der Befehlsleistenfunktion. Sie können jedoch die Eigenschaften Enabled und State in einem VBA-Modul (Visual Basic for Applications) verwenden, um Elemente in Kontextmenüs oder benutzerdefinierten oder globalen Menüs zu deaktivieren, zu aktivieren und auszuwählen oder die Auswahl aufzuheben.

Einstellung

Die SetzenMenüelement-Aktion verwendet folgende Argumente.

Aktionsargument	Beschreibung
Menüindex	Der Index des Menüs, das den Befehl enthält, für den Sie den Zustand festlegen möchten. Geben Sie für den Index des gewünschten Menüs im benutzerdefinierten oder globalen Menü einen ganzzahligen Wert ein, der bei 0 beginnt. Geben Sie im Bereich Makro-Generator im Abschnitt Aktionsargumente den Indexwert in das Feld Menüindex ein. Der Index ist relativ zur Position des Menüs im Menümakro für das benutzerdefinierte oder globale Menü (die Position der AddMenu-Aktion dieses Menüs im Menümakro, die von 0 gezählt wird). Die Anzeige des Menüs kann etwas anders sein, da Sie bedingte Ausdrücke im Menümakro verwenden können, um benutzerdefinierte Menüelemente auszublenden oder anzuzeigen. Dies ist ein erforderliches Argument. Wenn Sie ein Menü mit diesem Argument auswählen und die Argumente Befehlsindex und Unterbefehlsindex leer lassen, können Sie den Menünamen selbst aktivieren oder deaktivieren. Sie können jedoch keinen Menünamen auswählen oder die Auswahl aufheben (Access ignoriert die Einstellungen zum Aktivieren und Deaktivieren für das Argument Flag für Menünamen).
Befehlsindex	Der Index des Befehls, für den Sie den Zustand festlegen möchten. Geben Sie einen ganzzahligen Wert (beginnend mit 0) für den Index des gewünschten Befehls in das menü ein, das durch das Argument Menu Index ausgewählt wird. Der Index ist relativ zur Position des Befehls in der Makrogruppe, die das ausgewählte Menü für das benutzerdefinierte oder globale Menü definiert (die Position des Makros dieses Befehls in der Makrogruppe, die von 0 gezählt wird). Die Anzeige des Menüs kann etwas anders sein, da Sie bedingte Ausdrücke in der Makrogruppe des Menüs verwenden können, um benutzerdefinierte Menübefehle auszublenden oder anzuzeigen.
Unterbefehlsindex	Der Index des Unterbefehls, für den Sie den Zustand festlegen möchten. Dies gilt nur, wenn der gewünschte Befehl über ein Untermenü verfügt. Geben Sie einen ganzzahligen Wert ab 0 für den Index des gewünschten Unterbefehls in das vom Argument Command Index ausgewählte Untermenü ein. Der Index ist relativ zur Position des Unterbefehls in der Makrogruppe, die das ausgewählte Untermenü für das benutzerdefinierte oder globale Menü definiert (die Position des Makros dieses Unterbefehls in der Makrogruppe, ab 0 gezählt).
Wert	Der Zustand, den Sie für den Befehl oder Unterbefehl festlegen möchten. Klicken Sie auf Deaktiviert (um den Befehl zu deaktivieren – dieser wird dann abgeblendet angezeigt), Aktiviert (um den Befehl zu aktivieren), Mit Häkchen (um den Befehl mit einem Häkchen zu versehen – dies bedeutet in der Regel, dass der Befehl ausgewählt oder eingeschaltet wurde) oder Ohne Häkchen (um das Häkchen zu entfernen). Die Standardeinstellung lautet Aktiviert.

Hinweise

Die SetzenMenüelement-Aktion kann nur in Kombination mit einem benutzerdefinierten oder globalen Menü verwendet werden. Ist in dem aktiven Fenster kein entsprechendes Menü enthalten, wird durch die Ausführung eines Makros, in dem die SetzenMenüelement-Aktion enthalten ist, ein Laufzeitfehler verursacht.

Sie können diese Aktion verwenden, um den Zustand der Befehle und Unterbefehle in Menüs festzulegen. Die Aktion kann aber nicht für Unterbefehle von Unterbefehlen verwendet werden.

Um die SetzenMenüelement-Aktion in einem VBA-Modul (Visual Basic für Applikationen) auszuführen, müssen Sie die SetMenuItem-Methode des DoCmd-Objekts verwenden.