SET MENU ITEM SHORTCUT

4D v20 R7


SET MENU ITEM SHORTCUT ( menu ; lineamenu ; tecla ; modificadores {; proceso} )

Parámetro	Tipo	Descripción
menu	Entero largo, MenuRef	Referencia de menú o número de menú
lineamenu	Entero largo	Número de línea de menú o -1 para la última línea añadida al menú
tecla	Cadena, Entero largo	Código del carácter de atajo de teclado o letra del atajo de teclado
modificadores	Entero largo	Modificador(es) a asociar al atajo (se ignora si se pasa el código de tecla)
proceso	Entero largo	Número de referencia del proceso

Descripción

El comando SET MENU ITEM SHORTCUT asigna un nuevo acceso directo a un elemento del menú.

El elemento de menú se define a través de los parámetros menu y lineamenu. Puede pasar -1 en lineamenu para apuntar al último elemento añadido a menu.

En itemKey, pase una cadena que indique la tecla de acceso directo. El nuevo atajo incluirá automáticamente el modificador Ctrl (Windows) o Cmd (macOS) por defecto. Por ejemplo, si pasa "U" en itemKey el atajo será Ctrl + U (Windows) o Cmd + U (macOS).

Nota: puede designar una tecla F pasando "[Fx]" a itemKey, por ejemplo "[F4]". En este caso, no se añade ningún modificador por defecto.

En modificadores, puede pasar modificadores adicionales al atajo, como la tecla Mayús. De este modo, puede definir atajos como Ctrl+Alt+Mayús+Z (Windows) o Cmd+Opción+Mayús+Z (macOS). Pase 0 si no quiere añadir ningún modificador. Las siguientes constantes están disponibles:

Command key mask para la tecla Command (macOS) o Ctrl (Windows)
Shift key mask para la tecla Mayús
Option key mask para la tecla Opción (Mac OS) o Alt (Windows)

Para definir un acceso directo con varios modificadores, basta con combinar las constantes anteriores.

Si omite el parámetro proceso, SET MENU ITEM SHORTCUT se aplica a la barra de menús del proceso actual. En caso contrario, el comando se aplica a la barra de menús del proceso cuyo número de referencia se pasa en proceso.

Nota: si se pasa un MenuRef en menu, el parámetro proceso no sirve para nada y se ignora.

Compatibility

Por razones de compatibilidad, el comando también acepta un código carácter en el parámetro itemKey (sintaxis anterior). En este caso, el atajo incluye automáticamente la tecla Ctrl (Windows) o Cmd (macOS) y no se tiene en cuenta el parámetro modificadores.

Si se pasa 0 (cero) en itemKey, se elimina cualquier acceso directo del elemento de menú.

Ejemplo 1

Definición del atajo Ctrl+Mayús+U (Windows) y Cmd+Mayús+U (Mac OS) para la línea "Subrayado":

 SET MENU ITEM(MenuRef;1;"Subrayado")

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

Ejemplo 2

Definición del atajo Ctrl+R (Windows) y Cmd+R (Mac OS) para el elemento de menú "Reiniciar":

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

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

Ejemplo 3

Definición del atajo de teclado F4 para la opción de menú "Cerrar":

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

 SET MENU ITEM SHORTCUT(FileMenu;-1;"[F4]";0)

Ver también

Get menu item key
Get menu item modifiers