4D Doc Center : SET MENU ITEM SHORTCUT

Home

4D v14.3

SET MENU ITEM SHORTCUT


SET MENU ITEM SHORTCUT ( Menü ; MenüZeile ; Tastenkürzel ; Zusatztasten {; Prozessnr} )

Parameter	Typ	Beschreibung
Menü	Lange Ganzzahl, MenüRef	Menünummer oder Menüeferenz
MenüZeile	Lange Ganzzahl	Nummer der Zeile oder -1 für zuletzt hinzugefügte Menüzeile
Tastenkürzel	String, Lange Ganzzahl	Buchstabe des Tastenkürzels oder ASCII-Code des Tastenkürzels (frühere Syntax)
Zusatztasten	Lange Ganzzahl	Dem Tastenkürzel zuzuordnende Zusatztasten (wird bei ASCII-Code ignoriert)
Prozessnr	Lange Ganzzahl	Referenznummer des Prozesses

Beschreibung

Der Befehl SET MENU ITEM SHORTCUT ersetzt das Tastaturkürzel für MenüZeile des Menüs Menü durch den Zeichencode oder Text übergeben in Tastenkürzel. Sie können in MenüZeile -1 übergeben, um die zuletzt im Menü hinzugefügte Zeile zu spezifizieren. Dieses Kürzel wird unter Windows mit der Strg-Taste, auf Mac OS mit der Befehlstaste kombiniert

Sie können den Buchstaben für das Kürzel direkt als String im Parameter Tastenkürzel übergeben, z.B. “U” für die Tastenkombination Strg+U unter Windows bzw. Befehl+U auf Mac OS. Mit dieser Syntax können Sie auch den optionalen Parameter Zusatztasten übergeben, um dem Tastenkürzel weitere Sondertasten zuzuweisen. So können Sie z.B. folgende Tastenkombinationen definieren: Strg+Alt+Shift+Z unter Windows bzw. Befehl+Wahl+Shift+Z auf Mac OS.
Dafür übergeben Sie in Zusatztasten folgende Werte:
- 256 für die Strg- bzw. die Befehlstaste
- 512 für die Shift-Taste
- 2048 für die Alt-Taste unter Windows bzw. Wahltaste auf Mac OS
- Um mehrere Tasten zuzuweisen, kombinieren Sie die einzelnen Werte.

Hinweis: Sie können die Werte auch über die Konstanten Command key mask, Shift key mask und Option key mask unter dem Thema Ereignisse (Zusatztasten) definieren.

4D weist die Strg-Taste unter Windows bzw. die Befehlstaste auf Mac OS automatisch den Tastenkürzeln zu, unabhängig, ob Sie diese explizit im Parameter Zusatztasten angeben. Sie müssen also in diesem Parameter nicht den Wert 256 hinzufügen, außer diese Taste ist die einzige Zusatztaste. In diesem Fall müssen Sie unter Zusatztasten entweder den Wert 256 oder die entsprechende Konstante übergeben.

Hinweis: Zur Wahrung der Kompatibilität erlaubt der Befehl im Parameter Tastenkürzel auch ASCII Code (frühere Syntax). In diesem Fall wird der Parameter Zusatztasten nicht berücksichtigt und kann weggelassen werden. Das Tastenkürzel wird nur der Strg-Taste unter Windows bzw. der Befehlstaste auf Mac OS zugewiesen.

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

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

Übergeben Sie 0 (Null) in Tastenkürzel, werden alle Tastenkürzel aus der Menüzeile entfernt.

Beispiel 1

Definition des Tastenkürzel Strg+Shift+U unter Windows, Befehl+Shift+U auf Mac OS für die Menüzeile “Unterstrichen”:

 SET MENU ITEM(menuRef;1;"Underline")

 SET MENU ITEM SHORTCUT(menuRef;1;"U";Shift key mask)

Beispiel 2

Definition des Tastenkürzel Strg+R (Windows) bzw. Befehl+R (Mac OS) für die Menüzeile "Restart" menu item:

 INSERT MENU ITEM(FileMenu;-1;"Restart")

 SET MENU ITEM SHORTCUT(FileMenu;-1;"R";Command key mask)