SET MENU ITEM SHORTCUT
SET MENU ITEM SHORTCUT ( menu ; ligneMenu ; touche ; modificateurs {; process} )
| Paramètre | Type | Description | |
|---|---|---|---|
| menu | Integer, Text | → | Numéro du menu ou Référence de menu |
| ligneMenu | Integer | → | Numéro de ligne de menu ou -1 pour la dernière ligne ajoutée |
| touche | Text, Integer | → | Lettre du raccourci clavier ou code de caractère du raccourci clavier (ancienne syntaxe) |
| modificateurs | Integer | → | Modificateur(s) à associer au raccourci (ignoré si un code de touche est passé) |
| process | Integer | → | Numéro de référence du process |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
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)