SET MENU ITEM SHORTCUT

4D v18


SET MENU ITEM SHORTCUT ( menu ; menuItem ; itemKey ; modificadores {; processo} )

Parâmetro	Tipo	Descrição
menu	Inteiro longo, MenuRef	Número de menu ou menu de referência
menuItem	Inteiro longo	Número de item de menu ou -1 para o último item adicionado
itemKey	String, Inteiro longo	Letra de atalho do teclado ou código do Caractere do atalho de teclado (sintaxe antiga)
modificadores	Inteiro longo	Modificador(es) para associar com atalho (ignorado se código de tecla for passado)
processo	Inteiro longo	Número de referência de processo

Descrição

O comando SET MENU ITEM SHORTCUT modifica o atalho Ctrl (Windows) ou comando (Macintosh) para o comando de menu cujos números de menu e de elemento são passados em menu e menuItem, pelo caracter cujo caractere de código ou texto se passa em itemKey. Pode passar -1 em menuItem para indicar o último elemento adicionado ao menu. Esta tecla se combinará automaticamente com a tecla Ctrl (Windows) ou Comando (Macintosh) para definir o novo atalho de teclado.

Pode passar diretamente o nome da tecla como texto (uma letra) no parâmetro itemKey, por exemplo "U" para especificar o atalho Ctrl+U (Windows) ou Comando+U (Mac OS). Quando utilize esta sintaxe, também pode passar o parâmetro opcional modificadores para associar os modificadores adicionais ao atalho. Desta forma pode definir os atalhos de tipo Ctrl+Alt+Shift+Z (Windows) ou Cmd+Opção+Shift+Z (Mac OS).

Para fazer isto, passe em modificadores os seguintes valores:

256 para a tecla Comando (Mac OS) ou Ctrl (Windows)
512 para a tecla Shift
2048 para a tecla Opção (Mac OS) ou Alt (Windows)
Para associar ambas teclas, combine seus valores.

Nota: pode definir o valor a passar utilizando as constantes Shift key mask e Option key mask do tema Eventos (Modificadores).

A tecla Ctrl (Windows) e Comando (Mac OS) são adicionadas automaticamente por 4D ao atalho de teclado, sem importar se indicou explicitamente no parâmetro modifiers. De maneira que não necessita adicionar o valor 256 a este parâmetro, a menos que a tecla seja o único modificador, nesse caso deve passar o valor 256 ou a constante correspondente em modifiers.

Nota: por compatibilidade, o comando também aceita um código de caractere como parâmetro tecla (sintaxe anterior). Neste caso, o parâmetro modificadores não é considerado e pode ser omitido. O atalho só é associado a tecla Ctrl (Windows) ou Comando (Mac OS).

Se omitit o parâmetro processo, SET MENU ITEM SHORTCUT é aplicada à barra de menus do processo atual. Do contrário, SET MENU ITEM SHORTCUT é aplicado à barra de menus do processo atual cujo número de referência se passa em processo.

Nota: se passa um parâmetro MenuRef em menu, o parâmetro processo é inútil e será ignorado.

Se passa 0 (zero) em tecla, todo atalho é eliminado do elemento de menu.

Exemplo 1

Definição do atalho Ctrl+Shift+U (Windows) e Cmd+Shift+U (Mac OS) para a linha "Sublinhado":

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

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

Exemplo 2

Definição do atalho Ctrl+R (Windows) e Cmd+R (Mac OS) para o elemento de menu "Reiniciar":

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

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

Ver também

Get menu item key
Get menu item modifiers