4D Doc Center : Get menu item key

Home

4D v14.3

Get menu item key


Get menu item key ( Menü ; MenüZeile {; Prozessnr} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Menü	Lange Ganzzahl, MenüRef	Menünummer oder Menüreferenz
MenüZeile	Lange Ganzzahl	Nummer der Zeile oder -1 für zuletzt hinzugefügte Menüzeile
Prozessnr	Lange Ganzzahl	Referenznummer des Prozesses
Funktionsergebnis	Lange Ganzzahl	Code für Standard Tastenkürzel der Zeile

Beschreibung

Die Funktion Get menu item key gibt den Code für das Tastaturkürzel (ctrl-Taste unter Windows, Befehlstaste auf Macintosh) der in MenüZeile übergebenen Menüzeile aus der in Menü übergebenen Menünummer oder Menüreferenz zurück. Sie können in MenüZeile -1 übergeben, um die zuletzt im Menü hinzugefügte Zeile zu spezifizieren.

Prozessnr ist optional. Geben Sie den Parameter nicht an, gilt Get menu item key für die Menüleiste des aktuellen Prozesses. Sonst gilt der Befehl für den Prozess mit der in Prozessnr übergebenen Referenznummer.

Hinweis: Übergeben Sie in Menü den Parametertyp MenüRef, ist der Parameter Prozessnr nicht erforderlich und wird ignoriert.

Hat die Menüzeile kein zugewiesenes Tastenkürzel oder gibt der Parameter MenüZeile ein hierarchisches Untermenü an, gibt Get menu item key 0 (Null) zurück.

Beispiel

Um das einer Menüzeile zugeordnete Tastenkürzel zu erhalten, ist es hilfreich, nachfolgenden Programmcode zu integrieren:

 If(Get menu item key(mymenu;1)#0)

    $modifiers:=Get menu item modifiers(mymenu;1)

    Case of

       :($modifiers=Option key mask)

          ...

       :($modifiers=Shift key mask)

          ...

       :($modifiers=Option key mask+Shift key mask)

          ...

    End case

 End if