SET MENU ITEM ICON

Home

4D v20 R7

SET MENU ITEM ICON


SET MENU ITEM ICON ( Menü ; MenüEintrag ; IconRef {; 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
IconRef	Text, Lange Ganzzahl	Name oder Nummer des Bildes, das dem Menüeintrag zugewiesen werden soll
Prozessnr	Lange Ganzzahl	Prozessnummer

Beschreibung

Der Befehl SET MENU ITEM ICON ändert das dem Menüeintrag zugewiesene Icon, definiert durch die Parameter Menü und MenüEintrag.
Sie können in MenüEintrag -1 übergeben, um den zuletzt im Menü hinzugefügten Eintrag zu definieren.
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 Prozesse. Der Parameter Prozessnr wird dann ignoriert, falls er übergeben wurde.

Ü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.

In IconRef übergeben Sie das Bild, das als Icon dienen soll. Sie können ein Bild aus der Bildbibliothek (nur binäre Struktur) oder eine Bildreferenz verwenden.

Referenz auf Bilddatei. Es gibt zwei Syntaxarten:
- path:<filesystem> (empfohlen), z.B. "path:/RESOURCES/icon.png". Weitere Informationen dazu finden Sie im Abschnitt Filesystem Pfadnamen.
- file:<relativePathname> (überholt), z.B. "file:icon.png". Das Bild muss im Ordner Resources der Datenbank liegen.
Bild der Bildbibliothek (nur binäre Struktur): Sie können entweder Name oder Nummer des Bildes zurückgeben. Es ist in der Regel vorteilhafter, die Nummer zu verwenden, da Bildnummern im Gegensatz zu Bildnamen einmalig sind.

Hinweis: Wir empfehlen den Pfad zur Bilddatei, da die Bildbibliothek überholt ist und in einer Struktur im Projektmodus nicht unterstützt wird. Außerdem ist die Syntax file:<relativePathname> überholt. Wir empfehlen die Syntax path:<filesystem>.

Beispiel

Ein Bild aus dem Ordner Resources der Datenbank verwenden:

SET MENU ITEM ICON($MenuRef;2;"Path:/RESOURCES/english.lproj/spot.png")

Siehe auch

GET MENU ITEM ICON