4D v14.3

APPEND MENU ITEM

Home

 
4D v14.3
APPEND MENU ITEM

APPEND MENU ITEM 


 

APPEND MENU ITEM ( Menü ; ZeileText {; Untermenü {; Prozess {; *}}} ) 
Parameter Typ   Beschreibung
Menü  Lange Ganzzahl, MenüRef in Menünummer oder Menüreferenz
ZeileText  Text in Text für neuen Menüeintrag
Untermenü  MenüRef in Referenz des der Zeile zugeordneten Untermenüs
Prozess  Lange Ganzzahl in Referenznummer des Prozesses
Operator in Mit *: Metazeichen als Standardzeichen werten

Der Befehl APPEND MENU ITEM hängt neue Menüzeilen an das Menü an mit der Nummer oder Referenz, übergeben in Menü.

Prozess ist optional. Geben Sie den Parameter nicht an, gilt APPEND MENU ITEM für die Menüleiste des aktuellen Prozesses. Sonst gilt der Befehl für die Menüleiste für den Prozess mit der Referenznummer, übergeben in Prozess.

Hinweis: Übergeben Sie in Menü den Parameter MenüRef, hat der Parameter Prozess keine Verwendung und wird ignoriert.

Übergeben Sie nicht den Parameter *, ermöglicht APPEND MENU ITEM, eine oder mehrere Menüzeilen in einem Aufruf anzuhängen.

Sie können anzuhängende Einträge mit dem Parameter ZeileText wie folgt anhängen:

  • Trennen Sie die Zeilen mit einem Strichpunkt (;) voneinander. Zum Beispiel "Zeilentext1;Zeilentext2;Zeilentext3".
  • Deaktivieren Sie eine Zeile durch eine geöffnete Klammer (() im Zeilentext
  • Für eine Trennungslinie geben Sie "-" oder "(-" ein
  • Den Schriftstil für eine Zeile definieren Sie mit dem kleiner als Zeichen (<) und folgenden Buchstaben:
    <BFett
    <IKursiv
    <UUnterstrichen
  • Eine Markierung für eine Zeile fügen Sie mit dem Ausrufezeichen (!) und dem gewünschten Zeichen hinzu. Das Zeichen wird nur auf Macintosh berücksichtigt, unter Windows erscheint immer die Standardmarkierung.
  • Ein Icon fügen Sie mit dem Circumflex Zeichen (^) und dem Zeichen mit dem Code + 208 hinzu. Das ist die Ressourcen ID für das Icon auf Macintosh.
  • Ein Tastaturkürzel fügen Sie mit dem Schrägstrich (/) und dem gewünschten Kürzel hinzu.

Hinweis: Verwenden Sie überschaubare Menüs. Bei mehr als 50 Menüzeilen sollten Sie anstatt eines Menüs eine Listbox in einem Formular einsetzen.

Übergeben Sie den Parameter *, werden Sonderzeichen im Text, wie z.B. "( ; !...", für Einträge als standardmäßige Zeichen und nicht als Metazeichen behandelt, d.h. Sie können für Einträge Bezeichnungen wie "Kopieren (spezial)..." oder "Suchen/Ersetzen..." vergeben. Ist der Parameter * übergeben, können Sie in einem Aufruf nicht mehrere Einträge erstellen, da das Zeichen ";" als standardmäßiges Zeichen gewertet wird.

Hinweis: Die Routinen GET MENU ITEMS und Get menu item geben je nach Erstellung Metazeichen oder keine Metazeichen zurück: Wurden sie mit der Option * angelegt, werden die Metazeichen als Standardzeichen zurückgegeben.

Der optionale Parameter UnterMenü kann ein Menü als hinzugefügten Eintrag angeben und so ein hierarchisches Untermenü anhängen. Sie müssen eine Menüreferenz vom Typ String übergeben, die ein erstelltes Menü angibt (z.B. über die Funktion Create menu). Fügt der Befehl mehr als einen Menüeintrag hinzu, wird das Untermenü dem ersten Eintrag zugeordnet.

Wichtig: Den neuen Menüzeilen sind keine Methoden oder Aktionen zugeordnet. Diese müssen Sie den Menüzeilen über die Befehl SET MENU ITEM PROPERTY oder SET MENU ITEM METHOD zuordnen. Sie können die Zeilen auch über eine Formularmethode mit der Funktion Menu selected verwalten.

Dieses Beispiel hängt die Namen der verfügbaren Schriften im Schriftenmenü an. Hier ist es das sechste Menü der aktuellen Menüleiste:

  ` In der Datenbankmethode On Startup
  ` wird die Schriftenliste geladen und der Text für Menüzeilen aufgebaut
 FONT LIST(◊asAvailableFont)
 ◊atFontMenuItems:=""
 For($vlFont;1;Size of array(◊asAvailableFont))
    ◊atFontMenuItems:=◊atFontMenuItems+";"+◊asAvailableFont{$vlFont}
 End for

Sie können nun in jeder Formular- oder Projektmethode schreiben:

 APPEND MENU ITEM(6;◊atFontMenuItems)

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Menüs
Nummer: 411

Nicht für Server verwendbar

 
GESCHICHTE 

Geändert: 4D v11 SQL Release 4

 
SIEHE AUCH 

DELETE MENU ITEM
INSERT MENU ITEM
SET MENU ITEM PARAMETER

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)