SET MENU ITEM SHORTCUT

4D v16.3


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 cambia el atajo Ctrl (Windows) o comando (Macintosh) para el comando de menú cuyos números de menú y de elemento se pasan en menu y menuItem, por el carácter cuyo carácter de código o texto se pasa en itemKey. Puede pasar -1 en menuItem para indicar el último elemento añadido al menú. Esta tecla se combinará automáticamente con la tecla Ctrl (Windows) o Comando (Macintosh) para definir el nuevo atajo de teclado.

Puede pasar directamente el nombre de la tecla como texto (una letra) en el parámetro itemKey, por ejemplo "U" para especificar el atajo Ctrl+U (Windows) o Comando+U (Mac OS). Cuando utilice esta sintaxis, también puede pasar el parámetro opcional modificadores para asociar los modificadores adicionales al atajo. De esta forma puede definir los atajos de tipo Ctrl+Alt+Mayús+Z (Windows) o Cmd+Opción+Mayús+Z (Mac OS).

Para hacer esto, pase en modificadores los siguientes valores:

256 para la tecla Comando (Mac OS) o Ctrl (Windows)
512 para la tecla Mayús
2048 para la tecla Opcion (Mac OS) o Alt (Windows)
Para asociar ambas teclas, combine sus valores.

Nota: puede definir el valor a pasar utilizando las constantes Shift key mask y Option key mask del tema " ".

La tecla Ctrl (Windows) y Comando (Mac OS) son añadidas automáticamente por 4D al atajo de teclado, sin importar si lo indicó explícitamente en el parámetro modifiers. De manera que no necesita añadir el valor 256 a este parámetro, a menos que la tecla sea el único modificador, en ese caso debe pasar el valor 256 o la constante correspondiente en modifiers.

Nota: por compatibilidad, el comando también acepta un código de carácter como parámetro tecla (sintaxis anterior). En este caso, el parámetro modificadores no se tiene en cuenta y puede omitirse. El atajo sólo se asocia a la tecla Ctrl (Windows) o Comando (Mac OS).

El parámetro modificadores no se tiene en cuenta si la tecla de modificación está definida vía su condigo de carácter (sintaxis anterior).

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

Nota: si pasa un parámetro MenuRef en menú, el parámetro proceso es inútil y se ignorará.

Si pasa 0 (cero) en tecla, todo atajo se elimina 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)

Ver también

Get menu item key
Get menu item modifiers