SET MENU ITEM SHORTCUT

SET MENU ITEM SHORTCUT ( menu : Integer, Text ; menuItem : Integer ; itemKey : Text, Integer ; modificadores : Integer {; processo : Integer} )

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

Histórico

Versão	Alterações
11 SQL	Modificado
<6	Criado

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 (macOS). 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 (macOS).

Nota: Pode designar uma tecla F passando "[Fx]" ao itemChave, por exemplo "[F4]". Nesse caso, o padrão é nenhum modificador ser adicionado.

Em modificadores, pode passar modificadores adicionais ao atalho, tais como a tecla Shift. Dessa forma, pode definir atalhos como Ctrl+Alt+Shift+Z (Windows) ou Cmd+Option+Shift+Z (macOS). Passe 0 se não quiser adicionar modificadores. As constantes abaixo estão disponíveis

Para fazer isto, passe em modificadores os seguintes valores:

• Command key mask para a tecla Comando (macOS) ou Ctrl (Windows)
• Shift key mask para a tecla Shift
• Option key mask para a tecla Opção (macOS) ou Alt (Windows)

Para estabelecer um atalho para vários modificadores, apenas combine as constantes acima.

Se omitir o parâmetro processo, SET MENU ITEM SHORTCUT se aplica ao processo atual. Senão, o comando se aplica a barra de menu para o processo cujo número de referência for passado no processo.

Nota: Se passar um MenuRef em menu, o parâmetro de processo não serve nenhum propósito e é ignorado.

Compatibilidade

Por razões de compatibilidade, o comando também aceita o código de caractere no parâmetro itemKey (sintaxe antiga). Nesse caso, o atalho automaticamente inclui as teclas Ctrl (Windows) ou Cmd (macOS) e os parâmetros modificadores não é levado em consideração.

Se passar 0 (zero) em itemKey, qualquer atalho é removido do item menu.

Exemplo 1

Definição do atalho Ctrl+Shift+U (Windows) e Cmd+Shift+U (macOS) 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 (macOS) para o elemento de menu "Reiniciar":

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

Exemplo 3

Definição do atalho\shortcut para o item de menu "Close:

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

Ver também

Get menu item key
Get menu item modifiers

Propriedades

Número do comando	423
Thread-seguro	no
Proibido no servidor