4D Doc Center : Create menu

Home

4D v14.3

Create menu


Create menu {( Menü )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
Menü	MenüRef, Lange Ganzzahl, String	Menüreferenz oder Nummer oder Name des Menüs
Funktionsergebnis	MenüRef	Menüreferenz

Beschreibung

Die Funktion Create menu erstellt ein neues Menü im Speicher, das dann nur im Speicher existiert und nicht dem Menüeditor im Designmodus hinzugefügt wird. Alle während der Sitzung ausgeführten Änderungen in diesem Menü werden sofort auf alle anderen Instanzen dieses Menüs innerhalb aller Prozesse der Datenbank übertragen.

Die Funktion gibt die Referenznummer vom Typ MenüRef für das neue Menü zurück.

Übergeben Sie nicht den optionalen Parameter Menü, wird ein leeres Menü erstellt. Sie müssen es dann mit den Befehlen RELEASE MENU, SET MENU ITEM füllen und verwalten.
Übergeben Sie den optionalen Parameter Menü, ist das erstellte Menü die exakte Kopie des Quellmenüs, das durch diesen Parameter bestimmt wird. Alle Eigenschaften des Quellmenüs, inkl. zugewiesener Untermenüs, werden auf das neue Menü angewandt. Beachten Sie, dass eine neue Referenz MenüRef für das Quellmenü und für alle vorhandenen Untermenüs, die ihm zugewiesen sind, erstellt wird.

Im Parameter Menü können Sie entweder eine gültige Menüreferenz, oder Nummer bzw. Name einer Menüleiste übergeben, die im Designmodus definiert wurde. Dann wird das neue Menü aus den Menüs und Untermenüs der Quellmenüleiste zusammengestellt.
Ein mit dieser Funktion erstelltes Menü lässt sich über den Befehl SET MENU BAR als Menüleiste verwenden.

Benötigen Sie das mit Create menu erstellte Menü nicht mehr, denken Sie daran, den Befehl RELEASE MENU aufzurufen, um den verwendeten Speicher wieder frei zu machen.

Beispiel

Siehe Beispiel unter dem Befehl SET MENU BAR.