4D v14.3

SET MENU ITEM SHORTCUT

Página Inicial

 
4D v14.3
SET MENU ITEM SHORTCUT

SET MENU ITEM SHORTCUT 


 

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

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.

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)

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)

 
PROPRIEDADES 

Produto: 4D
Tema: Menus
Número 423

Este comando não pode ser utilizado com 4D Server

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

Get menu item key
Get menu item modifiers

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)