SET MENU ITEM SHORTCUT
SET MENU ITEM SHORTCUT ( menu ; menuItem ; itemKey ; modificadores {; processo} )
| 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 |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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).
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 (Mac OS) ou Ctrl (Windows)
- Shift key mask para a tecla Shift
- Option key mask para a tecla Opção (Mac OS) 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 (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)
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)