OBJECT GET SHORTCUT
OBJECT GET SHORTCUT ( {* ;} objeto ; tecla ; modificadores )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | Se especificado, objeto é um nome de objeto(cadeia)Se omitido, objeto é uma variável |
| objeto | any | → | Nome de objeto (se especificado *) ou Variável (se omitido *) |
| tecla | Text | ← | Tecla associada ao objeto |
| modificadores | Integer | ← | Máscara ou combinação de máscaras de teclas de modificação |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando OBJECT GET SHORTCUT devolve o atalho de teclado associado ao objeto ou aos objetos designados pelos parâmetros objeto e * no processo atual.
Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (uma cadeia). Se não passa este parâmetro, isto indica que o parâmetro objeto é uma variável. Neste caso, se passa uma referencia de variável em lugar de uma cadeia.
O parâmetro tecla devolve o caracter associado à tecla (no caso de uma tecla estandarte) ou uma cadeia entre colchetes que designa a tecla (no caso de uma tecla função). Pode comparar este valor com as constantes do tema Atalhos de teclado (ver o comando OBJECT SET SHORTCUT).
O parâmetro modificadores devolve um valor que indica a(s) tecla(s) modificadora(s) associada(s) ao atalho. Se existe varias teclas modificadoras combinadas, o comando devolve a suma de seus valores. Pode comparar o valor recebido com as seguintes constantes, do tema Eventos (Modificadores):
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| Command key mask | Inteiro longo | 256 | Windows = tecla Ctrl, Mac OS = tecla Comando |
| Control key mask | Inteiro longo | 4096 | Tecla Ctrl em OS X, ou clique direito em Windows e OS X |
| Option key mask | Inteiro longo | 2048 | Windows = tecla Alt, Mac OS = tecla Opção |
| Shift key mask | Inteiro longo | 512 | Windows e Mac Os |
Se nenhuma tecla de modificação foi definida para o atalho, modificadores devolve 0.
Nota: se o parâmetro objeto designa vários objetos do formulário que contém diferentes configurações, o comando devolve "" em tecla 0 em modificadores.