SET MENU ITEM SHORTCUT

4D v20 R7


SET MENU ITEM SHORTCUT ( menu ; ligneMenu ; touche ; modificateurs {; process} )

Paramètre	Type	Description
menu	Entier long, RefMenu	Numéro du menu ou Référence de menu
ligneMenu	Entier long	Numéro de ligne de menu ou -1 pour la dernière ligne ajoutée
touche	Chaîne, Entier long	Lettre du raccourci clavier ou code de caractère du raccourci clavier (ancienne syntaxe)
modificateurs	Entier long	Modificateur(s) à associer au raccourci (ignoré si un code de touche est passé)
process	Entier long	Numéro de référence du process

Description

La commande SET MENU ITEM SHORTCUT remplace la touche du raccourci clavier associé à la ligne de menu désignée par menu et ligneMenu, par le caractère dont vous avez passé le code de caractère ou le texte dans touche. Vous pouvez passer -1 dans ligneMenu afin de désigner la dernière ligne ajoutée au menu. La touche définie sera combinée à la touche Ctrl (Windows) ou Commande (Macintosh) pour définir le nouveau raccourci clavier.

Passez dans le paramètre touche la lettre désignant la touche de raccourci, par exemple “U” pour définir le raccourci Ctrl+U (Windows) ou Commande+U (Mac OS).

Le paramètre modificateurs vous permet d’associer un ou plusieurs modificateur(s) additionnel(s) au raccourci standard. Vous pouvez ainsi définir des raccourcis du type Ctrl+Alt+Maj+Z (Windows) ou Cmd+Option+Maj+Z (Mac OS). Vous pouvez passer dans modificateurs les valeurs suivantes :

256 pour la touche Commande (Mac OS) ou Ctrl (Windows)
512 pour la touche Majuscule
2048 pour la touche Option (Mac OS) ou Alt (Windows)
Pour associer plusieurs touches, cumulez leurs valeurs.

Note : Vous pouvez définir les valeurs à passer à l’aide des constantes Command key mask, Shift key mask et Option key mask du thème Evénements (Modifiers).

La touche Ctrl (Windows) ou Commande (Mac OS) est automatiquement ajoutée par 4D au raccourci clavier, que vous l'ayez explicitement indiquée ou non dans modificateurs. Il n'est donc pas nécessaire d'ajouter la valeur 256 à ce paramètre, sauf si cette touche est le seul modificateur, auquel cas vous devez passer la valeur 256 ou la constante correspondante dans modificateurs.

Note : Par compatibilité, la commande admet également un code de caractère comme paramètre touche (ancienne syntaxe). Dans ce cas, le paramètre modificateurs n’est pas pris en compte et il peut être omis. Le raccourci sera uniquement associé au modificateur Ctrl (Windows) ou Commande (Mac OS).

Si vous ne passez pas le paramètre process, SET MENU ITEM SHORTCUT est appliquée à la barre de menus du process courant. Sinon, SET MENU ITEM SHORTCUT est appliquée à la barre de menus du process dont la référence est passée dans process.

Note : Si vous passez un paramètre RefMenu dans menu, le paramètre process est inutile et sera ignoré.

Si vous passez 0 (zéro) dans touche, l'équivalent clavier de la commande de menu est supprimé.

Compatibilité

Pour des raisons de compatibilité, la commande accepte également un code de caractère dans le paramètre touche (ancienne syntaxe). Dans ce cas, le raccourci inclut automatiquement la touche Ctrl (Windows) ou Cmd (macOS) et le paramètre modificateurs n'est pas pris en compte.

Si vous passez 0 (zéro) dans touche, les raccourcis spnt supprimés de l'élément de menu.

Exemple 1

Définition du raccourci Ctrl+Maj+U (Windows) et Cmd+Maj+U (Mac OS) pour la ligne “Souligné” :

 SET MENU ITEM(menuRef;1;"Souligné")

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

Exemple 2

Définition du raccourci Ctrl+R (Windows) et Cmd+R (Mac OS) pour la ligne "Recommencer" :

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

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

Exemple 3

Définition du raccourci F4 pour l'élément de menu "Fermer" :

 INSERER ELEMENT MENU(FileMenu;-1;"Fermer")

 FIXER RACCOURCI ELEMENT MENU(FileMenu;-1;"[F4]";0)

Voir aussi

Get menu item key
Get menu item modifiers