Saltar al contenido principal
Versión: Siguiente

SET MENU ITEM SHORTCUT

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

ParámetroTipoDescripción
menuInteger, TextReferencia de menú o número de menú
lineamenuIntegerNúmero de línea de menú o -1 para la última línea añadida al menú
teclaText, IntegerCódigo del carácter de atajo de teclado o letra del atajo de teclado
modificadoresIntegerModificador(es) a asociar al atajo (se ignora si se pasa el código de tecla)
procesoIntegerNú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

Propiedades

Número de comando423
Hilo seguro
Prohibido en el servidor