SET MENU ITEM PROPERTY

Home

4D v20 R7


SET MENU ITEM PROPERTY ( Menü ; MenüEintrag ; Eigenschaft ; Wert {; Prozessnr} )

Parameter	Typ	Beschreibung
Menü	Lange Ganzzahl, MenüRef	Menüreferenz oder Menünummer
MenüEintrag	Lange Ganzzahl	Nummer des Menüeintrags oder -1 für den zuletzt hinzugefügten Menüeintrag
Eigenschaft	String	Eigenschafttyp
Wert	Text, Zahl, Boolean	Eigenschafttyp
Prozessnr	Lange Ganzzahl	Prozessnummer

Beschreibung

Der Befehl SET MENU ITEM PROPERTY setzt den Wert der Eigenschaft für den Menüeintrag, definiert durch die Parameter Menü und MenüEintrag.

Sie können in MenüEintrag -1 übergeben, um den zuletzt im Menü hinzugefügten Eintrag anzugeben.

In Menü übergeben Sie eine Menüreferenz (MenüRef) oder eine Menünummer. Übergeben Sie eine Menüreferenz, gilt der Befehl für alle Menüinstanzen in allen Prozessen. Der Parameter Prozessnr ist dann nicht erforderlich und wird ignoriert, falls er übergeben ist.
Übergeben Sie eine Menünummer, berücksichtigt der Befehl das entsprechende Menü in der Hauptmenüleiste des aktuellen Prozesses. Wollen Sie einen anderen Prozess festlegen, übergeben Sie dessen Nummer im optionalen Parameter Prozessnr.

Im Parameter Eigenschaft übergeben Sie die Eigenschaft, deren Wert Sie ändern wollen, in Wert den neuen Wert.
Für Eigenschaft können Sie einen selbst erstellten Wert oder eine Standardeigenschaft (eine Konstante unter dem Thema Menüzeilen Eigenschaften) übergeben.

Standardeigenschaft: Die meisten Standardeigenschaften sind über Konstanten im "Menüzeilen Eigenschaften" Thema verfügbar.

Konstante	Typ	Wert	Kommentar
Access privileges	Zeichenkette	4D_access_group	Dem Befehl eine Zugriffsgruppe zuweisen 0 = Alle Gruppen >0 = Gruppennummer
Associated standard action	Zeichenkette	4D_standard_action	Einem Menüeintrag eine Standardaktion zuweisen Siehe Konstanten unter dem Thema Standardaktion.
n/a	Zeichenkette	4D_execute_without_validating	Aktivieren Sie die Option Ausführen ohne Überprüfung (für Menüeinträge, die mit Standardaktionen verknüpft sind). True=aktivieren, False (Standard)=deaktivieren
Start a new process	Zeichenkette	4D_start_new_process	Dem Befehl eine Zugriffsgruppe zuordnen 0 = Ohne Einschränkung >0 = Gruppennummer

Bei der Eigenschaft Associated Standard Action können Sie im Parameter Wert den Namen einer Standardaktion übergeben. Weitere Informationen dazu finden Sie im Abschnitt Standardaktionen des Handbuchs 4D Designmodus. Die gängigsten Aktionen sind auch als Konstanten unter dem Thema Standardaktion verfügbar.

Hinweis zur Kompatibilität: In bisherigen Releases wurden im Parameter Wert (Lange Ganzzahl) Konstanten aus dem Thema Zugewiesene Standardaktion verwendet. Diese sind ab 4D v16 R3 überholt, werden aber zur Wahrung der Kompatibilität noch unterstützt.

Hinweis: Entspricht der Menüeintrag dem Titel eines hierarchischen Untermenüs, wird die Standardaktion nicht aufgerufen, wenn das Menü ausgewählt wird.

Selbst erstellte Eigenschaft: In Eigenschaft können Sie auch einen eigenen Text übergeben und einen Wert vom Typ Text, Zahl oder Boolean zuweisen. Dieser Wert wird mit dem Eintrag gespeichert und lässt sich über den Befehl GET MENU ITEM PROPERTY ausfindig machen.
Im Parameter Eigenschaft können Sie eine beliebige Zeichenkette verwenden. Sie müssen lediglich sicherstellen, dass es kein von 4D verwendeter Titel ist. Laut Konvention beginnen von 4D gesetzte Eigenschaften mit “4D_“.

Siehe auch

Dynamic pop up menu
GET MENU ITEM PROPERTY